Pular para o conteúdo
POST AI agent ready /v1/geo/reverse

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

Envie um par de latitude e longitude e receba o endereço, cidade, país e nome de exibição correspondentes. Desenvolvido pelo serviço OpenStreetMap Nominatim. Útil para converter coordenadas GPS de dispositivos, dados EXIF ​​de fotos ou cliques em mapas em locais legíveis.

Parameters

numberrequired

Latitude in decimal degrees (-90 to 90).

numberrequired

Longitude in decimal degrees (-180 to 180).

Code examples

curl -X POST https://api.botoi.com/v1/geo/reverse \
  -H "Content-Type: application/json" \
  -d '{"lat":37.4224,"lng":-122.0842}'

When to use this API

Exibir um endereço legível quando os usuários colocarem um alfinete em um mapa

Quando um usuário toca em um local em seu mapa, envie as coordenadas para esse ponto final e mostre o endereço em uma dica de ferramenta ou barra lateral. Evita que os usuários tenham que digitar o endereço manualmente.

Marque fotos com nomes de locais de dados EXIF ​​​​GPS

Extraia lat/lng de metadados EXIF ​​de fotos e geocodifique-os reversamente. Exiba "Tirada em Mountain View, Califórnia" em vez de coordenadas brutas em sua galeria de fotos.

Enriqueça os dados de rastreamento de frota com endereços

Converta coordenadas GPS de rastreadores de veículos em endereços para registros de despacho, confirmações de entrega e relatórios de rota.

Frequently asked questions

Que dados a resposta inclui?
A resposta inclui o display_name completo (endereço), um campo de endereço mais curto, cidade, país e a lat/lng original. O nível de detalhe depende da cobertura do OpenStreetMap para o local.
O que acontece se as coordenadas estiverem no oceano ou em uma área não mapeada?
A API retorna um erro 404 NOT_FOUND se o Nominatim não conseguir encontrar um endereço para as coordenadas fornecidas. Oceano aberto, áreas selvagens remotas e Antártica podem não ter dados de endereço.
Quão precisos são os resultados?
A precisão depende da densidade de dados do OpenStreetMap para a área. Nas cidades, você normalmente obtém precisão no nível do edifício. Nas áreas rurais, os resultados podem ser direcionados para a estrada ou aldeia mais próxima.
Posso geocodificar inversamente múltiplas coordenadas em uma solicitação?
Não. Cada solicitação trata um único par de coordenadas. Para processamento em lote, faça solicitações paralelas. Respeite o limite de taxa do Nominatim de 1 solicitação/segundo para acesso anônimo.
Este endpoint é gratuito?
Sim. O acesso anônimo permite 5 solicitações por minuto. Uma chave de API aumenta o limite de taxa com base no nível do seu plano. Não há cobranças por solicitação.

Get your API key

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

Sign up free View full docs