Поиск и выборка из векторного слоя

Поиск и выборка из векторного слоя

Метод: GET http://maps.kosmosnimki.ru/rest/ver1/layers/{Id}/search

Выборка из таблицы векторного слоя. Позволяет запрашивать атрибуты и геометрию векторного слоя. Возможно применение различных фильтров и ограничений.
Формат ответа geoJSON.

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

apikey (тип: string )

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

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

Идентификатор слоя

query (тип: string )

Выражение фильтр для запроса. Если параметр пустой или отсутсвует, то возвращаются все записи.
Как писать выражение для фильтора, можно прочитать в разделе «Geomixer SQL».

columns (тип: string )

Перечень колонок для выборки в формате JSON. Если параметр не указан, то возвращаются все колонки.
Value — значение выражения для колонки, обычно название колонки в квадратных скобках.
Alias — псевдоним колонки, будет использоваться как заголовок в таблице результатов, по умолчанию совпадает с реальным названием колонки.

Пример с различными вариантами:

columns=[{"Value":"[ColumnName]"},{"Value":"10 + [IntegerColumnName]"}, {"Value":"[tableName].[ColumnName]"}, {"Value":"column2", "Alias":"название для ответа"}]

orderby (тип: string )

Название столбца для сортировки результата

orderdirection (тип: string )

Порядок сортировки. Возможные значения:

  • asc (от меньшего к большему)
  • desc (от большего к меньшему)

skiprecords (тип: integer )

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

limitrecords (тип: integer )

Максимальное количество объектов в результате. в любом случае сервер вернет не более 1000 объектов. Используется для постраничного отображения.

out_cs (тип: string )

Cистемы координат, используемая для геометрий в ответе на этот запрос, возможные значения: EPSG:4326, EPSG:3395, EPSG:3857
По умолчанию EPSG:4326.
Подробнее о проекциях читать здесь

count (тип: boolean )

Позволяет возвращать только количество записей, подпавшых под условия.
Возможные значения: true | false (по умолчанию).
Определяют, что вернет запрос: только количество объектов в выборке (true) или же сами объекты (false).

border (тип: string )

Геометрия в формате GeoJson, ограничивающая область поиска. В ответ попадут только те записи, геометрия которых находится внутри или пересекается с данной.

border_cs (тип: string )

Система координат параметра border, возможные значения: EPSG:4326 (по умолчанию), EPSG:3395, EPSG:3857
Подробнее о проекциях читать здесь

BorderFromLayer (тип: string )

Альтернативный способ указать геометрию параметра border.
Вместо указания непосредственно геометрии указывается ссылка на объект в каком-то векторном слое.

BorderFromLayer — идентификатор векторного или растрового слоя геометрия которого будет использоваться фильтром.
Для растрового слоя это будет его граница, а для векторного слоя требуется указать следующий параметр BorderId.

BorderId (тип: integer )

Идентификатор объекта векторного слоя, геометрия которого будет использоваться в качестве фильтра. Смотри параметр BorderFromLayer.

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

Запрос

http://maps.kosmosnimki.ru/rest/ver1/layers/04DDB23F49F84B9A9122CBA6BC26D3ED/search?

&apikey=apikey

Ответ.

Статус: 200

{

  "type" 
Тип геометрии или набор записей

: "FeatureCollection",
  "features" 
Массив записей

: [

    {

      "type" 
Тип геометрии

: "Feature",
      "geometry" 
Геометрия записи

: {

        "type" 
Тип геометрии или набор записей

: "Polygon",
        "coordinates" 
Массив с координатами

: [

          [

            [

              76.99669,
              49.64524
            ],
            [

              77.67816,
              51.35141
            ],
            [

              80.31811,
              50.89258
            ],
            [

              79.54662,
              49.19359
            ],
            [

              76.99669,
              49.64524
            ]
          ]
        ]
      },
      "properties" 
Набор атрибутов объекта.

: {

        "ogc_fid": 2,
        "SCENEID": "LC81500252013273LGN00",
        "PLATFORM": "LANDSAT8",
        "SENSOR": "OLI_TIRS",
        "BANDS": "6-5-4",
        "CLOUDS": 1,
        "ACQDATE": "2013-09-30",
        "ACQTIME": "05:39:12",
        "Delay": "178:20",
        "Station": null,
        "PATH": 150,
        "ROW": 25,
        "SUNELEV": 35.6864,
        "SUNAZIM": 162.7,
        "GMX_RasterCatalogID": "RC04DDB23F49F84B9A9122CBA6BC26D3ED:2",
        "tiles": "/13/09/",
        "IsDay": true,
        "FILENAME": null
      }
    },
    {

      "type" 
Тип геометрии

: "Feature",
      "geometry" 
Геометрия записи

: {

        "type" 
Тип геометрии или набор записей

: "Polygon",
        "coordinates" 
Массив с координатами

: [

          [

            [

              77.55967,
              51.0632
            ],
            [

              78.27551,
              52.76651
            ],
            [

              80.99591,
              52.29758
            ],
            [

              80.18321,
              50.6025
            ],
            [

              77.55967,
              51.0632
            ]
          ]
        ]
      },
      "properties" 
Набор атрибутов объекта.

: {

        "ogc_fid": 3,
        "SCENEID": "LC81500242013273LGN00",
        "PLATFORM": "LANDSAT8",
        "SENSOR": "OLI_TIRS",
        "BANDS": "6-5-4",
        "CLOUDS": 1,
        "ACQDATE": "2013-09-30",
        "ACQTIME": "05:38:48",
        "Delay": "178:43",
        "Station": null,
        "PATH": 150,
        "ROW": 24,
        "SUNELEV": 34.4282,
        "SUNAZIM": 163.61,
        "GMX_RasterCatalogID": "RC04DDB23F49F84B9A9122CBA6BC26D3ED:3",
        "tiles": "/13/09/",
        "IsDay": true,
        "FILENAME": null
      }
    }
  ]
}

Back To Top