{
"query": {
"lat": 40.4168,
"lon": -3.7038
},
"nearest": {
"geonameId": 6545083,
"name": "Sol",
"latitude": 40.4166,
"longitude": -3.7033,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 8164,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.05
},
"nearestMajorCity": {
"geonameId": 3117735,
"name": "Madrid",
"latitude": 40.4165,
"longitude": -3.7026,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 3255944,
"timezone": "Europe/Madrid",
"type": "capital",
"distanceKm": 0.11
},
"alternatives": [
{
"geonameId": 3117735,
"name": "Madrid",
"latitude": 40.4165,
"longitude": -3.7026,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 3255944,
"timezone": "Europe/Madrid",
"type": "capital",
"distanceKm": 0.11
},
{
"geonameId": 6544494,
"name": "Madrid Centro",
"latitude": 40.4183,
"longitude": -3.7027,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 149718,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.19
},
{
"geonameId": 6545082,
"name": "Las Cortes",
"latitude": 40.4161,
"longitude": -3.6967,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 10816,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.61
},
{
"geonameId": 6545077,
"name": "La Latina",
"latitude": 40.4132,
"longitude": -3.7093,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 10747,
"timezone": "Europe/Madrid",
"type": "neighborhood",
"distanceKm": 0.61
}
],
"attribution": "Place data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14234/reverse+geocoding+and+city+search+api/35323/reverse+geocode+coordinates?lat=40.4168&lon=-3.7038&minPopulation=Optional' --header 'Authorization: Bearer YOUR_API_KEY'
{
"query": "Salamanca",
"count": 7,
"results": [
{
"geonameId": 3988214,
"name": "Salamanca",
"latitude": 20.5698,
"longitude": -101.1977,
"countryCode": "MX",
"country": "Mexico",
"region": "Guanajuato",
"population": 160682,
"timezone": "America/Mexico_City"
},
{
"geonameId": 6544491,
"name": "Salamanca",
"latitude": 40.4297,
"longitude": -3.6797,
"countryCode": "ES",
"country": "Spain",
"region": "Madrid",
"population": 147707,
"timezone": "Europe/Madrid"
},
{
"geonameId": 3111108,
"name": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6639,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 144825,
"timezone": "Europe/Madrid"
},
{
"geonameId": 3872594,
"name": "Salamanca",
"latitude": -31.7792,
"longitude": -70.9639,
"countryCode": "CL",
"country": "Chile",
"region": "Coquimbo Region",
"population": 13265,
"timezone": "America/Santiago"
},
{
"geonameId": 5136088,
"name": "Salamanca",
"latitude": 42.1578,
"longitude": -78.715,
"countryCode": "US",
"country": "United States",
"region": "New York",
"population": 5586,
"timezone": "America/New_York"
},
{
"geonameId": 1690984,
"name": "Salamanca",
"latitude": 10.7465,
"longitude": 123.53,
"countryCode": "PH",
"country": "Philippines",
"region": "Western Visayas",
"population": 4994,
"timezone": "Asia/Manila"
},
{
"geonameId": 3955885,
"name": "Salamanca",
"latitude": -15.5047,
"longitude": -72.8342,
"countryCode": "PE",
"country": "Peru",
"region": "Arequipa",
"population": 547,
"timezone": "America/Lima"
}
],
"attribution": "Place data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14234/reverse+geocoding+and+city+search+api/35324/search+places+by+name?q=Salamanca&limit=10' --header 'Authorization: Bearer YOUR_API_KEY'
{
"query": {
"lat": 40.97,
"lon": -5.66,
"radiusKm": 25,
"minPopulation": 1000
},
"count": 10,
"places": [
{
"geonameId": 3111108,
"name": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6639,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 144825,
"timezone": "Europe/Madrid",
"type": "county seat",
"distanceKm": 0.35
},
{
"geonameId": 3109721,
"name": "Santa Marta de Tormes",
"latitude": 40.9507,
"longitude": -5.6272,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 14630,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 3.49
},
{
"geonameId": 3126397,
"name": "Carbajosa de la Sagrada",
"latitude": 40.9331,
"longitude": -5.6503,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 3467,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.18
},
{
"geonameId": 3104969,
"name": "Villares de la Reina",
"latitude": 41.0083,
"longitude": -5.6488,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 4079,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.36
},
{
"geonameId": 3127159,
"name": "Cabrerizos",
"latitude": 40.9781,
"longitude": -5.6091,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 2919,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.37
},
{
"geonameId": 3105411,
"name": "Villamayor",
"latitude": 40.9994,
"longitude": -5.6958,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 4538,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 4.44
},
{
"geonameId": 3126968,
"name": "Calvarrasa de Abajo",
"latitude": 40.9464,
"longitude": -5.5526,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 1003,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 9.39
},
{
"geonameId": 3108144,
"name": "Terradillos",
"latitude": 40.8384,
"longitude": -5.5416,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 3232,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 17.7
},
{
"geonameId": 3130706,
"name": "Alba de Tormes",
"latitude": 40.8266,
"longitude": -5.5124,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 4881,
"timezone": "Europe/Madrid",
"type": "seat",
"distanceKm": 20.2
},
{
"geonameId": 3104652,
"name": "Villoría",
"latitude": 40.9943,
"longitude": -5.3736,
"countryCode": "ES",
"country": "Spain",
"region": "Castille and León",
"population": 1390,
"timezone": "Europe/Madrid",
"type": "town",
"distanceKm": 24.19
}
],
"attribution": "Place data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14234/reverse+geocoding+and+city+search+api/35325/places+within+a+radius?lat=40.97&lon=-5.66&radius=25&minPopulation=1000&limit=20' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Geocodificación inversa y búsqueda de ciudades API simplemente incluye tu token de portador en el encabezado de Autorización.
| 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.
Cada punto final devuelve datos de geocodificación a nivel de ciudad, incluyendo coordenadas geográficas, nombres de pueblos o regiones, códigos de países, cifras de población y zonas horarias. Por ejemplo, el punto final de geocodificación inversa proporciona detalles sobre el pueblo más cercano y la ciudad más importante basándose en coordenadas
Los campos clave incluyen `geonameId`, `nombre`, `latitud`, `longitud`, `código del país`, `país`, `región`, `población`, `zona horaria` y `tipo` Estos campos proporcionan información esencial sobre la ubicación y sus características
Los parámetros incluyen `lat` y `lon` para la geocodificación inversa `query` para buscar lugares por nombre y `radiusKm` para encontrar lugares dentro de una distancia especificada Los usuarios también pueden especificar `minPopulation` para filtrar resultados según el tamaño de la población
Los datos de respuesta están estructurados en formato JSON, con un objeto `query` principal seguido de secciones de datos relevantes como `nearest`, `nearestMajorCity` y `places`. Cada sección contiene atributos detallados sobre las ubicaciones devueltas
Los datos provienen de una base de datos integral que cubre 171000 lugares en todo el mundo. Combina información geográfica demográfica y administrativa para asegurar precisión y relevancia
Los casos de uso típicos incluyen servicios basados en la ubicación aplicaciones de viaje planificación urbana y análisis geográfico Los desarrolladores pueden usar la API para mejorar las experiencias de los usuarios al proporcionar información específica de la ubicación
Los usuarios pueden utilizar los datos devueltos integrándolos en aplicaciones para mapeo, búsquedas de ubicación o análisis demográficos Por ejemplo, el campo `timezone` puede ayudar a programar eventos basados en la hora local
Si los resultados son parciales o vacíos, los usuarios deben verificar la precisión de los parámetros de entrada. Implementar lógica de respaldo, como sugerir ubicaciones cercanas o consultas alternativas, puede mejorar la experiencia del usuario cuando los datos son limitados