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

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:
  • 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.
__wf_reserved_heredar__wf_reserved_heredar
Tenga en cuenta que puede obtener su token individual en el panel de administración. Lee cómo hacerlo en el artículo.
__wf_reserved_heredar
No olvides guardar estos cambios.
__wf_reserved_heredar
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!
__wf_reserved_heredar
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.
  • __wf_reserved_heredar
    Los idiomas compatibles se enumeran en el sitio web.
  • __wf_reserved_heredar
    Si no se especifica, se establece de forma predeterminada en el encabezado Accept-Language o en el idioma del dominio de la solicitud.
  • __wf_reserved_heredar
    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
af
afrikáans
ja
japonés
m2
albanesa
kn
canarés
soy
amárico
kk
Kazajo
soy
árabe
km
Jemer
por qué
armenio
ko
coreano
az
Azerbaiyano
cielo
Kirguís
eu
vasco
lo
Lao
estar
Bielorruso
lv
letón
bn
bengalí
lt
lituano
bs
bosnio
km
macedónio
bolsa
búlgaro
ms
malayo
mi
birmano
ml
Malayalam
ca
catalán
señor
marathi
zh
chino
mn
mongol
zh-CN
Chino (simplificado)
nuevo
nepalés
zh-HK
Chino (Hong Kong)
no
noruego
zh-TW
Chino (tradicional)
pl
polaco
hora
croata
pt
portugués
cs
checa
pt-BR
Portugués (Brasil)
da
danés
pt-PT
Portugués (Portugal)
nl
holandesa
pa
panyabí
es
Inglés
o
rumano
en-AU
Inglés (australiano)
ru
rusa
en-GB
Inglés (Gran Bretaña)
sr
serbio
et
estonio
es
cingalés
fa
farsi
sk
eslovaco
fi
finlandés
sl
esloveno
filmar
filipino

española
para
francesa
es-419
Español (Latinoamérica)
FR-CA
Francés (Canadá)
sw
swahili
gl
gallego
sv
sueco
ka
georgiano

Tamil
de
alemán
te
Telugu
el
griego
la
tailandés
pistola
Gujarati
tr
turca
es
hebreo
Reino Unido
ucraniana
hola
hindi
nuestro
Urdu
hu
húngara
nosotros
Uzbeko
es
islandés
vi
vietnamita
identificación
indonesio
zu
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:
  • __wf_reserved_heredar
    dirección_calle: Dirección postal precisa.
  • __wf_reserved_heredar
    ruta: Rutas con nombres como «US 101".
  • __wf_reserved_heredar
    intersección: Intersecciones principales.
  • __wf_reserved_heredar
    política: Entidades políticas.
  • __wf_reserved_heredar
    campo: Entidades políticas nacionales.
  • __wf_reserved_heredar
    área_administrativo_nivel_1 a área_administrativa_nivel_5: Diversos niveles de entidades civiles por debajo del país.
  • __wf_reserved_heredar
    área_coloquial: Nombres de uso común.
  • __wf_reserved_heredar
    localidad: Ciudades o pueblos.
  • __wf_reserved_heredar
    sublocalidad (y nivel_de_sublocalidad_1 a nivel_de_sublocalidad 5): Entidades situadas por debajo de una localidad.
  • __wf_reserved_heredar
    vecindario: Barrios.
  • __wf_reserved_heredar
    premisa: Ubicaciones nombradas, como edificios.
  • __wf_reserved_heredar
    subpremisa: Entidades dentro de un local más grande.
  • __wf_reserved_heredar
    código_postal: Códigos postales.
  • __wf_reserved_heredar
    característica_natural: Monumentos naturales.
  • __wf_reserved_heredar
    aeropuerto: Aeropuertos.
  • __wf_reserved_heredar
    parque: Parques.
  • __wf_reserved_heredar
    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:
  • __wf_reserved_heredar
    «AZOTEA«: Ubicaciones precisas a nivel de dirección postal.
  • __wf_reserved_heredar
    «RANGO_INTERPOLADO«: Aproximaciones entre puntos precisos.
  • __wf_reserved_heredar
    «CENTRO_GEOMÉTRICO«: Centros de líneas o áreas.
  • __wf_reserved_heredar
    «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:
  • __wf_reserved_heredar
    ubicación: La latitud y la longitud geocodificadas. Suele ser el campo más importante para las búsquedas de direcciones estándar.
  • __wf_reserved_heredar
    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?

__wf_reserved_heredar

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?

__wf_reserved_heredar

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.

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). 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

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:
  • 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.
__wf_reserved_heredar__wf_reserved_heredar
Tenga en cuenta que puede obtener su token individual en el panel de administración. Lee cómo hacerlo en el artículo.
__wf_reserved_heredar
No olvides guardar estos cambios.
__wf_reserved_heredar
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!
__wf_reserved_heredar
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-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!
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.

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-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"
}
¡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:
  • __wf_reserved_heredar
    ubicación: La latitud y la longitud geocodificadas. Suele ser el campo más importante para las búsquedas de direcciones estándar.
  • __wf_reserved_heredar
    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?

__wf_reserved_heredar

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?

__wf_reserved_heredar

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.

No es necesario realizar ningún pago por adelantado.
Comience de forma gratuita y obtenga acceso instantáneo a todos los productos y funciones de Distancematrix.ai