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.
-min.webp)
Tenga en cuenta que puede obtener su token individual en el panel de administración. Lee cómo hacerlo en
el artículo.
-min.webp)
No olvides guardar estos cambios.
-min.webp)
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!
-min.webp)
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.
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
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.
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
sí
española
para
francesa
es-419
Español (Latinoamérica)
FR-CA
Francés (Canadá)
sw
swahili
gl
gallego
sv
sueco
ka
georgiano
té
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:
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:
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>
*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"
}
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:
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.
