{
"mode": "forward",
"query": {
"q": "Eiffel Tower",
"limit": 1,
"country": null
},
"count": 1,
"results": [
{
"lat": 48.8582599,
"lon": 2.2945006,
"display_name": "Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, 7th Arrondissement, Paris, Ile-de-France, Metropolitan France, 75007, France",
"name": "Eiffel Tower",
"category": "man_made",
"type": "tower",
"address": {
"house_number": "5",
"road": "Avenue Anatole France",
"postcode": "75007",
"city": "Paris",
"county": null,
"state": "Ile-de-France",
"country": "France",
"country_code": "FR"
},
"bbox": [
48.8574753,
48.8590453,
2.2933119,
2.2956897
],
"importance": 0.621
}
],
"sources": [
{
"name": "Open geographic data",
"license": "ODbL 1.0"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14582/geocoding+and+reverse+geocoding+api/37362/geocode?q=Eiffel Tower' --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 e Geocodificação Reversa 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.
Converter endereços e nomes de lugares em coordenadas e coordenadas de volta em endereços
O endpoint de Geocodificação retorna dados que incluem coordenadas geográficas (latitude e longitude), um endereço estruturado, nome de exibição, categoria, tipo e uma caixa delimitadora para a localização consultada
Os campos-chave na resposta incluem "lat" e "lon" para coordenadas "display_name" para o endereço completo "name" para o nome do local "category" para o tipo de lugar e "address" para componentes de endereço estruturado
Os usuários podem personalizar solicitações usando parâmetros como "q" para o endereço ou nome do lugar "limit" para especificar o número de resultados e "country" para filtrar resultados por um país específico
Os dados da resposta estão organizados em uma estrutura JSON com um "modo" indicando o tipo de consulta um objeto "consulta" detalhando os parâmetros de entrada uma "contagem" de resultados e um array de "resultados" contendo dados de localização individuais
Os dados são originados de várias bases de dados geográficas e serviços de mapeamento garantindo uma representação abrangente e precisa das localizações em todo o mundo
Casos de uso típicos incluem aplicativos de mapeamento serviços baseados em localização validação de endereços e análise geográfica permitindo que os usuários convertam endereços em coordenadas e vice-versa
Os usuários podem utilizar os dados retornados ao extrair campos específicos como coordenadas para mapeamento endereços estruturados para exibição ou caixas delimitadoras para cálculos de área em suas aplicações
Se os resultados forem parciais ou vazios os usuários devem verificar os parâmetros de entrada quanto à precisão considerar ampliar os critérios de busca ou implementar lógica de fallback para lidar com casos em que nenhuma correspondência é encontrada