GET/api/astro/geocode/1 crédito

Consulta de local

Converte o nome de um local nas coordenadas e no deslocamento UTC de que os outros endpoints precisam. Envie um GET com um parâmetro de consulta `address`, como 'Jaipur, India', e você recebe `latitude`, `longitude`, o `timezone_name` IANA, o `timezone_offset` em horas como número decimal, a string `address` do próprio geocodificador e o `source` que respondeu. O deslocamento já considera o horário de verão quando o provedor o informa; portanto, é o deslocamento atual do local, não necessariamente o que vigorava em uma data de nascimento no passado. Para um mapa natal, passe essas coordenadas para /api/astro/date_time/ com a data real e deixe esse endpoint resolver o deslocamento para o momento certo. `source` indica qual provedor respondeu: 'google' quando há uma chave do Google Maps configurada na implantação; caso contrário, 'nominatim', o serviço do OpenStreetMap usado como alternativa. Um local não encontrado retorna 404, e a ausência de `address` retorna 400.

https://api.occultapi.com/api/astro/geocode/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…

Parâmetros de query (1)

Vão na URL. Todos são opcionais, a menos que estejam marcados, e podem ser combinados — primeiro filtre, depois pagine, depois ordene.

Parâmetro	Tipo		Exemplo	Para que serve
address	string	obrigatório	`Jaipur, Rajasthan, India`	Nome da cidade/local a pesquisar Nome do local a consultar. Texto livre - uma cidade geralmente basta; acrescente o estado ou o país para evitar ambiguidade.

Exemplo de requisição

curl "https://api.occultapi.com/api/astro/geocode/?address=Jaipur" \
  -H "X-API-Key: $OCCULT_API_KEY"

Resposta

{
  "address": "Jaipur, Rajasthan, India",
  "latitude": 26.9124336,
  "longitude": 75.7872709,
  "timezone_name": "Asia/Calcutta",
  "timezone_offset": 5.5,
  "source": "google"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.