POST AI agent ready /v1/geo/geocode

API de geocodificação - Converter endereço em coordenadas Lat/Lng

Envie uma sequência de endereço (endereço, nome da cidade, ponto de referência ou código postal) e receba a latitude, longitude, nome de exibição e tipo de local correspondentes. Desenvolvido pelo serviço OpenStreetMap Nominatim. Suporta endereços mundiais em qualquer idioma.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/geocode \
  -H "Content-Type: application/json" \
  -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA"}'

When to use this API

Converta endereços inseridos pelo usuário em marcadores de mapa no seu aplicativo

Quando um usuário digita um endereço em um formulário, geocodifique-o e coloque um marcador no mapa. Isso substitui a necessidade de uma API paga de geocodificação do Google Maps em muitos casos de uso.

Enriqueça seus registros de CRM ou banco de dados com coordenadas

Geocodifique endereços de clientes em lote para adicionar campos lat/lng. Use as coordenadas para pesquisas de proximidade, cálculos de zonas de entrega ou relatórios geográficos.

Frequently asked questions

Qual provedor de geocodificação alimenta esse endpoint?

OpenStreetMap Nomeado. Os resultados refletem a qualidade dos dados do OpenStreetMap, que é forte na maioria dos países, mas pode ser menos detalhada nas áreas rurais ou em desenvolvimento.

Este endpoint oferece suporte a endereços que não estejam em inglês?

Sim. Nominatim oferece suporte a endereços na maioria dos idiomas e scripts. Você pode enviar endereços em japonês, árabe, cirílico ou qualquer idioma suportado pelo OpenStreetMap.

O que acontece se o endereço for ambíguo ou não for encontrado?

Se nenhum resultado corresponder, a API retornará um erro 404 NOT_FOUND. Para endereços ambíguos, a API retorna a melhor correspondência. Seja o mais específico possível (inclua cidade, estado, país) para melhor precisão.

Existe um limite de taxa para solicitações de geocodificação?

O acesso anônimo permite 5 solicitações por minuto. Com uma chave API, o limite de taxa é determinado pelo seu plano. O próprio Nominatim tem uma política de 1 solicitação/segundo, que este endpoint respeita.

Posso geocodificar endereços IP com este endpoint?

Não. Este endpoint converte endereços em coordenadas. Para geolocalização de IP, use o endpoint /v1/ip/lookup.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.