La API de Recuperación de Datos de Ubicación por Geocodificación Inversa permite obtener información geográfica precisa y estructurada a partir de coordenadas de latitud y longitud. Cuando recibe una ubicación, la API devuelve múltiples niveles de datos de dirección que permiten identificar con precisión tanto puntos específicos (como una dirección exacta) como áreas más amplias (como barrios, ciudades o condados).
La respuesta incluye un campo formatted_address que representa la dirección completa en un formato legible por humanos. También se proporcionan address_components, que detallan cada elemento que compone la dirección, incluidos el número de la calle (street_number), el nombre de la calle (route), el barrio (neighborhood), la sublocalidad (sublocality), la ciudad (locality), el condado (administrative_area_level_2), el estado (administrative_area_level_1), el país y el código postal. Cada componente viene con su nombre largo y corto, junto con su tipo correspondiente, que es útil para la clasificación y visualización.
Además, la API devuelve coordenadas precisas en el campo geometry.location, que incluyen valores de latitud y longitud, junto con el location_type que indica el nivel de precisión (por ejemplo, “ROOFTOP,” “APPROXIMATE” o “GEOMETRIC_CENTER”). También se proporciona un viewport (área de visualización) para facilitar la representación geográfica en los mapas.
En algunos casos, la respuesta puede incluir varios resultados jerárquicos o alternativos, permitiendo el acceso a ubicaciones cercanas, edificios asociados, intersecciones o puntos de interés relacionados. También se incluyen códigos Plus (plus_code) con variantes compound_code y global_code, que son útiles para representar ubicaciones sin una dirección formal.
Esta API es ideal para aplicaciones de geolocalización, logística, servicios de entrega, análisis territorial, validación de direcciones, visualización de mapas y sistemas de información geográfica (SIG). Soporta múltiples formatos y niveles de granularidad, adaptándose tanto a necesidades precisas como a análisis territoriales más amplios.
En resumen, la API proporciona datos completos, estructurados y confiables para convertir coordenadas en información geográfica que sea comprensible y utilizable por sistemas modernos.
Para utilizar este punto final, debe especificar una latitud y una longitud en el parámetro.
Geocodificación inversa - Características del Endpoint
| Objeto | Descripción |
|---|---|
latlng |
[Requerido] Enter coordinates |
{
"plus_code" :
{
"compound_code" : "P27Q+MCM New York, NY, USA",
"global_code" : "87G8P27Q+MCM"
},
"results" :
[
{
"address_components" :
[
{
"long_name" : "277",
"short_name" : "277",
"types" :
[
"street_number"
]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" :
[
"route"
]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" :
[
"neighborhood",
"political"
]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" :
[
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" :
[
"postal_code"
]
}
],
"formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" :
{
"location" :
{
"lat" : 40.7142205,
"lng" : -73.9612903
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 40.71556948029149,
"lng" : -73.95994131970849
},
"southwest" :
{
"lat" : 40.7128715197085,
"lng" : -73.9626392802915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 40.7142498,
"longitude" : -73.9613696
}
}
],
"place_id" : "ChIJd8BlQ2BZwokRAFUEcm_qrcA",
"plus_code" :
{
"compound_code" : "P27Q+MF Brooklyn, NY, USA",
"global_code" : "87G8P27Q+MF"
},
"types" :
[
"street_address"
]
},
{
"address_components" :
[
{
"long_name" : "281",
"short_name" : "281",
"types" :
[
"street_number"
]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" :
[
"route"
]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" :
[
"neighborhood",
"political"
]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" :
[
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" :
[
"postal_code"
]
},
{
"long_name" : "4230",
"short_name" : "4230",
"types" :
[
"postal_code_suffix"
]
}
],
"formatted_address" : "281 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" :
{
"bounds" :
{
"northeast" :
{
"lat" : 40.7142054,
"lng" : -73.9612142
},
"southwest" :
{
"lat" : 40.7140652,
"lng" : -73.9614433
}
},
"location" :
{
"lat" : 40.7141354,
"lng" : -73.9613287
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 40.71548428029149,
"lng" : -73.9599797697085
},
"southwest" :
{
"lat" : 40.7127863197085,
"lng" : -73.9626777302915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 40.7141769,
"longitude" : -73.9614164
}
}
],
"place_id" : "ChIJiYRKQWBZwokR10UtO7vMvr0",
"types" :
[
"premise",
"street_address"
]
},
{
"address_components" :
[
{
"long_name" : "277",
"short_name" : "277",
"types" :
[
"street_number"
]
},
{
"long_name" : "Bedford Avenue",
"short_name" : "Bedford Ave",
"types" :
[
"route"
]
},
{
"long_name" : "Williamsburg",
"short_name" : "Williamsburg",
"types" :
[
"neighborhood",
"political"
]
},
{
"long_name" : "Brooklyn",
"short_name" : "Brooklyn",
"types" :
[
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name" : "Kings County",
"short_name" : "Kings County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "New York",
"short_name" : "NY",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "11211",
"short_name" : "11211",
"types" :
[
"postal_code"
]
}
],
"formatted_address" : "277 Bedford Ave, Brooklyn, NY 11211, USA",
"geometry" :
{
"location" :
{
"lat" : 40.7142205,
"lng" : -73.9612903
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 40.71556948029149,
"lng" : -73.95994131970849
},
"southwest" :
{
"lat" : 40.7128715197085,
"lng" : -73.9626392802915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 40.7142199,
"longitude" : -73.9613932
}
}
],
"place_id" : "ChIJIdIK_DJZwokRImC6xolwWOM",
"plus_code" :
{
"compound_code" : "P27Q+MF Brooklyn, NY, USA",
"global_code" : "87G8P27Q+MF"
},
"types" :
[
"establishment",
"food",
"point_of_interest",
"restaurant"
]
},
{
"address_components" :
[
{
"long_name" : "294"}]}],"_note":"Response truncated for documentation purposes"}
curl --location --request GET 'https://zylalabs.com/api/9139/reverse+geocode+location+data+retrieval+api/16527/reverse+geocoding?latlng=40.714222,-73.961442' --header 'Authorization: Bearer YOUR_API_KEY'
Para usar este endpoint, debes especificar una dirección en el parámetro.
Geocodificación - Características del Endpoint
| Objeto | Descripción |
|---|---|
address |
[Requerido] Indicate an address |
{
"results" :
[
{
"address_components" :
[
{
"long_name" : "Infinite Loop 1",
"short_name" : "Infinite Loop 1",
"types" :
[
"premise"
]
},
{
"long_name" : "1",
"short_name" : "1",
"types" :
[
"street_number"
]
},
{
"long_name" : "Infinite Loop",
"short_name" : "Infinite Loop",
"types" :
[
"route"
]
},
{
"long_name" : "Cupertino",
"short_name" : "Cupertino",
"types" :
[
"locality",
"political"
]
},
{
"long_name" : "Santa Clara County",
"short_name" : "Santa Clara County",
"types" :
[
"administrative_area_level_2",
"political"
]
},
{
"long_name" : "California",
"short_name" : "CA",
"types" :
[
"administrative_area_level_1",
"political"
]
},
{
"long_name" : "United States",
"short_name" : "US",
"types" :
[
"country",
"political"
]
},
{
"long_name" : "95014",
"short_name" : "95014",
"types" :
[
"postal_code"
]
},
{
"long_name" : "2083",
"short_name" : "2083",
"types" :
[
"postal_code_suffix"
]
}
],
"formatted_address" : "Infinite Loop 1, 1 Infinite Loop, Cupertino, CA 95014, USA",
"geometry" :
{
"bounds" :
{
"northeast" :
{
"lat" : 37.3321786,
"lng" : -122.0297996
},
"southwest" :
{
"lat" : 37.3312158,
"lng" : -122.0305776
}
},
"location" :
{
"lat" : 37.3318598,
"lng" : -122.0302485
},
"location_type" : "ROOFTOP",
"viewport" :
{
"northeast" :
{
"lat" : 37.3330203302915,
"lng" : -122.0289492197085
},
"southwest" :
{
"lat" : 37.3303223697085,
"lng" : -122.0316471802915
}
}
},
"navigation_points" :
[
{
"location" :
{
"latitude" : 37.33116529999999,
"longitude" : -122.0307429
},
"restricted_travel_modes" :
[
"WALK"
]
},
{
"location" :
{
"latitude" : 37.3314215,
"longitude" : -122.030747
}
},
{
"location" :
{
"latitude" : 37.3317064,
"longitude" : -122.0307154
}
},
{
"location" :
{
"latitude" : 37.3319324,
"longitude" : -122.0307347
}
}
],
"place_id" : "ChIJAf9D3La1j4ARuwKZtGjgMXw",
"types" :
[
"premise",
"street_address"
]
}
],
"status" : "OK"
}
curl --location --request GET 'https://zylalabs.com/api/9139/reverse+geocode+location+data+retrieval+api/16531/geocoding?address=1 Infinite Loop, Cupertino, CA 95014, USA' --header 'Authorization: Bearer YOUR_API_KEY'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
El endpoint de Geocodificación Inversa devuelve información geográfica estructurada basada en coordenadas de latitud y longitud. Esto incluye una dirección formateada, componentes de la dirección (como número de calle, vecindario, ciudad, estado y código postal), coordenadas precisas, tipo de ubicación, área de visualización para mapas y códigos Plus.
Los campos clave en la respuesta incluyen `formatted_address`, `address_components`, `geometry.location` (con latitud y longitud), `location_type`, `viewport` y `plus_code`. Cada campo proporciona detalles geográficos específicos para una identificación precisa de la ubicación.
Los datos de respuesta están organizados en una estructura JSON. Los componentes principales incluyen una cadena `formatted_address`, un array de `address_components` que detalla cada parte de la dirección, un objeto `geometry` que contiene las coordenadas de ubicación y un `plus_code` para una representación alternativa de la ubicación.
El endpoint de Geocodificación proporciona información basada en una dirección especificada, devolviendo datos estructurados similares al endpoint de Geocodificación Inversa. Esto incluye la dirección formateada, componentes de la dirección, coordenadas y códigos Plus, lo que permite a los usuarios convertir direcciones en datos geográficos.
Los usuarios pueden personalizar sus solicitudes especificando la latitud y la longitud para el punto final de Geocodificación Inversa o una dirección para el punto final de Geocodificación. Los parámetros adicionales pueden incluir preferencias de idioma o formatos de datos específicos, dependiendo de las capacidades de la API.
Los datos provienen de una combinación de bases de datos geográficas autorizadas, servicios de cartografía e información proporcionada por los usuarios. Este enfoque de múltiples fuentes ayuda a garantizar una cobertura integral y la precisión de los detalles geográficos.
Los casos de uso típicos incluyen aplicaciones de geolocalización, servicios de logística y entrega, validación de direcciones, análisis de territorios y sistemas de información geográfica (SIG). La API es útil para cualquier aplicación que requiera datos de ubicación precisos e información de direcciones estructurada.
Si la API devuelve resultados parciales o vacíos, los usuarios deben verificar la precisión de las coordenadas de entrada. Además, considere implementar mecanismos de respaldo, como consultar ubicaciones cercanas o utilizar fuentes de datos alternativas para mejorar la completitud de los resultados.
Nivel de Servicio:
100%
Tiempo de Respuesta:
370ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
630ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
620ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.466ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
121ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.429ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
449ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
251ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
670ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
123ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.341ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
3.940ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
337ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.215ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
173ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
4.374ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
6.917ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.537ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
524ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.633ms