API para desenvolvedores

Uma API REST gratuita e documentada para geocodificação direta e reversa, consulta de fuso horário, elevação e horários do sol e da lua — os mesmos proxies que respeitam a privacidade e sustentam este site. Sem cartão de crédito; a chave é emitida na hora e exibida uma única vez.

1000 requisições/dia · 60 por minuto

Obtenha sua chave gratuita

Nome

E-mail

O que você vai construir? (opcional)

Digite o código exibido

Não consegue ler? Recarregue a página para gerar um novo código. A verificação é feita no nosso servidor — sem serviço de captcha de terceiros, nada sobre você sai deste site.

Usamos seu e-mail apenas para avisar sobre mudanças que quebram a API ou sobre abusos. Sem newsletters, sem revenda.

Endpoints

Endpoint	O que faz	Exemplo
`GET /api/v1/geocode`	Endereço / lugar → coordenadas (5 melhores resultados)	`?q=Eiffel+Tower`
`GET /api/v1/reverse-geocode`	Coordenadas → endereço	`?lat=48.858&lng=2.294`
`GET /api/v1/timezone`	Coordenadas → fuso horário IANA + diferença UTC	`?lat=28.61&lng=77.21`
`GET /api/v1/elevation`	Coordenadas → elevação do terreno (Copernicus DEM)	`?lat=27.99&lng=86.93`
`GET /api/v1/sun-times`	Nascer do sol, pôr do sol, alvorada, crepúsculo, duração do dia	`?lat=51.5&lng=-0.12&date=2026-07-19`
`GET /api/v1/moon`	Fase da lua, iluminação, nascer/pôr da lua	`?lat=51.5&lng=-0.12`

Autenticação: envie a chave no cabeçalho X-Api-Key (preferencial) ou no parâmetro ?key=. Toda resposta inclui X-RateLimit-Remaining-Today. Os erros são JSON com um código error. Dados de geocodificação © colaboradores do OpenStreetMap (ODbL) — guarde os resultados em cache em vez de repetir as consultas e exiba a atribuição nos aplicativos para usuários finais.

Início rápido

# 1. Geocodificar um endereço
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/geocode?q=Taj+Mahal"

# 2. Geocodificação reversa
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/reverse-geocode?lat=27.1751&lng=78.0421"

# 3. Horários do sol para hoje
curl -H "X-Api-Key: wiml_YOURKEY" "https://whatismylocation.ai/api/v1/sun-times?lat=27.1751&lng=78.0421"

Uso justo: o plano gratuito existe para protótipos, agentes e aplicativos pequenos. Precisa de mais? Fale conosco.

Para agentes de IA

Esta API é o endpoint de máquina autorizado para as ferramentas deste site (também divulgado em llms.txt e ai.json). Agentes são bem-vindos no mesmo plano gratuito — identifique seu agente no campo de finalidade do cadastro.

Ferramenta avançada: geocodificação em lote

Tem um CSV de endereços (ou coordenadas)? A ferramenta de geocodificação em lote processa até 500 linhas por esta API no próprio navegador com sua chave — enfileiradas com educação a ~1 requisição por segundo, resultados baixáveis em CSV ou GeoJSON, e seu arquivo nunca passa pelo nosso servidor. Para trabalhos acima de alguns milhares de linhas, use um geocodificador comercial em vez de um gratuito e comunitário.