Сервис определяет часовой пояс и смещение UTC для любой точки на земле.
| Параметр | Тип | По умолчанию | Описание | Пример |
|---|---|---|---|---|
q |
string | — | Координаты точки в формате lat,lon. |
q=55.479205,37.32733 |
lang |
2-char | locale | Язык ответа. | lang=ru |
timestamp |
integer/string | текущее время | Временная метка UTC (Unix timestamp или ISO 8601), для которой вычисляются параметры таймзоны. Влияет на корректность летнего/зимнего времени. | timestamp=1718098869 |
| Поле | Тип | Описание |
|---|---|---|
request |
string | Строка исходного запроса |
results |
array | Массив с одним элементом |
Элемент results[0]:
| Поле | Тип | Описание | Пример |
|---|---|---|---|
tzid |
string | Идентификатор часового пояса в формате IANA tz database | "Europe/Moscow" |
tzname_full |
string | Полное название часового пояса | "Moscow Standard Time" |
tzname_short |
string | Короткое обозначение | "MSK" |
utc_delta |
integer | Смещение от UTC в секундах | 10800 (+3:00) |
Запрос:
/api/timezone?q=55.479205,37.32733
Ответ:
{
"request": "/api/timezone?q=55.479205,37.32733",
"results": [
{
"tzid": "Europe/Moscow",
"tzname_full": "",
"tzname_short": "MSK",
"utc_delta": 10800
}
]
}
Запрос:
/api/timezone?q=55.479205,37.32733×tamp=1718098869
Подсказка. Смещение
utc_delta=10800означает UTC+3 (3 × 3600 = 10800 секунд).
{
"openapi": "3.0.0",
"info": {
"title": "Геокодер — Timezone API",
"version": "5.0.0"
},
"paths": {
"/api/timezone": {
"get": {
"summary": "Часовой пояс (v1)",
"description": "Определяет часовой пояс и смещение UTC для заданных координат.",
"tags": ["Timezone"],
"parameters": [
{
"name": "q",
"in": "query",
"description": "Координаты точки в формате lat,lon",
"schema": { "type": "string", "example": "55.479205,37.32733" }
},
{
"name": "lang",
"in": "query",
"description": "Язык ответа",
"schema": { "type": "string", "example": "ru" }
},
{
"name": "timestamp",
"in": "query",
"description": "Временная метка UTC (Unix timestamp). Если не указана — используется текущее время.",
"schema": { "type": "integer", "example": 1718098869 }
}
],
"responses": {
"200": {
"description": "Информация о часовом поясе",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"request": { "type": "string" },
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tzid": {
"type": "string",
"description": "Идентификатор часового пояса (IANA)",
"example": "Europe/Moscow"
},
"tzname_full": {
"type": "string",
"description": "Полное название часового пояса"
},
"tzname_short": {
"type": "string",
"description": "Короткое обозначение",
"example": "MSK"
},
"utc_delta": {
"type": "integer",
"description": "Смещение от UTC в секундах",
"example": 10800
}
}
}
}
}
},
"example": {
"request": "/api/timezone?q=55.479205,37.32733",
"results": [
{
"tzid": "Europe/Moscow",
"tzname_full": "",
"tzname_short": "MSK",
"utc_delta": 10800
}
]
}
}
}
},
"400": { "description": "Некорректный запрос" }
}
}
},
"/api/timezone": {
"get": {
"summary": "Часовой пояс (v5)",
"description": "Актуальная версия определения часового пояса.",
"tags": ["Timezone"],
"parameters": [
{
"name": "q",
"in": "query",
"schema": { "type": "string", "example": "55.479205,37.32733" }
},
{
"name": "lang",
"in": "query",
"schema": { "type": "string" }
},
{
"name": "timestamp",
"in": "query",
"schema": { "type": "integer" }
}
],
"responses": {
"200": { "description": "Информация о часовом поясе" },
"400": { "description": "Некорректный запрос" }
}
}
}
}
}