Список векторных тайлов по области

Метод: POST http://maps.kosmosnimki.ru/rest/ver1/layers/TilesByBbox

В запросе указывается список слоёв, координаты области видимости карты и масштаб. В ответ возвращается список координат векторных тайлов покрывающих область интереса.

Запрос может работать без указания АПИ-ключа и без авторизации. В этом случае права доступа к слоям будут от имени анонимного пользователя.

Параметры запроса

apikey (тип: string )

Api ключ для авторизации. Вместо ключа могут использоваться куки или другие методы авторизации. Об авторизации.

bbox (тип: string )

Координаты области просмотра карты в формате JSON: [minX, minY, maxX, maxY]

bboxes (тип: string )

Координаты области просмотра карты в формате JSON в виде массива: [[minX, minY, maxX, maxY], [minX, minY, maxX, maxY]]

zoom (тип: integer , обязательный параметр)

Масштаб карты в виде номера zoom.

srs (тип: integer )

Система координат карты. Возможные значения: 3395 и 3857. Параметр bbox должен быть указан в данной системе координат.

Не обязательный параметр.

dInterval (тип: string )

Для мультивременных слоёв указывает временной период за который требуется указать список тайлов. Данный параметр действует для всех мультивременных слоёв в запросе, если для них не указан отдельное значение.
Передаётся в виде JSON массива:

[minUnixtimestamp, maxUnixtimestamp]

Оба значения в массиве указывают время в формате unixtimestamp: число секунд с 01.01.1970.

layers (тип: string , обязательный параметр)

Список запрашиваемых слоёв в формате массива JSON.

[{"name": "id_layer1"}, {"name": "id_layer2"}]

Дополнительно могут указываться уточняющие параметры для отдельного слоя:

[{"name": "id_layer1", "dInterval":[minUnixtimestamp, maxUnixtimestamp]}, {"name": "id_layer2"}]

Свойство dInterval в списке слоёв перекрывает значение dInterval указанное для всего запроса.

Примеры ответов сервера

Простой запрос.

Запрос

http://maps.kosmosnimki.ru/rest/ver1/layers/TilesByBbox?
&apikey=apikey
&zoom=5
&layers=[{"name":"131313417B944DA8BDA41B782550E66A"},{"name":"8239B3CE5DA74406AE92E68A39C2EF81"}]
&bbox=[0,0,20000000,20000000]

Ответ.

Статус: 200

{

  "tiles" Перечень информации о тайлах запрошенных слоёв
: [

    {

      "name" ID векторного слоя
: "131313417B944DA8BDA41B782550E66A",
      "order" Что и в каком порядке входит в массив coords.

Возможные значения:

X Координата X тайла
Y Координата Y тайла
Z Координата Z тайла
V Номер версии тайла
Level Для мультивременных слоёв размерность разбивки по дням
Span Временной период разбивки по дням

: [

        "X",
        "Y",
        "Z",
        "V"
      ],
      "coords" Перечень координат тайлов. Координаты идут для всех тайлов подряд, без разделителей.
: [

        0,
        0,
        3,
        5,
        1,
        0,
        3,
        5,
        0,
        1,
        3,
        5,
        1,
        1,
        3,
        5,
        2,
        0,
        3,
        5,
        3,
        0,
        3,
        5,
        2,
        1,
        3,
        5,
        3,
        1,
        3,
        5,
        0,
        1,
        2,
        5,
        1,
        1,
        2,
        5
      ]
    },
    {

      "name" ID векторного слоя
: "8239B3CE5DA74406AE92E68A39C2EF81",
      "order" Что и в каком порядке входит в массив coords.

Возможные значения:

X Координата X тайла
Y Координата Y тайла
Z Координата Z тайла
V Номер версии тайла
Level Для мультивременных слоёв размерность разбивки по дням
Span Временной период разбивки по дням

: [

        "X",
        "Y",
        "Z",
        "V"
      ],
      "coords" Перечень координат тайлов. Координаты идут для всех тайлов подряд, без разделителей.
: [

        0,
        0,
        1,
        19
      ]
    }
  ]
}