À partir d’une heure de naissance en heure locale et d’une paire de coordonnées, détermine un instant sans ambiguïté. Tous les autres endpoints attendent soit un horodatage avec fuseau, soit un décalage UTC numérique, et une erreur à ce niveau est la cause la plus fréquente d’un thème décalé d’une heure ou d’un jour sans que rien ne le signale : c’est donc en général le premier appel à faire.
Envoyez `date`, `time`, `latitude` et `longitude`. Les coordonnées sont converties en fuseau horaire IANA, la date et l’heure naïves sont interprétées dans ce fuseau, et vous recevez `input_datetime`, le nom du fuseau trouvé `timezone`, `localized_datetime` avec son décalage, et `utc_datetime`. La valeur localisée peut être passée telle quelle dans `date_time` sur les autres endpoints.
Une réserve : le champ de la requête s’écrit `use_LMT`, mais la vue lit un nom orthographié autrement. Le temps moyen local n’est donc jamais appliqué et le fuseau IANA est toujours utilisé — `use_lmt` vaut toujours false dans la réponse. Pour une naissance antérieure à l’adoption locale de l’heure légale, calculez vous-même le décalage du temps moyen local (quatre minutes par degré de longitude) au lieu de compter sur cet indicateur.
Champs de la requête
Champ
Type
Obligatoire
Remarques
date
string (date)
obligatoire
Contrainte de FORMAT, pas une énumération. DateField DRF avec les formats d’entrée par défaut = ISO-8601 uniquement : 'YYYY-MM-DD'.
latitude
number (double)
obligatoire
Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord.
min -180 · max 180
longitude
number (double)
obligatoire
Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine.
min -180 · max 180
time
string (time)
obligatoire
Contrainte de FORMAT, pas une énumération. TimeField DRF avec les formats d’entrée par défaut = ISO-8601 uniquement : 'HH:MM', 'HH:MM:SS' ou 'HH:MM:SS.ffffff'. La valeur d’exemple du catalogue "string" est trompeuse.