Сервис растровых тайлов

Сервис растровых тайлов

Метод: GET http://maps.kosmosnimki.ru/rest/ver1/service/tile

Получение растровых тайлов размером 256×256 пикселей в форматах jpeg и png.

Весь мир для такого сервиса

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

apikey (тип: string )

Ключ авторизации. Является обязательным для работы с сайтом maps.kosmosnimki.ru. Не требуется для индивидульных (корпоративных) инсталляций ПО Гемиксера.
Для получения ключа воспользуйтесь личным кабинетом.

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

Идентификатор карты.

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

Должен быть REQUEST=GetTile

LAYERS (тип: string )

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

Формат: LAYERS=layerid1,layerid2,layerid3

STYLES (тип: string )

Необязательный параметр. Перечень идентификаторов стилей которые нужно применить к слоям. Порядок стилей соответсвует порядку слоёв в параметре LAYERS.
Идентификаторы стилей разделены запятой. Если стиль не указан используется стиль по умолчанию из карты. Стили для некоторых слоёв можно пропускать, чтобы использовать стили по умолчанию.

Пример с пропуском: STYLES=styleId1,,,style2

Пример задаёт стиль только для второго слоя: STYLES=,style2

X (тип: string )

Номер тайла по оси X

Y (тип: string )

Номер тайла по оси Y

Z (тип: string )

Номер масштабного уровня. На Z=0 весь мир помещается на одном тайле 256×256 пикслей с X=0, Y=0. На Z=1 весь мир на 4 тайлах. На Z=2 на 8 тайлах и так далее.

SRS (тип: string )

Проекция в которой запрашивается карта.
CRS=namespace:identifier. Поддерживаются 3 проекции:

EPSG:3395 — проекция Меркатора

EPSG:3857 — проекция сферический Меркатор

EPSG:4326 — проекция WGS84 (долгота/широта)

Значение по умолчанию SRS=EPSG:3857

FORMAT (тип: string )

Формат изображения. Возможные значения:

  • image/jpeg (или jpeg, jpg)
  • image/png (или png)
    По умолчанию формат подбирается сервером в зависимости от тайлов которые будут составлять запрошеный тайл.
    Прдепочтение отдаётся формату jpeg, однако если избражение состоит только из растровых слоёв в формате PNG, то запрос выдаст тайл в PNG формате.

TRANSPARENT (тип: boolean )

Значение TRUE для FORMAT=png означает сделать прозрачный фон для карты. Формат jpeg не поддерживает прозрачность.
По умолчанию значение FALSE, т.е фон не прозрачный.

BGCOLOR (тип: string )

Цвет фона для не прозрачных изображений. Значение указывается в формате BGCOLOR=0xRRGGBB, где RR — шестнадцетиричное представление компнонента.
RR — красный, GG — зелёный, BB — синий. По умолчанию BGCOLOR=0xFFFFFF

NearestNeighbor (тип: boolean )

Если значение NearestNeighbor=TRUE, то используется алгоритм NearestNeighbor при масштабировании изображений.
При таком алгоритме результирующее изображение состоит только из цветов пикселей исходного изображения, но изображение выглядит менее естественно.
В потивном случае используется алгоритм бикубической интерполяции, исходные цвета интерполируются.

Значение по умолчанию NearestNeighbor=FALSE.

FTC (тип: string )

Направление осей координат для тайлов.

По умолчанию тайлы по осям X и Y отсчитываются с верхнего левого угла. Там тайл будет иметь X=0, Y=0.
Ось X направлена вправо, а ось Y вниз. Номера тайлов всегда будут >= 0. Такая система принята в сервисе OpenStreetMap и других подобных.
Если значение FTC=gmx, то отсчёт тайлов будет вестись с середины карты, с географических координат (0,0). Ось X направлена вправо, а ось Y вверх. Влево и вниз номера тайлов по осям будут отрицательными.

StartDate (тип: string )

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

EndDate (тип: string )

Для мультивременных слоёв участвующих в запросе указывает конечный диапазон даты
На карту попадают только объекты дата которых StartDate <= дата < EndDate.

Формат даты задаётся dd.mm.yyyy HH:MM:SS

Например 31.12.2012 12:59:12

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

daysOffset (тип: number )

Для мультивременных слоёв участвующих в запросе указывает относительный диапазон дат. Начальная дата диапазона отсчитывается от текущего дня минус указанное количество дней.
Конечная дата диапазона равна 23:59:59 сегодняшего числа.

hoursOffset (тип: number )

Для мультивременных слоёв участвующих в запросе указывает относительный диапазон дат.
Начальная дата диапазона отсчитывается от текущего времени минус указанное количество часов.
Конечная дата диапазона равна текущей дате-времени.

secondsOffset (тип: number )

Для мультивременных слоёв участвующих в запросе указывает относительный диапазон дат.
Начальная дата диапазона отсчитывается от текущего времени минус указанное количество секунд.
Конечная дата диапазона равна текущей дате-времени.

WHERE (тип: string )

Для мультивременных каталогов растров указывает условие для выборки. При этом ограничение по времени (StartDate/EndDate) будут игнорироваться.
Условие (фильтр) задаётся в синтаксисе SQL. В "таких" кавычках, [таких] или без кавычек указываются колонки. В 'одинарных' кавычках указываются строковые константы.

Пример условия WHERE="ColumnName"='string constant'

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

Пример запроса за описанием карты и слоёв.

Запрос

http://maps.kosmosnimki.ru/rest/ver1/service/tile?

&map=ATTBP
&request=getTile
&apikey=BWWUYMA7Q
&where=SCENEID='LC81740212018055LGN00'
&layers=47A9D4E5E5AE497A8A1A7EA49C7FC336
&srs=EPSG:3857
&z=8
&x=1
&y=5

Ответ.

Статус: 200

Изображение в формате jpeg
Back To Top