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 geolocalización o 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 (nombre) junto con la correspondiente subdivisión administrativa que puede ser un estado región o distrito y se representa 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 (código) y el nombre completo del país (nombre)
Geográficamente la respuesta contiene las coordenadas exactas de la ciudad expresadas en dos campos: latitud y longitud Estos valores permiten localizar la ciudad con precisión en mapas o integrarla con sistemas de información geográfica (SIG) 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 de backend que necesitan traducir un nombre de ciudad en coordenadas o información geográfica estandarizada También es útil para tareas como 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 país, región y coordenadas basada en el nombre de una ciudad proporcionada 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/10890/city+location+data+retrieval+api/20595/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 arreglo de objetos, cada uno representando una ciudad. Cada objeto contiene campos para detalles geográficos y administrativos, lo que facilita su análisis y uso 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 lo que permite 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 validación contra bases de datos geográficas confiables asegurando que la información proporcionada sea actual y precisa
Si la API devuelve resultados parciales o vacíos los usuarios deben verificar la precisión del nombre de la ciudad o considerar nombres o grafías alternativas Implementar el manejo de errores en las aplicaciones también puede gestionar tales escenarios de manera efectiva
Nivel de Servicio:
100%
Tiempo de Respuesta:
58ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
257ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.614ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
62ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
670ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
243ms
Nivel de Servicio:
50%
Tiempo de Respuesta:
172ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
503ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
74ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
715ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
249ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
266ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
201ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
635ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.702ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
214ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
431ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
104ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
417ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.710ms