API доступа к тайлам (Tiles API) представляет собой HTTP-интерфейс, который обеспечивает получение растровых изображений подложки карт Navitel
Каждый запрос API возвращает изображение одного тайла. Тайлы – это изображения размером 256 x 256 пикселей в формате PNG, на которые разбивается карта. Для создания полного изображения карты необходимо отправить запросы для получения тайлов, которые должны быть видимы на карте.
В картах Navitel поддерживаются два формата получения данных – по схемам XYZ и TMS.
Разница между XYZ и TMS заключается в том, что ось Y перевернута. Таким образом, XYZ можно преобразовать в TMS (и обратно), используя следующую формулу:
у=(2^z)-у-1
URL: https://tile[0-3].webmapapi.navitel.ru/tiles/LANG/hidpi/YOUR_API_KEY/ZOOM/X/Y.png
| Параметр | Описание | Обязательно/ Опционально | Тип | Формат данных |
|---|---|---|---|---|
| tile | Тайловый субдомен. Разные тайловые субдомены используются, если количество запросов в единицу времени превышает ограничения используемого браузера | required | string enum: [tile0, tile1, tile2, tile3] | |
| lang | Язык карты в виде двухбуквенного кода. Если этот параметр не указан, тайл будет содержать информацию на русском языке | optional | string enum: [ar, cs, da, de, el, en, es, fi, fr, he, hi, hu, id, it, ja, ko, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh] | |
| hidpi | Параметр для получения тайла в высоком разрешении. Если этот параметр не указан, будет получен тайл в обычном разрешении | optional | string enum: [hidpi] | |
| zoom | Уровень масштаба. Возможные значения: от 03 до 18 включительно, где 03 – минимальный масштаб, 18 – максимальный | required | integer enum: [03, 04…,18] | |
| х | Номер тайла по оси X | required | integer | |
| y | Номер тайла по оси Y | required | integer | |
| YOUR_API_KEY | Ключ webmap API | required | string |
URL: https://{N}.webmapapi.navitel.ru/navitms.fcgi?{type}={x},{y},{z}&hl={lang}&version=12&r={r}&s={api-key}
| Параметр | Описание | Обязательно/ Опционально | Тип | Формат данных |
|---|---|---|---|---|
| N | Тайловый субдомен. Разные тайловые субдомены используются, если количество запросов в единицу времени превышает ограничения используемого браузера | required | string enum: [tile0, tile1, tile2, tile3] | |
| type | Указывается значение, какие данные требуется получить: Возможные значения: t – тайлы, j – пробки | required | string enum: [t, j] | |
| х | Номер тайла по оси X | required | integer | 6 знаков с лидирующим нулём (нулями) |
| y | Номер тайла по оси Y | required | integer | 6 знаков с лидирующим нулём (нулями) |
| z | Уровень масштаба. Возможные значения: от 03 до 18 включительно, где 03 – минимальный масштаб, 18 – максимальный | integer enum: [03, 04…,18] | 2 знака с лидирующим нулём | |
| lang | Язык карты. Если запрашиваемый тайл не входит в карту страны, язык которой указан в запросе, тайл будет содержать информацию на английском языке | required | string enum: [ar, cs, da, de, el, en, es, fi, fr, he, hi, hu, id, it, ja, ko, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh] | |
| r | Параметр для получения тайла в высоком разрешении | optional | string enum: [@2x] | |
| api-key | Ключ webmap API | required | string |
Для вычисления номера нужного тайла можно воспользоваться скриптом:
Пример вычислений для координат Москвы широта lat = 55.755864, долгота lon = 37.617698, на уровне масштаба z=8, к результатам вычисленний функции calc(lon, lat, z) добавляем лидирующие нули:
x = 154 — "00000154",
y = 175 — "00000175",
z = 8 — "08".
В результате получаем ссылку на тайл
https://tile2.webmapapi.navitel.ru/navitms.fcgi?t=00000154,00000175,08&hl=ru&version=12&s=YOUR_API_KEY
Запрос по схеме XYZ
https://tile3.webmapapi.navitel.ru/tiles/en/hidpi/YOUR_API_KEY/15/19797/10234.png
Ответ по схеме XYZ
Запрос по схеме TMS
https://tile2.webmapapi.navitel.ru/navitms.fcgi?t=00000154,00000175,08&hl=ru&version=12&s=YOUR_API_KEY
Ответ по схеме TMS
The service provides access to tiles (Tiles API), it is an HTTP interface that allows you to obtain raster images of the background of Navitel maps.
Each API request returns an image of one tile. Tiles are 256 x 256 pixel images in PNG format into which the map is divided. To create a complete map image, you need to send requests to obtain tiles that should be visible on the map.
Navitel maps supports two data acquisition formats – XYZ and TMS schemes.
URL: https://tile[0-3].webmapapi.navitel.ru/tiles/LANG/hidpi/YOU_API_KEY/ZOOM/X/Y.png
| Parameter | Description | Required/ Optional | Data type | Data format |
|---|---|---|---|---|
| tile | Tiled subdomain. Different tile subdomains are used if the number of requests per unit of time exceeds the limitations of the browser used | required | string enum: [tile0, tile1, tile2, tile3] | |
| lang | The language of the map is in the form of a two-letter code. If this parameter is not specified, the tile will contain information in Russian | optional | string enum: [ar, cs, da, de, el, en, es, fi, fr, he, hi, hu, id, it, ja, ko, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh] | |
| hidpi | The parameter for getting a tile in high resolution. If this parameter is not specified, the tile will be received in normal resolution | optional | string enum: [@2x] | |
| zoom | Zoom level. Possible values: from 03 to 18 inclusive, where 03 is the minimum scale, 18 is the maximum | required | integer enum: [03, 04…,18] | |
| х | Tile number along the X axis | required | integer | 6 signs |
| y | Tile number along the Y axis | required | integer | 6 signs |
| YOUR_API_KEY | Webmap API key | required | string |
URL: https://{N}.webmapapi.navitel.ru/navitms.fcgi?{type}={x},{y},{z}&hl={lang}&version=12&r={r}&s={api-key}
| Parameter | Description | Required/ Optional | Data type | Data format |
|---|---|---|---|---|
| N | Tiled subdomain. Different tile subdomains are used if the number of requests per unit of time exceeds the limitations of the browser used | required | string enum: [tile0, tile1, tile2, tile3] | |
| type | The value is indicated, what data is required to be obtained: Possible values: t – tiles, j — traffic jams | required | string enum: [t, j] | |
| х | Tile number along the X axis | required | integer | 6 digits with leading zero(s) |
| y | Tile number along the Y axis | required | integer | 6 digits with leading zero(s) |
| z | Zoom level. Possible values: from 03 to 18 inclusive, where 03 is the minimum scale, 18 is the maximum | integer enum: [03, 04…,18] | 2 signs with leading zero | |
| lang | Map language. If the requested tile is not included in the map of the country whose language is specified in the request, the tile will contain information in English | required | string enum: [ar, cs, da, de, el, en, es, fi, fr, he, hi, hu, id, it, ja, ko, nl, no, pl, pt, ro, ru, sk, sv, th, tr, zh] | |
| r | Parameter for receiving a tile in high resolution | optional | string enum: [@2x] | |
| api-key | Webmap API key | required | string |
Picture is in PNG format.
To calculate the required tile number, you can use the following script:
Request XYZ
https://tile3.webmapapi.navitel.ru/tiles/en/hidpi/YOUR_API_KEY/15/19797/10234.png
Response XYZ
Request TMS
https://tile2.webmapapi.navitel.ru/navitms.fcgi?t=00000154,00000175,08&hl=ru&version=12&s=YOUR_API_KEY
Response TMS
