La API de Información Geocodificada de Fetch permite obtener información geográfica precisa y estructurada a partir de coordenadas de latitud y longitud. Al recibir 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 vecindarios, 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, detallando cada elemento que compone la dirección, incluidos el número de calle (street_number), el nombre de la calle (route), el vecindario (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, incluidos los 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 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 usar 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/9138/fetch+geocode+information+api/16529/reverse+geocoding?latlng=40.714222,-73.961442' --header 'Authorization: Bearer YOUR_API_KEY'
Para usar este punto final, 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/9138/fetch+geocode+information+api/16532/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 punto final 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, vista de mapa 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 arreglo 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 la representación alternativa de la ubicación.
El punto final de geocodificación proporciona información basada en una dirección especificada, devolviendo datos estructurados similares a los del punto final de geocodificación inversa. Esto incluye la dirección formateada, los componentes de la dirección, las coordenadas y los códigos Plus, permitiendo a los usuarios convertir direcciones en datos geográficos.
Los usuarios pueden personalizar sus solicitudes especificando la latitud y la longitud para el endpoint de Geocodificación Inversa o una dirección para el endpoint de Geocodificación. Los parámetros adicionales pueden incluir preferencias de idioma o formatos de datos específicos, según 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 contribida 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 recuperación, como consultar ubicaciones cercanas o utilizar fuentes de datos alternativas para mejorar la completitud de los resultados.
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.466ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.552ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
670ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
630ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
468ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
140ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
723ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.541ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
756ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
459ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
4.272ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
17ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
8.049ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
2.270ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.767ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.924ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
16ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
1.004ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
1.038ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
1.585ms