Перетворює годинниковий час народження й пару координат на однозначний момент. Усі інші ендпоінти потребують або мітки часу з часовим поясом, або числового зміщення від UTC, а помилка тут — найчастіша причина того, що карта непомітно зсувається на годину чи на день. Тож зазвичай із цього виклику й починають.
Надішліть `date`, `time`, `latitude` і `longitude`. За координатами визначається часовий пояс IANA, дата й час без поясу інтерпретуються в цьому поясі, і ви отримуєте `input_datetime`, назву визначеного поясу `timezone`, `localized_datetime` зі зміщенням і `utc_datetime`. Локалізоване значення можна одразу передавати в `date_time` на інших ендпоінтах.
Одне застереження: поле запиту називається `use_LMT`, але обробник зчитує поле з іншим написанням, тож місцевий середній час фактично ніколи не застосовується і завжди використовується пояс IANA — `use_lmt` у відповіді завжди false. Для народжень до запровадження стандартного часу в цій місцевості обчисліть зміщення місцевого середнього часу самостійно (чотири хвилини на градус довготи), а не покладайтеся на цей прапорець.
Поля запиту
Поле
Тип
Обов’язкове
Примітки
date
string (date)
обов’язковий
Обмеження ФОРМАТУ, а не перелік значень. DRF DateField із типовими форматами введення = лише ISO-8601: 'YYYY-MM-DD'.
latitude
number (double)
обов’язковий
Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси.
min -180 · max 180
longitude
number (double)
обов’язковий
Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї.
min -180 · max 180
time
string (time)
обов’язковий
Обмеження ФОРМАТУ, а не перелік значень. DRF TimeField із типовими форматами введення = лише ISO-8601: 'HH:MM', 'HH:MM:SS' або 'HH:MM:SS.ffffff'. Зразкове значення "string" у каталозі вводить в оману.