Obter informações de endereço é de vital importância. Seja enviando um pacote, adaptando a experiência do usuário ao local ou usando esses dados para ajudar a localizar o idioma em um site, errar nas informações de localização pode fazer com que o usuário perca uma venda ou trave um recurso. Vamos dar uma olhada em uma API que encontrei recentemente e que me ajuda a obter todas as informações detalhadas de geolocalização de que preciso: API Geocode.
Acesso rápido
- Útil para verificar endereços, usar dados para calcular taxas de remessa e mapear
- Fornece dados detalhados, mas é muito fácil de usar
- Obtenha dados de endereço de qualquer lugar do mundo
- Suporte para implementação e integração
- 99,9% de tempo de atividade garantido
- Dos incríveis criadores do Zenserp
- Comece a usar gratuitamente!
Usando a API Geocode
Iniciar por inscrever-se gratuitamente na API Geocode!
Primeiro, observe que o senhor pode enviar a chave da API via URL ou via cabeçalho:
curl "https://app.geocodeapi.io/api/v1/search" -H "apikey: APIKEY" curl "https://app.geocodeapi.io/api/v1/search?apikey=APIKEY" curl "https://app.geocodeapi.io/api/v1/search" -F "apikey=APIKEY"
O núcleo da funcionalidade da API Geocode é executado por meio do /v1/search/ com apenas um ponto de extremidade text e a chave da API:
curl "https://app.geocodeapi.io/api/v1/search?text=Madison+WI+Capitol&apikey=APIKEY"
Em meu exemplo acima, forneço à API apenas o termo “Madison, WI Capitol”. O payload resultante é repleto de detalhes; aqui estão alguns destaques da resposta:
{
"id": "relation/7144092",
"gid": "openstreetmap:venue:relation/7144092",
"layer": "venue",
"source": "openstreetmap",
"source_id": "relation/7144092",
"name": "University of Wisconsin-Madison",
"confidence": 0.8,
"match_type": "fallback",
"accuracy": "point",
"country": "United States",
"country_a": "USA",
"region": "Wisconsin",
"region_a": "WI",
"localadmin": "Madison",
"neighbourhood": "College Hills",
"continent": "North America",
"label": "University of Wisconsin-Madison, Madison, WI, USA",
"addendum": {
"osm": {
"wikidata": "Q838330",
"wikipedia": "en:University of Wisconsin–Madison"
}
}
}
Fiquei realmente impressionado com os dados de bairro incluídos! O senhor pode até usar termos de pesquisa mais amplos, como o restaurante da minha cidade natal e meu primeiro empregador – “McFarland WI Culver’s”:
curl "https://app.geocodeapi.io/api/v1/search?text=McFarland+Culvers&apikey=APIKEY"
{
"id": "way/572463175",
"gid": "openstreetmap:venue:way/572463175",
"layer": "venue",
"source": "openstreetmap",
"source_id": "way/572463175",
"name": "Culver's",
"housenumber": "4700",
"street": "Farwell Street",
"confidence": 0.8,
"match_type": "fallback",
"accuracy": "point",
"country": "United States",
"country_gid": "whosonfirst:country:85633793",
"country_a": "USA",
"region": "Wisconsin",
"region_gid": "whosonfirst:region:85688517",
"region_a": "WI",
"localadmin": "Mcfarland",
"localadmin_gid": "whosonfirst:localadmin:404493259",
"neighbourhood": "South Central Side",
"neighbourhood_gid": "whosonfirst:neighbourhood:85878883",
"continent": "North America",
"continent_gid": "whosonfirst:continent:102191575",
"label": "Culver's, Mcfarland, WI, USA"
}
O senhor não precisa do endereço exato para obter um resultado confiável – basta fornecer um termo amigável e obterá informações precisas sobre o endereço. No caso de retornar vários locais, como “McDonalds Madison, WI”, o senhor pode limitar o tamanho do resultado:
[code shell text=McDonalds + Madison + WI + size: 10]
curl "https://app.geocodeapi.io/api/v1/search?text=McDonalds+Madison&size=10&apikey=APIKEY"
API Geocode oferece uma excelente combinação de resultados de pesquisa, detalhes de localização e personalização, além de confiança nos resultados. Os resultados fornecidos parecem uma pesquisa do Google combinada com localização.