Transforma uma hora de nascimento no horário do relógio local e um par de coordenadas em um instante sem ambiguidade. Todos os outros endpoints desta API exigem um timestamp com fuso horário ou um deslocamento UTC numérico, e um erro aqui é a causa mais comum de mapas que saem, sem nenhum aviso, uma hora ou um dia fora. Por isso, esta costuma ser a primeira chamada que você faz.
Envie `date`, `time`, `latitude` e `longitude`. As coordenadas são convertidas em um fuso horário IANA, a data e a hora sem fuso são lidas nesse fuso, e você recebe `input_datetime`, o nome do fuso resolvido em `timezone`, `localized_datetime` com o deslocamento incluído e `utc_datetime`. Passe o valor localizado direto para `date_time` nos outros endpoints.
Uma ressalva: o campo da requisição se escreve `use_LMT`, mas a view lê um nome com outra grafia, então a hora média local nunca é aplicada de fato e o fuso IANA é sempre usado — `use_lmt` na resposta é sempre false. Para nascimentos anteriores à adoção local da hora padrão, calcule você mesmo o deslocamento da hora média local (quatro minutos por grau de longitude), em vez de depender desta flag.
Campos da requisição
Campo
Tipo
Obrigatório
Observações
date
string (date)
obrigatório
Restrição de FORMATO, não um enum. DRF DateField com formatos de entrada padrão = apenas ISO-8601: 'YYYY-MM-DD'.
latitude
number (double)
obrigatório
Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes.
min -180 · max 180
longitude
number (double)
obrigatório
Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China.
min -180 · max 180
time
string (time)
obrigatório
Restrição de FORMATO, não um enum. DRF TimeField com formatos de entrada padrão = apenas ISO-8601: 'HH:MM', 'HH:MM:SS' ou 'HH:MM:SS.ffffff'. O valor de exemplo do catálogo, "string", é enganoso.