{
"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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Geocodificação Reversa e Pesquisa de Cidade API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
Cada ponto final retorna dados de geocodificação em nível de cidade, incluindo coordenadas geográficas, nomes de cidades ou regiões, códigos de país, números populacionais e fusos horários. Por exemplo, o ponto final de geocodificação reversa fornece detalhes sobre a cidade e a cidade principal mais próximas com base nas coordenadas
Os campos principais incluem `geonameId`, `nome`, `latitude`, `longitude`, `código do país`, `país`, `região`, `população`, `fuso horário` e `tipo` Esses campos fornecem informações essenciais sobre a localização e suas características
Os parâmetros incluem `lat` e `lon` para geocodificação reversa `query` para pesquisar lugares pelo nome e `radiusKm` para encontrar lugares dentro de uma distância especificada Os usuários também podem especificar `minPopulation` para filtrar resultados com base no tamanho da população
Os dados de resposta estão estruturados no formato JSON, com um objeto principal `query` seguido por seções de dados relevantes como `nearest`, `nearestMajorCity` e `places`. Cada seção contém atributos detalhados sobre os locais retornados
Os dados são oriundos de um banco de dados abrangente que cobre 171.000 locais em todo o mundo. Ele combina informações geográficas, demográficas e administrativas para garantir precisão e relevância
Os casos de uso típicos incluem serviços baseados em localização aplicativos de viagem planejamento urbano e análise geográfica Os desenvolvedores podem usar a API para aprimorar as experiências dos usuários fornecendo informações específicas de localização
Os usuários podem utilizar os dados retornados integrando-os em aplicativos para mapeamento, pesquisas de localização ou análise demográfica Por exemplo, o campo `timezone` pode ajudar na programação de eventos com base no horário local
Se os resultados forem parciais ou vazios os usuários devem verificar os parâmetros de entrada quanto à precisão Implementar lógica de fallback como sugerir locais próximos ou consultas alternativas pode melhorar a experiência do usuário quando os dados são limitados