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.
Parâmetros de query (1)
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.