Сервис WMS

Сервис WMS

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

Реализация протокола WMS для получение растрового изображения фрагментов карт. Протокол совместим с множеством стандартных ГИС.
Данный стандарт был разработан международной организацией OGC.
Стандарт позволяет получать:

  • изображение произвольного фрагмента карты в выбранном масштабе, проекции и составе слоёв
  • описание карты и состав слоёв в формате XML
  • текстовую информацию об объекте в точке на изображении

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

apikey (тип: string )

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

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

Выбор одного из сервисов стандарта OGC. В данном случае должно быть service=wms.

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

Идентификатор карты. Требуется для всех типов запросов.

VERSION (тип: string )

Версия стандарта WMS. Не обязательный параметр. По умолчанию VERSION=1.3.0

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

Выбор типа запроса. Варианты значений:

  • GetCapabilities Описание карты, состав слоёв и их ID в формате XML
  • GetMap Получение фрагмента карты
  • GetFeatureInfo Получение текстовую информацию об объекте в точке на изображении
  • GetStat Нестандартное значение. Возвращает статистику по растровому изображению в формате JSON.

WIDTH (тип: number )

Обязательно для запросов request=GetFeatureInfo и request=GetMap. Ширина изображения в пикселах.

HEIGHT (тип: number )

Обязательно для запросов request=GetFeatureInfo и request=GetMap. Высота изображения в пикселах.

CRS (тип: string )

Обязательно для запросов request=GetFeatureInfo и request=GetMap. Проекция в которой запрашивается карта.
CRS=namespace:identifier. По умолчанию поддерживаются 3 проекции:

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

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

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

BBOX (тип: string )

Обязательно для запросов request=GetFeatureInfo и request=GetMap.
Ограничивающий прямоугольник фрагмента запрашиваемой карты. Задаётся в географических координатах в запрошенной проекции (параметр CRS).

Формат: BBOX=minx,miny,maxx,maxy

Для проекции EPSG:4326 формат другой BBOX=minLatitude,minLongitude,maxLatitude,maxLongitude

Внимание. Если значения (maxx — maxx) и (maxy — miny) не пропорциональны WIDTH и HEIGHT, то изображение будет сжато или растянуто.
Если координаты задаются вручную, то удобно использовать параметр RATIO.

LAYERS (тип: string )

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

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

STYLES (тип: string )

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

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

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

FORMAT (тип: string )

Формат изображения для запроса request=GetMap. Необязательный. Возможные значения:

  • image/jpeg (или jpeg, jpg)
  • image/png (или png)
    Значение по умолчанию jpeg.

TRANSPARENT (тип: boolean )

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

BGCOLOR (тип: string )

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

RATIO (тип: string )

Если значение RATIO=wcoord, тогда у параметра BBOX автоматически расчитываются координаты ymin и ymax по координатам xmin,xmax и значениям параметров WIDTH HEIGHT.

QUERY_LAYERS (тип: string )

Обязательно для запроса request=GetFeatureInfo. Перечень идентификаторов слоёв в которых ищятся объекты.
Порядок слоёв указывает порядок их перебора. Идентификаторы разделены запятой.

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

INFO_FORMAT (тип: string )

Необязательно для запроса request=GetFeatureInfo. Формат в котром выдаётся информация об объекте в точке.
Сейчас поддерживает только значение INFO_FORMAT=plain/text

FEATURE_COUNT (тип: number )

Необязательно для запроса request=GetFeatureInfo. Максимальное количество объектов которые будут включаться в ответ. По умолчанию значение FEATURE_COUNT=1

I (тип: number )

Обязательно для запроса request=GetFeatureInfo. J координата(X) в пикселах проекции карты.

J (тип: number )

Обязательно для запроса request=GetFeatureInfo. J координата(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/wms?

&APIKEY=XXXYYY
&SERVICE=WMS
&MAP=ATTBP
&REQUEST=GetCapabilities

Ответ.

Статус: 200

<WMS_Capabilities xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opengis.net/wms" version="1.3.0" xsi:schemaLocation="http://www.opengis.net/wms http://schemas.opengis.net/wms/1.3.0/capabilities_1_3_0.xsd">
  <Service>
    <Name>WMS</Name>
    <Title>OPERATIVE</Title>
    <MaxWidth>2048</MaxWidth>
    <MaxHeight>2048</MaxHeight>
  </Service>
  <Capability>
    <Request>
      <GetCapabilities>
        <Format>text/xml</Format>
      </GetCapabilities>
      <GetMap>
        <Format>image/jpeg</Format>
        <Format>image/png</Format>
        <Format>image/png; mode=24bit</Format>
      </GetMap>
      <GetFeatureInfo>
        <Format>text/html</Format>
      </GetFeatureInfo>
    </Request>
  <Exception>
    <Format>XML</Format>
    <Format>BLANK</Format>
  </Exception>
  <Layer>
    <Title>OPERATIVE</Title>
    <Layer>
      <Title>Landsat 8</Title>
      <Layer queryable="1">
        <Name>ATTBP.E341475A341B47F3A7ABC3616BA48F27</Name>
        <Title>ls8_aoi</Title>
        <Abstract/>
        <CRS>EPSG:3395</CRS>
        <CRS>EPSG:4326</CRS>
        <CRS>EPSG:3857</CRS>
        <CRS>EPSG:900913</CRS>
        <EX_GeographicBoundingBox>
          <westBoundLongitude>-180</westBoundLongitude>
          <eastBoundLongitude>180</eastBoundLongitude>
          <southBoundLatitude>-18.4170787206678</southBoundLatitude>
          <northBoundLatitude>81.0932138357345</northBoundLatitude>
        </EX_GeographicBoundingBox>
        <BoundingBox CRS="EPSG:3395" minx="-20037508.3427892" miny="-2072932.57031466" maxx="20037508.3427892" maxy="16238200.477396"/>
        <BoundingBox CRS="EPSG:4326" minx="-18.4170787206678" miny="-180" maxx="81.0932138357345" maxy="180"/>
        <BoundingBox CRS="EPSG:3857" minx="-20037508.3427892" miny="-2086425.13134733" maxx="20037508.3427892" maxy="16280475.5163841"/>
        <BoundingBox CRS="EPSG:900913" minx="-20037508.3427892" miny="-2086425.13134733" maxx="20037508.3427892" maxy="16280475.5163841"/>
      </Layer>
      <Layer queryable="1">
        <Name>ATTBP.D8CFA7D3A7AA4549B728B37010C051A2</Name>
        <Title>QL_Landsat-8</Title>
        <Abstract>квиклуки и метаданные по РФ с 11.04.2013</Abstract>
        <CRS>EPSG:3395</CRS>
        <CRS>EPSG:4326</CRS>
        <CRS>EPSG:3857</CRS>
        <CRS>EPSG:900913</CRS>
        <EX_GeographicBoundingBox>
          <westBoundLongitude>-180</westBoundLongitude>
          <eastBoundLongitude>180</eastBoundLongitude>
          <southBoundLatitude>-19.8415998263168</southBoundLatitude>
          <northBoundLatitude>82.7095999601575</northBoundLatitude>
        </EX_GeographicBoundingBox>
        <BoundingBox CRS="EPSG:3395" minx="-20037508.3427892" miny="-2239779.45001751" maxx="20037508.3427892" maxy="17519532.7453421"/>
        <BoundingBox CRS="EPSG:4326" minx="-19.8415998263168" miny="-180" maxx="82.7095999601575" maxy="180"/>
        <BoundingBox CRS="EPSG:3857" minx="-20037508.3427892" miny="-2254275.66256097" maxx="20037508.3427892" maxy="17561978.5932685"/>
        <BoundingBox CRS="EPSG:900913" minx="-20037508.3427892" miny="-2254275.66256097" maxx="20037508.3427892" maxy="17561978.5932685"/>
      </Layer>
    </Layer>
  </Capability>
</WMS_Capabilities>
Пример запроса за картой в проекции EPSG:4326

Запрос

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

&MAP=ATTBP
&APIKEY=BAWUYMA7QQ
&WHERE=SCENEID='LC81740212018055LGN00'
&SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&BBOX=43.715972,55.783523,44.346313,56.051334
&CRS=EPSG:4326
&WIDTH=837
&HEIGHT=561
&LAYERS=47A9D4E5E5AE497A8A1A7EA49C7FC336,E341475A341B47F3A7ABC3616BA48F27
&FORMAT=image/png
&TRANSPARENT=true

Ответ.

Статус: 200

Изображение с Content-Type: image/png
Пример запроса за картой в проекции EPSG:4326

Запрос

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

&MAP=ATTBP
&APIKEY=BAWUYMA7QQ
&SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetFeatureInfo
&BBOX=43.715972,55.783523,44.346313,56.051334
&CRS=EPSG:4326
&WIDTH=837
&HEIGHT=561
&LAYERS=47A9D4E5E5AE497A8A1A7EA49C7FC336,E341475A341B47F3A7ABC3616BA48F27
&QUERY_LAYERS=47A9D4E5E5AE497A8A1A7EA49C7FC336
&I=12
&J=35

Ответ.

Статус: 200

<html><body><p>Колонка1</p><p>Значение1</p><p>Колонка2</p><p>Значение2</p></body><html>
Back To Top