API de geocodificación inversa precisa | Documentación y ejemplos

Introducción

Antes de empezar Cómo usar la API de geocodificación Cómo usar a través de Postman

Guía para desarrolladores de geocodificación inversa

Formato de solicitud Parámetros Respuestas Códigos de estado Mensajes de error Resultados Tipos de direcciones y tipos de componentes de direcciones

PREGUNTAS MÁS FRECUENTES

¿Qué puede hacer con la API de geocodificación?¿Por qué usar la API de geocodificación?

Antes de empezar

La geocodificación es el proceso de convertir una dirección en coordenadas de latitud y longitud mediante una API, mientras que la geocodificación inversa consiste en convertir las coordenadas geográficas (latitud y longitud) en una dirección legible por humanos mediante una API.

Así, por ejemplo, al convertir coordenadas geográficas como latitud 40.758678 y longitud 73.978798, mediante la API de geocodificación inversa, recibirá la dirección exacta «35 Rockefeller Plaza, Nueva York, NY 10111, EE. UU.».

DistanceMatrix.ai ofrece ambas soluciones: la API de geocodificación inversa para convertir la latitud y la longitud en direcciones y la API de geocodificación directa para convertir las direcciones del mapa en coordenadas geográficas.

Cómo usar la API de geocodificación inversa

Se puede acceder a este servicio a través de un HTTP interfaz. Para las solicitudes de geocodificación inversa, tendrá que enviar una consulta en forma de coordenadas (latitud y longitud). La siguiente lista detalla los parámetros obligatorios y opcionales para estas solicitudes.

Al realizar la consulta, recibirá una respuesta en forma de JSON documento que contiene los resultados más pertinentes. En la documentación que figura a continuación se proporcionan ejemplos de dichas solicitudes y sus correspondientes respuestas.

La seguridad es lo primero. Por eso se recomienda encarecidamente el uso de HTTPS, especialmente para las aplicaciones que traten datos confidenciales, como la ubicación del usuario. El cifrado HTTPS refuerza la seguridad de la aplicación y la hace más resistente a la vigilancia y la modificación.

Nuestra API de geocodificación inversa le brinda la flexibilidad de realizar solicitudes de la manera que mejor se adapte a sus necesidades. Las instrucciones detalladas anteriores lo guían sobre cómo realizar estas solicitudes con Postman, una herramienta de interacción de API versátil y fácil de usar.

Cómo usar la API de geocodificación a través de Postman

Nuestra API es un servicio HTTP versátil adecuado para varios casos de uso y escenarios de integración. Se puede usar de cualquier forma que se adapte a sus necesidades, incluidas las solicitudes directas del navegador, la codificación en diferentes lenguajes de programación o la integración con aplicaciones y sistemas.

Una de las maneras más fáciles y eficientes de empezar a interactuar e integrar nuestra API en sus proyectos es usar Cartero, conocida por su interfaz fácil de usar y sus potentes funciones.

He aquí cómo hacerlo:

Para empezar con Postman, instálalo en tu ordenador o accede a la versión web de un navegador.
Importe nuestra colección de API preconfigurada:
- Abre Postman.
- Haz clic en el botón «Importar» en la esquina superior izquierda.
- Selecciona «Importar desde enlace» y pega este enlace a la colección de Postman: https://www.postman.com/distancematrix/workspace/distance-matrix/overview
Tras la importación, Postman añadirá automáticamente la colección a tu espacio de trabajo.
Para los usuarios de la versión en línea de Postman, pueden abrir directamente el enlace de la colección y crear una bifurcación. Para ello, haga clic en los tres puntos situados junto al nombre de la colección.
Configure su entorno en Postman, vaya a la sección Variables y añada su token de autenticación en el campo «Token de autorización de API».
No olvides guardar estos cambios.
Haga su primera solicitud: seleccione un punto final de nuestra colección, configure los parámetros de su solicitud y pulse enviar para ver la respuesta.

Tenga en cuenta que puede obtener su token individual en el panel de administración. Lee cómo hacerlo en el artículo.

No olvides guardar estos cambios.

En nuestra colección Postman, encontrará todos los puntos finales, los tipos de solicitudes y los parámetros disponibles. En general, recomendamos utilizar solicitudes sincrónicas. Sin embargo, en situaciones en las que necesites procesar solicitudes masivas con un gran número de ubicaciones de una sola vez, las solicitudes asincrónicas también están disponibles y pueden ser efectivas. Para trabajar con ellas, haz clic en Distancematrix Accurate → Solicitudes masivas → Enviar un trabajo → Cuerpo, ¡empieza a trabajar!

En la colección Postman, puedes encontrar todos los parámetros que necesitas para configurar tus solicitudes. Si tienes alguna pregunta, no dudes en contacta con nosotros.

Cuando te sientas cómodo con lo básico, puedes explorar las funciones más avanzadas de nuestra API. La documentación detallada que aparece a continuación lo guiará a través de las funcionalidades específicas de nuestra API.

Guía para desarrolladores de geocodificación inversa

Formato de solicitud de API

Nuestra API de geocodificación inversa Distancematrix.ai adopta un formato de solicitud similar al de otras API estándar del sector, lo que garantiza una transición intuitiva y fluida para los usuarios familiarizados con las herramientas de geocodificación estándar.

Este es un ejemplo del aspecto que tendría o podría tener una solicitud de API adecuada:

OBTENER:

https://api.distancematrix.ai/maps/api/geocode/json?latlng=37.422387799999996,-122.08418770000002&language=uk&key=<your_access_token>

¡Copiado!

Componentes de la solicitud:

Cifrado HTTPS: https:// se usa para una comunicación segura.
Dominio: api.distancematrix.ai es el dominio de la API precisa.
Ruta de solicitud: /maps/api/geocode/json especifica el tipo de solicitud.
Parámetro requerido: ?latlng=37,422387799999996,-122,08418770000002 especifica la latitud y la longitud para la geocodificación inversa.
Parámetro opcional: &language=uk se puede agregar para la preferencia de idioma.
Token de autorización: &key=<your_access_token> es necesario para autenticar la solicitud.

Los parámetros se separan mediante el signo y (&), como es habitual en las URL.

Esta configuración está diseñada para la API de geocodificación inversa, en la que se utilizan diferentes parámetros en comparación con la geocodificación estándar. La página lo guiará sobre cómo obtener la latitud y la longitud a partir de una API de direcciones, incluidos los parámetros obligatorios y opcionales que debe usar y el tipo de respuesta de geocodificación que puede esperar. Además, se proporcionará un ejemplo de respuesta JSON basada en la marca de salida.

Por ejemplo, este es un ejemplo de solicitud para convertir las coordenadas de las pirámides de Egipto en una dirección, pero obtener los resultados en inglés en lugar de en árabe:

https://api.distancematrix.ai/maps/api/geocode/json?latlng=29.976480,%2031.131302&language=en&key=access_token

¡Copiado!

Parámetros obligatorios en una solicitud de geocodificación inversa:

latong: Este parámetro obligatorio incluye los valores de latitud y longitud para especificar la ubicación para la que desea obtener la dirección. Ejemplo:

latlng=37.422387799999996,-122.08418770000002

¡Copiado!

clave: Una clave de API única que autentica al solicitante y permite el cálculo de la cuota. Esta clave debe incluirse en cada solicitud. Añade tu clave de API a la solicitud utilizando el formato &key=<your_access_token>.

Sigue el eslabón para obtener más información sobre la clave, su propósito, cómo obtenerla y los límites de la API de geocodificación inversa.

Parámetros opcionales en una solicitud de geocodificación inversa:

lengua: Establece el idioma de los resultados.

Los idiomas compatibles se enumeran en el sitio web.
Si no se especifica, se establece de forma predeterminada en el encabezado Accept-Language o en el idioma del dominio de la solicitud.
La geocodificación inversa proporciona direcciones postales legibles en el idioma local, que se transliteran si es necesario, y utiliza el idioma preferido para todas las demás direcciones. Si un nombre no está disponible en el idioma elegido, se utiliza el que más se parezca.

Mostrar la lista de idiomas

Mostrar idiomas

Ocultar idiomas

Código de idioma

Idioma

Código de idioma

Idioma

afrikáans

japonés

albanesa

canarés

soy

amárico

Kazajo

soy

árabe

Jemer

por qué

armenio

coreano

Azerbaiyano

cielo

Kirguís

vasco

Lao

estar

Bielorruso

letón

bengalí

lituano

bosnio

macedónio

bolsa

búlgaro

malayo

birmano

Malayalam

catalán

señor

marathi

chino

mongol

zh-CN

Chino (simplificado)

nuevo

nepalés

zh-HK

Chino (Hong Kong)

noruego

zh-TW

Chino (tradicional)

polaco

hora

croata

portugués

checa

pt-BR

Portugués (Brasil)

danés

pt-PT

Portugués (Portugal)

holandesa

panyabí

Inglés

rumano

en-AU

Inglés (australiano)

rusa

en-GB

Inglés (Gran Bretaña)

serbio

estonio

cingalés

farsi

eslovaco

finlandés

esloveno

filmar

filipino

sí

española

para

francesa

es-419

Español (Latinoamérica)

FR-CA

Francés (Canadá)

swahili

gallego

sueco

georgiano

té

Tamil

alemán

Telugu

griego

tailandés

pistola

Gujarati

turca

hebreo

Reino Unido

ucraniana

hola

hindi

nuestro

Urdu

húngara

nosotros

Uzbeko

islandés

vietnamita

identificación

indonesio

zulú

eso

italiano

tipo_resultado: filtra los resultados por tipo de dirección, utilizando una barra vertical (|) para varios tipos. Actúa como un filtro posterior a la búsqueda y descarta los resultados que no coinciden con los tipos especificados. Entre los tipos admitidos se incluyen:

dirección_calle: Dirección postal precisa.
ruta: Rutas con nombres como «US 101".
intersección: Intersecciones principales.
política: Entidades políticas.
campo: Entidades políticas nacionales.
área_administrativo_nivel_1 a área_administrativa_nivel_5: Diversos niveles de entidades civiles por debajo del país.
área_coloquial: Nombres de uso común.
localidad: Ciudades o pueblos.
sublocalidad (y nivel_de_sublocalidad_1 a nivel_de_sublocalidad 5): Entidades situadas por debajo de una localidad.
vecindario: Barrios.
premisa: Ubicaciones nombradas, como edificios.
subpremisa: Entidades dentro de un local más grande.
código_postal: Códigos postales.
característica_natural: Monumentos naturales.
aeropuerto: Aeropuertos.
parque: Parques.
punto_de_interés: Puntos de interés, como edificios famosos.

tipo_de_ubicación: filtra por tipos de ubicación y, de nuevo, utiliza una barra vertical (|) para los múltiplos. Filtra posteriormente los resultados de búsqueda, conservando solo los que coinciden con los tipos especificados. Los tipos admitidos son:

«AZOTEA«: Ubicaciones precisas a nivel de dirección postal.
«RANGO_INTERPOLADO«: Aproximaciones entre puntos precisos.
«CENTRO_GEOMÉTRICO«: Centros de líneas o áreas.
«APROXIMADO«: Ubicaciones aproximadas.

Si ambos tipo_resultado y tipo_de_ubicación se utilizan filtros, solo se devuelven los resultados que coinciden con ambos. Si no se encuentra ninguna coincidencia, la API devuelve»CERO_RESULTADOS_«.

Respuestas de geocodificación inversa

La solicitud en cuestión utiliza la API de geocodificación inversa para convertir las coordenadas de latitud y longitud '40.714224, -73.961452', ubicadas en Brooklyn, en una dirección legible por humanos y especifica que la respuesta debe estar en formato JSON.

La solicitud está estructurada de la siguiente manera:

OBTENER:

https://api.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>

¡Copiado!

*Nota importante: Al introducir el latling parámetro, asegúrese de que no haya espacio entre los valores de latitud y longitud.

Ejemplo de respuesta de JSON:

BODY
{
    "result": [
        {
            "address_components": [
                {
                    "long_name": "290-306",
                    "short_name": "290-306",
                    "types": [
                        "street_number"
                    ]
                },
                {
                    "long_name": "bedford ave",
                    "short_name": "bedford ave",
                    "types": [
                        "route"
                    ]
                },
                {
                    "long_name": "brooklyn",
                    "short_name": "brooklyn",
                    "types": [
                        "city_district"
                    ]
                },
                {
                    "long_name": "ny",
                    "short_name": "ny",
                    "types": [
                        "state"
                    ]
                },
                {
                    "long_name": "11249",
                    "short_name": "11249",
                    "types": [
                        "postcode"
                    ]
                },
                {
                    "long_name": "usa",
                    "short_name": "usa",
                    "types": [
                        "country"
                    ]
                }
            ],
            "formatted_address": "290-306 Bedford Ave, Brooklyn, NY 11249, USA",
            "geometry": {
                "location": {
                    "lat": 40.714224,
                    "lng": -73.961452
                },
                "location_type": "APPROXIMATE",
                "viewport": {
                    "northeast": {
                        "lat": 40.714224,
                        "lng": -73.961452
                    },
                    "southwest": {
                        "lat": 40.714224,
                        "lng": -73.961452
                    }
                }
            },
            "place_id": "",
            "plus_code": {},
            "types": [
                "locality",
                "political"
            ]
        }
    ],
    "status": "OK"
}

¡Copiado!

El»dirección_formateada«los resultados incluyen varias formas de nombrar geográficamente una ubicación, como direcciones de calles, nombres de ciudades, estados o países, y arrojan cualquiera de estos tipos como resultados válidos. Por ejemplo, la geocodificación de un punto en Chicago se puede representar como una dirección postal, una ciudad (Chicago), un estado (Illinois) o un país (EE. UU.). El geocodificador inverso hace coincidir las entidades políticas, las direcciones postales y los códigos postales.

* Nota importante: La geocodificación inversa estima la ubicación direccionable más cercana dentro de un rango de tolerancia específico y devuelve cero resultados si no se encuentra ninguna coincidencia cercana.

Tenga en cuenta que la respuesta JSON tiene dos elementos principales:

«estado»: Este elemento proporciona metadatos sobre la solicitud. Consulte el Códigos de estado a continuación para obtener más información.

«resultado»: Esto incluye una matriz con detalles de direcciones geocodificadas e información geométrica.

Ten en cuenta que para extraer valores específicos de estos resultados, por lo general necesitas analizar el JSON, lo que a su vez es un proceso sencillo.

Códigos de estado

En la respuesta de geocodificación, la»estado«El campo muestra el estado de la solicitud y puede incluir detalles de depuración. Los valores posibles son:

«ESTÁ BIEN»: Sin errores; se procesó la dirección y se devolvieron los códigos geográficos.

«CERO RESULTADOS»: La geocodificación se realizó correctamente pero no se encontraron resultados, posiblemente debido a que no existe una dirección.

«SOBREPASAR EL LÍMITE DIARIO»: Puede significar que falta una clave de API o no es válida, que no se ha habilitado la facturación o que se ha superado un límite de uso.

«SOBRE_LÍMITE DE CONSULTA»: indica el uso excesivo de las cuotas.

«SOLICITUD_DENEGADA»: Su solicitud ha sido denegada.

«SOLICITUD_INVÁLIDA»: normalmente significa que faltan detalles de la consulta (dirección, componentes o latling).

«ERROR_DESCONOCIDO»: Un error del servidor impidió el procesamiento. Es posible que el reintento se haya realizado correctamente.

Mensajes de error

Si el código de estado del geocodificador no es»BIEN,» y»mensaje_error» el campo puede aparecer en la respuesta. Este campo proporciona los motivos detallados del código de estado específico.

*Nota importante: El»mensaje_error» el campo no siempre está incluido y su contenido puede variar.

Resultados

Cuando el geocodificador produce resultados, estos se colocan en una matriz de resultados en formato JSON. Si no se encuentra ningún resultado, por ejemplo, con una dirección que no existe, la matriz se devuelve vacía.

Los campos clave de un resultado típico incluyen:

matriz de tipos []: Especifica el tipo de resultado, con etiquetas como «localidad» para las ciudades o «político» para las entidades políticas. Por ejemplo, «Chicago» podría etiquetarse como ambas cosas.

dirección_formateada: Una cadena de direcciones legible por humanos, a menudo similar a una dirección postal. Sin embargo, en algunos lugares, como el Reino Unido, es posible que las direcciones postales verdaderas no se puedan distribuir. Esta dirección se compone de componentes como el número de la calle, la ruta, la ciudad y el estado. En lugar de analizar esta dirección, utilice los componentes de dirección independientes que también se proporcionan en la respuesta.

direcciones_componentes []: Una matriz de los componentes de la dirección.

Cada componente de dirección normalmente contiene los siguientes campos:

tipos []: Especifica el tipo de cada componente de dirección.

nombre_largo: Proporciona el texto completo de la descripción o el nombre del componente de dirección tal como lo indica el geocodificador.

nombre_corto: Se aplica al nombre del componente de dirección con una versión abreviada disponible del nombre del componente de dirección. Tomemos el estado de Alaska como ejemplo: a nombre_corto de «AK», que es su abreviatura postal de 2 letras y un nombre_largo de «Alaska».

Tenga en cuenta estos puntos sobre la componentes de direcciones [] matriz en los resultados de geocodificación:

La matriz puede incluir más elementos que el dirección_formateada.

No siempre abarca a todas las entidades políticas de una dirección, solo a las del dirección_formateada. Utilice la geocodificación inversa con latitud/longitud para obtener una lista completa.

El formato de respuesta, incluidos el número y los tipos de componentes de la dirección, puede variar con cada solicitud y con el tiempo para la misma dirección. Los componentes pueden cambiar de posición, cambiar de tipo o estar ausentes en las respuestas posteriores.

Para utilizar de forma eficaz la respuesta de geocodificación, debe analizar la matriz de componentes y seleccionar los valores según sea necesario.

localidad_código postal []: Esta matriz muestra todas las localidades de un código postal. Aparece solo para los códigos postales que abarcan varias localidades.

geometría: Proporciona detalles clave sobre la ubicación:

ubicación: La latitud y la longitud geocodificadas. Suele ser el campo más importante para las búsquedas de direcciones estándar.
tipo_de_ubicación: Información adicional sobre la ubicación. Los valores admitidos incluyen:
- »AZOTEA»: un código geográfico preciso con la ubicación exacta de la dirección postal.
- «RANGO_INTERPOLADO«: Un resultado aproximado, que se utiliza a menudo cuando no se dispone de datos específicos sobre azoteas.
- «CENTRO_GEOMÉTRICO«: El punto central de una línea o área.
- »APROXIMADO»: Una ubicación estimada.

coincidencia parcial: indica una coincidencia no exacta, en la que solo se pudo hacer coincidir una parte de la dirección solicitada. Esto es habitual en el caso de direcciones postales inexistentes en la localidad solicitada o cuando una dirección coincide con varias ubicaciones. Por ejemplo, una solicitud con una dirección ligeramente mal escrita puede mostrar una dirección cercana correctamente escrita como una coincidencia parcial.

Tipos de direcciones y tipos de componentes de direcciones

El tipos [] La matriz de los resultados de geocodificación indica el tipo de dirección, que puede incluir:

dirección_calle: una dirección física específica.

ruta: Una ruta con nombre similar a «US 101».

intersección: Una importante encrucijada de dos caminos.

política: Una entidad política, a menudo un área de administración civil.

país: La entidad política nacional, por lo general del tipo de nivel superior.

nivel_de_área_administrativo_2: una entidad civil secundaria, como los condados de EE. UU.

área_administrativa_nivel_3 a área_administrativa_nivel_5: divisiones civiles de orden inferior.

Otros tipos compatibles incluyen:

área_coloquial: Un nombre alternativo para un lugar.

localidad: una ciudad o pueblo incorporado.

sublocalidad (y niveles 1 a 5): una entidad civil dentro de una localidad.

vecindario: Un barrio específico.

premisa: Un edificio o complejo con nombre.

subpremisa: Una unidad dentro de un local más grande.

código_postal: El código postal.

característica_natural: Monumentos naturales notables.

aeropuerto: Un aeropuerto.

parque: Un parque con nombre.

punto_de_interés: Entidades locales importantes, como puntos de referencia.

Una lista de tipos vacía significa que no hay tipos conocidos para ese componente de dirección. Entre los tipos adicionales se incluyen:

suelo: Planta del edificio.

establecimiento: Lugares no clasificados.

aparcamiento: Áreas de estacionamiento.

post_box: Buzones postales específicos.

ciudad_postal: Áreas geográficas utilizadas para las direcciones postales.

habitación: Habitaciones específicas de un edificio.

número_calle: Número exacto de la calle.

estación de autobuses, estación de tren, estación de tránsito: Paradas de tránsito.

PREGUNTAS MÁS FRECUENTES

¿Qué puede hacer con la API de geocodificación inversa?

Las empresas que se ocupan de la geocodificación utilizan ampliamente las API de geocodificación directa y de geocodificación inversa en el software y las aplicaciones para localizar tiendas, vehículos y clientes, lo que contribuye a la gestión del transporte y al seguimiento de los movimientos.

Más que solo la identificación y ubicación de direcciones, la geocodificación inversa es una herramienta versátil para el mapeo de ubicaciones, la planificación de rutas y el análisis de datos. Esta tecnología puede resultar beneficiosa para las empresas de logística que requieren detalles de ubicación precisos. Hay más ejemplos reales de API de geocodificación inversa en acción en nuestro sitio web.

¿Por qué usar la API de geocodificación inversa?

La API de geocodificación inversa de DistanceMatrix.ai proporciona datos de ubicación precisos del 99% del mundo en una variedad de formatos. De este modo, puede obtener la dirección correcta en cuestión de segundos desde cualquier lugar. Eso es lo que hace que nuestra herramienta tenga una gran demanda en varios sectores. Además, debido a su alta precisión, compite con los principales proveedores del sector. Otra cosa a tener en cuenta es que el proceso de cambio de cualquier servicio secundario a nuestra API es fluido y sin problemas.

Introducción

Antes de empezar Cómo usar la API de geocodificación Cómo usar a través de Postman

Guía para desarrolladores de geocodificación inversa

Formato de solicitud Parámetros Respuestas Códigos de estado Mensajes de error Resultados Tipos de direcciones y tipos de componentes de direcciones

Geocodificación directa

PREGUNTAS MÁS FRECUENTES

¿Qué puede hacer con la API de geocodificación?¿Por qué usar la API de geocodificación?

Antes de empezar

Cómo usar la API de geocodificación inversa

Se puede acceder a este servicio a través de un HTTP interfaz. Para las solicitudes de geocodificación inversa, tendrá que enviar una consulta en forma de coordenadas (latitud y longitud). En la siguiente lista se detallan los dos parámetros de estas solicitudes.

Al realizar la consulta, recibirá una respuesta en forma de JSON documento que contiene los resultados más pertinentes. En la documentación que figura a continuación se proporcionan ejemplos de dichas solicitudes y sus correspondientes respuestas.

La seguridad es lo primero. Por eso se recomienda encarecidamente el uso de HTTPS, especialmente para las aplicaciones que traten datos confidenciales, como la ubicación del usuario. El cifrado HTTPS refuerza la seguridad de la aplicación y la hace más resistente a la vigilancia y la modificación.

Nuestra API de geocodificación inversa le brinda la flexibilidad de realizar solicitudes de la manera que mejor se adapte a sus necesidades. Las instrucciones detalladas anteriores lo guían sobre cómo realizar estas solicitudes con Postman, una herramienta de interacción de API versátil y fácil de usar.

Cómo usar la API de geocodificación a través de Postman

Para empezar con Postman, instálalo en tu ordenador o accede a la versión web de un navegador.
Importe nuestra colección de API preconfigurada:
- Abre Postman.
- Haz clic en el botón «Importar» en la esquina superior izquierda.
- Selecciona «Importar desde enlace» y pega este enlace a la colección de Postman: https://www.postman.com/distancematrix/workspace/distance-matrix/overview
Tras la importación, Postman añadirá automáticamente la colección a tu espacio de trabajo.
Para los usuarios de la versión en línea de Postman, pueden abrir directamente el enlace de la colección y crear una bifurcación. Para ello, haga clic en los tres puntos situados junto al nombre de la colección.
Configure su entorno en Postman, vaya a la sección Variables y añada su token de autenticación en el campo «Token de autorización de API».
No olvides guardar estos cambios.
Haga su primera solicitud: seleccione un punto final de nuestra colección, configure los parámetros de su solicitud y pulse enviar para ver la respuesta.

Tenga en cuenta que puede obtener su token individual en el panel de administración. Lee cómo hacerlo en el artículo.

No olvides guardar estos cambios.

Guía para desarrolladores de geocodificación inversa

Formato de solicitud de API

OBTENER:

https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=37.422387799999996,-122.08418770000002&key=<your_access_token>

¡Copiado!

Componentes de la solicitud:

Cifrado HTTPS: https:// se usa para una comunicación segura.
Dominio: api-v2.distancematrix.ai es el dominio de la API precisa.
Ruta de solicitud: /maps/api/geocode/json especifica el tipo de solicitud.
Parámetro requerido: ?latlng=37,422387799999996,-122,08418770000002 especifica la latitud y la longitud para la geocodificación inversa.
Parámetro opcional: &language=uk se puede agregar para la preferencia de idioma.
Token de autorización: &key=<your_access_token> es necesario para autenticar la solicitud.

Los parámetros se separan mediante el signo y (&), como es habitual en las URL.

Esta configuración está diseñada para la API de geocodificación inversa, en la que se utilizan diferentes parámetros en comparación con la geocodificación estándar. La página lo guiará sobre cómo obtener la latitud y la longitud a partir de una API de direcciones, incluidos los parámetros que debe usar y el tipo de respuesta de geocodificación que puede esperar. Además, se proporcionará un ejemplo de respuesta JSON basada en la marca de salida.

https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=29.976480,%2031.131302&key=access_token

¡Copiado!

Parámetros obligatorios en una solicitud de geocodificación inversa:

latong: Este parámetro obligatorio incluye los valores de latitud y longitud para especificar la ubicación para la que desea obtener la dirección. Ejemplo:

latlng=37.422387799999996,-122.08418770000002

¡Copiado!

Sigue el eslabón para obtener más información sobre la clave, su propósito, cómo obtenerla y los límites de la API de geocodificación inversa.

Respuestas de geocodificación inversa

OBTENER:

https://api-v2.distancematrix.ai/maps/api/geocode/json?latlng=40.714224,-73.961452&key=<your_access_token>

¡Copiado!

*Nota importante: Al introducir el latling parámetro, asegúrese de que no haya espacio entre los valores de latitud y longitud.

Ejemplo de respuesta de JSON:

BODY
{
    "result": [
        {
            "address_components": [
                {
                    "long_name": "United States",
                    "short_name": "US",
                    "types": [
                        "country",
                        "political"
                    ]
                },
                {
                    "long_name": "Brooklyn",
                    "short_name": "Brooklyn",
                    "types": [
                        "administrative_area_level_3",
                        "political"
                    ]
                },
                {
                    "long_name": "11211",
                    "short_name": "11211",
                    "types": [
                        "postal_code"
                    ]
                },
                {
                    "long_name": "Brooklyn",
                    "short_name": "Brooklyn",
                    "types": [
                        "locality",
                        "political"
                    ]
                },
                {
                    "long_name": "279",
                    "short_name": "279",
                    "types": [
                        "street_number"
                    ]
                },
                {
                    "long_name": "Bedford Avenue",
                    "short_name": "Bedford Avenue",
                    "types": [
                        "route"
                    ]
                },
                {
                    "long_name": "Michel Cluizel",
                    "short_name": "Michel Cluizel",
                    "types": [
                        "name"
                    ]
                },
                {
                    "long_name": "NY",
                    "short_name": "NY",
                    "types": [
                        "state",
                        "administrative_area_level_1",
                        "political"
                    ]
                }
            ],
            "formatted_address": "279 Bedford Avenue, Kings County, Brooklyn 11211, United States",
            "geometry": {
                "location": {
                    "lat": 40.7142138,
                    "lng": -73.9613419
                },
                "location_type": "APPROXIMATE",
                "viewport": {
                    "northeast": {
                        "lat": 40.7142138,
                        "lng": -73.9613419
                    },
                    "southwest": {
                        "lat": 40.7142138,
                        "lng": -73.9613419
                    }
                }
            },
            "place_id": "4961172027",
            "plus_code": {},
            "types": [
                "street_address"
            ]
        }
    ],
    "status": "OK"
}