Esta API permite obter informações geográficas estruturadas com base no nome de uma cidade fornecido como entrada. Quando uma solicitação é feita com o nome de uma cidade, a API responde com um conjunto de dados detalhados no formato JSON. A estrutura da resposta inclui um objeto representando a cidade consultada e contém vários atributos úteis para geolocalização ou análise geográfica.
O objeto principal contém um identificador único chamado geo_id, que representa de forma exclusiva essa cidade no sistema. Ele também inclui o nome da cidade (name), juntamente com a subdivisão administrativa correspondente, que pode ser um estado, região ou distrito, e é representado no campo state_or_region. Além disso, informações detalhadas sobre o país ao qual a cidade pertence são fornecidas por meio de um objeto aninhado dentro da propriedade country, que inclui o código do país em formato ISO (code) e o nome completo do país (name).
Geograficamente, a resposta contém as coordenadas exatas da cidade, expressas em dois campos: latitude e longitude. Esses valores permitem que a cidade seja localizada com precisão em mapas ou integrada a sistemas de informações geográficas (SIG), serviços de mapas, aplicativos móveis com geolocalização, entre outros.
A estrutura da resposta é projetada para ser de fácil interpretação e consumo por aplicativos da web, aplicativos móveis ou serviços de backend que precisam traduzir um nome de cidade em coordenadas ou informações geográficas padronizadas. Também é útil para tarefas como validação de localização, análise de cobertura, visualização de dados em mapas, ou simplesmente para obter dados básicos sobre uma localização.
Em resumo, esta API facilita a conversão de nomes de cidades em informações geográficas completas, padronizadas e precisas que podem ser facilmente integradas em diferentes tipos de aplicativos ou fluxos de dados que dependem de localizações geográficas.
Retorna informações geográficas detalhadas como país, região e coordenadas com base no nome de uma cidade fornecido 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'
| 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.
A API retorna informações geográficas estruturadas para uma cidade específica, incluindo seu nome, região administrativa, detalhes do país e coordenadas precisas (latitude e longitude) em formato JSON
Os campos principais na resposta incluem `geo_id` (identificador único da cidade), `name` (nome da cidade), `state_or_region` (subdivisão administrativa), `country` (objeto aninhado com `code` e `name`), `latitude` e `longitude`
A resposta é estruturada como um array de objetos, cada um representando uma cidade. Cada objeto contém campos para detalhes geográficos e administrativos, facilitando a análise e utilização em aplicações
A API fornece informações sobre nomes de cidades, coordenadas geográficas, regiões administrativas e detalhes de países, permitindo que os usuários obtenham dados abrangentes sobre locais para diversas aplicações
Os usuários podem personalizar solicitações especificando o nome da cidade como um parâmetro na solicitação GET A API retornará dados para o nome da cidade exato fornecido permitindo consultas direcionadas
Casos de uso típicos incluem serviços de geolocalização, aplicativos de mapeamento, validação de localização, visualização de dados e análise geográfica onde informações precisas sobre a cidade são essenciais
A precisão dos dados é mantida por meio de atualizações regulares e validação contra bancos de dados geográficos confiáveis garantindo que as informações fornecidas sejam atuais e precisas
Se a API retornar resultados parciais ou vazios os usuários devem verificar o nome da cidade para precisão ou considerar nomes ou grafias alternativas Implementar tratamento de erros em aplicativos também pode gerenciar tais cenários de maneira eficaz
Nível de serviço:
100%
Tempo de resposta:
80ms
Nível de serviço:
100%
Tempo de resposta:
250ms
Nível de serviço:
50%
Tempo de resposta:
176ms
Nível de serviço:
100%
Tempo de resposta:
1.614ms
Nível de serviço:
100%
Tempo de resposta:
58ms
Nível de serviço:
100%
Tempo de resposta:
264ms
Nível de serviço:
100%
Tempo de resposta:
223ms
Nível de serviço:
100%
Tempo de resposta:
2.224ms
Nível de serviço:
100%
Tempo de resposta:
62ms
Nível de serviço:
100%
Tempo de resposta:
105ms