NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Opencage

opencage

OpenCage Geocoder provides a simple API for forward and reverse geocoding using open data sources.

Developer ToolsWeb del proveedor
Acciones
5
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (5)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Forward Geocode AddressOPENCAGE_GEOCODE_FORWARDAcción

Tool to convert a human-readable address into geographic coordinates. use when you need to retrieve latitude and longitude from an address.

Parámetros de entrada

  • qstringObligatorio

    The address or free-form query to geocode

  • abbrvinteger

    Return abbreviated results (0=false,1=true)

  • limitinteger

    Maximum number of results (1-100)

  • boundsstring

    Bias results to bounding box: west,south,east,north

  • prettyboolean

    Format the JSON response for readability

  • languagestring

    Preferred language for results (ISO 639-1 code)

  • proximitystring

    Bias results near a point: latitude,longitude

  • add_requestinteger

    Include original request in response (0=false,1=true)

  • countrycodestring

    Restrict to country codes (comma-separated ISO 3166-1 alpha-2)

  • min_confidenceinteger

    Minimum confidence score (1-10)

  • no_annotationsboolean

    Exclude supplementary information in results

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Geocode to GeoJSONOPENCAGE_GEOCODE_GEOJSONAcción

Tool to geocode and return geojson. use when you need geojson featurecollection.

Parámetros de entrada

  • qstringObligatorio

    Query string (address, placename, or 'lat,lng').

  • abbrvinteger

    Use abbreviated fields: 1 or 0.

  • limitinteger

    Maximum results to return (1-100).

  • boundsstring

    Restrict to bounding box: min_lon,min_lat,max_lon,max_lat.

  • prettyboolean

    Pretty-print the JSON response.

  • languagestring

    Preferred language (IETF code, e.g., 'en').

  • roadinfoboolean

    Include road information.

  • proximitystring

    Bias results near 'lat,lng'.

  • add_requestboolean

    Include original request in response.

  • countrycodestring

    Restrict to country (ISO 3166-1 alpha-2).

  • address_onlyboolean

    Return only address-type results.

  • min_confidenceinteger

    Minimum confidence level (0-10).

  • no_annotationsboolean

    Exclude detailed annotations (timezone, currency, etc.).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Geocode with JSONPOPENCAGE_GEOCODE_GEOJSONPAcción

Tool to perform geocoding and return results in geojsonp format. use when you need a javascript callback wrapped response.

Parámetros de entrada

  • qstringObligatorio

    The address or coordinates to geocode

  • abbrvinteger

    Whether to abbreviate results; 1 to shorten, 0 otherwise

  • jsonpinteger

    Force JSONP output; set to 1 to output JSONP

  • limitinteger

    Maximum number of results (default: 10; max: 100)

  • boundsstring

    Restrict the search region to a bounding box as 'minLon,minLat,maxLon,maxLat'

  • prettyinteger

    Pretty-print output; for debugging only

  • callbackstringObligatorio

    Name of the JavaScript callback function

  • languagestring

    Preferred language for results (ISO 639-1 code)

  • no_dedupeinteger

    Disable result deduplication; 1 to disable

  • no_recordinteger

    Do not log this request; 1 to disable logging

  • proximitystring

    Bias results to this location as 'lat,lon'

  • add_requestinteger

    Whether to include the request in the response; 1 to include

  • countrycodestring

    Limit results to this ISO 3166-1 alpha-2 country code

  • min_confidenceinteger

    Minimum confidence level to return (0-10)

  • no_annotationsinteger

    Exclude extra information; 1 to exclude

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Reverse Geocode CoordinatesOPENCAGE_GEOCODE_REVERSEAcción

Tool to convert coordinates to a human-readable address. use when you have latitude and longitude and need a readable location.

Parámetros de entrada

  • qstringObligatorio

    Latitude and longitude as a comma-separated string, e.g., '51.952659,7.632473'

  • abbrvinteger

    1 to abbreviate road and route types

  • limitinteger

    Maximum number of results to return (1-10)

  • prettyinteger

    1 for pretty-printed JSON, 0 (default) for compact output

  • languagestring

    Preferred response language as ISO 639-1 code, e.g., 'en'

  • roadinfointeger

    1 to include road information in the response

  • add_requestinteger

    1 to include request parameters in the response

  • countrycodestring

    Restrict results to one or more ISO 3166-1 alpha-2 country codes separated by commas

  • normalizecityinteger

    1 to normalize city names

  • min_confidenceinteger

    Minimum confidence level (0-10) to filter results

  • no_annotationsinteger

    1 to exclude annotations in the response

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Geocode XMLOPENCAGE_GEOCODE_XMLAcción

Tool to perform geocoding and return results in xml format. use when you need xml-formatted geocoding responses from opencage.

Parámetros de entrada

  • qstringObligatorio

    Location query for forward (text) or reverse ('lat,lng') geocoding

  • keystringObligatorio

    Your OpenCage API key

  • abbrvintegerenum

    1 for abbreviated components, 0 for full components

    01
  • limitinteger

    Maximum number of results to return (1–100)

  • prettyintegerenum

    1 for pretty-printed XML, 0 for compact output

    01
  • callbackstring

    JSONP callback function name (not used for XML responses)

  • languagestring

    Two-letter IETF language tag for results (e.g., 'en', 'de')

  • roadinfointegerenum

    1 to include road information near the location

    01
  • no_dedupeintegerenum

    1 to disable deduplication of results, 0 to dedupe

    01
  • add_requestintegerenum

    1 to include a copy of input parameters in the response

    01
  • countrycodeany

    Restrict results to this two-letter country code

  • min_confidenceinteger

    Only include results with this confidence or higher (1–10)

  • no_annotationsintegerenum

    1 to exclude annotations, 0 to include

    01

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not