Esta API te permite obtener información geográfica estructurada basada en el nombre de una ciudad proporcionado como entrada. Cuando se realiza una solicitud con el nombre de una ciudad, la API responde con un conjunto de datos detallado en formato JSON. La estructura de la respuesta incluye un objeto que representa la ciudad consultada y contiene varios atributos útiles para la geolocalización o el análisis geográfico.
El objeto principal contiene un identificador único llamado geo_id, que representa de manera única esa ciudad en el sistema. También incluye el nombre de la ciudad (name), junto con la correspondiente subdivisión administrativa, que puede ser un estado, región o distrito, y está representada en el campo state_or_region. Además, se proporciona información detallada sobre el país al que pertenece la ciudad a través de un objeto anidado dentro de la propiedad country, que incluye el código del país en formato ISO (code) y el nombre completo del país (name).
Geográficamente, la respuesta contiene las coordenadas exactas de la ciudad, expresadas en dos campos: latitud y longitud. Estos valores permiten localizar con precisión la ciudad en mapas o integrarla con sistemas de información geográfica (GIS), servicios de mapas, aplicaciones móviles con geolocalización, entre otros.
La estructura de la respuesta está diseñada para ser fácil de interpretar y consumir por aplicaciones web, aplicaciones móviles o servicios backend que necesiten traducir un nombre de ciudad en coordenadas o información geográfica estandarizada. También es útil para tareas como la validación de ubicación, análisis de cobertura, visualización de datos en mapas o simplemente para obtener datos básicos sobre una ubicación.
En resumen, esta API facilita la conversión de nombres de ciudades en información geográfica completa, estandarizada y precisa que puede integrarse fácilmente en diferentes tipos de aplicaciones o flujos de datos que dependen de ubicaciones geográficas.
Devuelve información geográfica detallada como el país, la región y las coordenadas basadas en el nombre de una ciudad proporcionado como parámetro
[{"geo_id": 2968496, "name": "Villeparisis", "state_or_region": "\u00cele-de-France", "country": {"code": "FR", "name": "France"}, "latitude": 48.942081, "longitude": 2.61463}, {"geo_id": 2988507, "name": "Paris", "state_or_region": "\u00cele-de-France", "country": {"code": "FR", "name": "France"}, "latitude": 48.853409, "longitude": 2.3488}, {"geo_id": 3023645, "name": "Cormeilles-en-Parisis", "state_or_region": "\u00cele-de-France", "country": {"code": "FR", "name": "France"}, "latitude": 48.971111, "longitude": 2.20491}, {"geo_id": 3725276, "name": "Fond Parisien", "state_or_region": "Ouest", "country": {"code": "HT", "name": "Haiti"}, "latitude": 18.505831, "longitude": -71.976669}]
curl --location --request GET 'https://zylalabs.com/api/10888/fetch+city+location+information+api/20596/city+information&city_name=Required' --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.
La API devuelve información geográfica estructurada para una ciudad especificada, incluyendo su nombre, región administrativa, detalles del país y coordenadas precisas (latitud y longitud) en formato JSON
Los campos clave en la respuesta incluyen `geo_id` (identificador único de la ciudad), `name` (nombre de la ciudad), `state_or_region` (subdivisión administrativa), `country` (objeto anidado con `code` y `name`), `latitude` y `longitude`
La respuesta está estructurada como un array de objetos, cada uno representando una ciudad. Cada objeto contiene campos para detalles geográficos y administrativos, lo que facilita su análisis y utilización en aplicaciones
La API proporciona información sobre nombres de ciudades, coordenadas geográficas, regiones administrativas y detalles del país, lo que permite a los usuarios obtener datos de ubicación completos para diversas aplicaciones
Los usuarios pueden personalizar las solicitudes especificando el nombre de la ciudad como un parámetro en la solicitud GET La API devolverá datos para el nombre de la ciudad exacto proporcionado permitiendo consultas específicas
Los casos de uso típicos incluyen servicios de geolocalización aplicaciones de mapeo validación de ubicación visualización de datos y análisis geográfico donde la información precisa de la ciudad es esencial
La precisión de los datos se mantiene a través de actualizaciones regulares y validaciones contra bases de datos geográficas fiables asegurando que la información proporcionada esté actual y precisa
Si la API devuelve resultados parciales o vacíos los usuarios deben verificar el nombre de la ciudad por su precisión o considerar nombres o deletreados alternativos Implementar el manejo de errores en las aplicaciones también puede gestionar tales escenarios de manera efectiva
Nivel de Servicio:
100%
Tiempo de Respuesta:
80ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
58ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
105ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
62ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.614ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
268ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
74ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
123ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
181ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
257ms