Создание растрового слоя

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

Данные для создания должны быть предварительно залиты на сайт.

Это асинхронный запрос. Процесс создания слоя может занять продолжительное время.

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

apikey (тип: string )

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

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

Название слоя. Максимальная длина 200 символов.

description (тип: string )

Текстовое описание слоя. Отображается в дереве слоёв рядом с названием.

copyright (тип: string )

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

legend (тип: string )

tilePathVirtual (тип: string )

Виртуальный путь к файлу на сайте. У каждого пользователя есть своя виртуальная папка.
Можно указывать путь относительно папки любого пользователя к которой есть доступ.

Пример пути c указанием папки конретного пользователя: @nicknamefolder1folder2file

Или относительно текущего пользователя: folder1folder2file

Поддерживаемые форматы

.tiles (внутренний формат geomixer)
.tiff
.jpeg/.jpg
.png
.mbtiles

Обратите внимание, что некоторые форматы состоят из нескольких файлов. В других файлах может указываться проекция и/или привязка.
Указывать надо основной растровый файл, но в том же каталоге должны находиться остальные.

metaProperties (тип: string )

Метасвойства слоя. Передаётся строкой в формате JSON.
Состоит из объекта в формате ключ-значение. Значение дополнительно содержит название типа значения.

Пример:

{
  "meta_prop_name":{"value":12,"type":"number"},
  "other_meta_prop":{"value":"string value","type":"string"}
}

Типы данных:

'number' — число, целое или с десятичной точкой
'date' — дата
'datetime' — дата и время
'time' — время. Указывается число секунд.
'string' — строка.

borderGeometry (тип: string )

Граница по которой обрезается растровый слой при отображении. Используется для того чтобы скрыть не значищие области снимка.
Граница указывается в формате GeoJson. Это должен быть полигон или мультиполигон.

Пример:

{
  "type": "Polygon",
  "coordinates": [
      [ [100.0, 0.0], [101.0, 0.0], [101.0, 1.0], [100.0, 1.0], [100.0, 0.0] ]
      ]
}

borderFileVirtual (тип: string )

Путь к векторному файлу в виртуальной директории пользователя из которого слудеут достать геометрию для обрезания растрового слоя при отображения.
Используется вместо параметра borderGeometry. Если указаны оба параметра, то используется borderGeometry.

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

Успешное создание слоя

Запрос

http://maps.kosmosnimki.ru/rest/ver1/layers/createRaster?

&apikey=apikey

&Title=tilestemp_2

&TilePath=@LayerManagerMapsDefaultMaptilestemp_2.tiles

Ответ.

Статус: 200

{

  "Status" Статус запроса.

"ok", если задача выполнена успешно
"Error", если задача выполнена с ошибкой

: "ok",
  "Result": {

    "TaskID" Идентификатор асинхронной задачи
: "29D7E94C1DFB4821B2300F8EFFD79E23",
    "Status" Статус задачи.
Варианты значений:

complited
process
error

: "complited",
    "Completed" Завершена задача или нет
: true,
    "Result" Результат выполнения задачи.
: {

      "properties" Свойства слоя
: {

        "Access" Уровень доступа текущего пользователя к данному слою.
Варианты значений:

edit - редактирование слоя и данных
editrows - редактирование данных
view - просмотр  

: "edit",
        "name" Строковый идентификатор слоя. Всегда равен свойству LayerID.
: "A9C7A97D0F2C4261B49B064B2B55A35E",
        "title" Назавание слоя
: "tilestemp_2",
        "description" Описание слоя
: "",
        "Copyright" Копирайт. Показывается в правом нижнем углу карты.
: "",
        "Owner" Ник пользователя владельца слоя. По умолчанию тот кто создал слой.
: "LayerManager",
        "MetaProperties" Метасвойства ключ-значение.
: {

        },
        "LayerVersion" Версия слоя. Каждый раз при изменении слоя версия увеличивается.
: 0,
        "LayerID" Строковый идентификатор слоя. Всегда равен свойству name.
: "A9C7A97D0F2C4261B49B064B2B55A35E",
        "type" Тип слоя. Растровый, векторный или мультислой
: "Raster",
        "date" Дата создания слоя. Формат YYYY-MM-DD
: "16.03.2017",
        "Legend" Легенда.
: "",
        "MinZoom" Минимальный зум на котором есть растровые тайлы у этого слоя. Для каталога растров или мультислоя значение минимальное для всех входящих растров.
: 0,
        "MaxZoom" Максимальный зум на котором есть растровые тайлы у этого слоя. Для каталога растров или мультислоя значение максимальное для всех входящих растров.
: 4,
        "RasterPath" Виртуальный путь к файлу по которому был создан этот слой.
: "workfolderUserFolderLayerManagerMapsDefaultMapкривой растрtilestemp_2.tiles"
      },
      "geometry" Геометрия в формате GeoJson
: {

        "type" Тип геометрии или набор записей
: "POLYGON",
        "coordinates" Массив с координатами
: [

          [

            [

              -20037508.34,
              19994875.24
            ],
            [

              -17532819.8,
              19994875.24
            ],
            [

              -12523442.71,
              19994875.24
            ],
            [

              20037508.34,
              19994875.24
            ],
            [

              20037508.34,
              -12482310.1
            ],
            [

              -12523442.71,
              -12482310.1
            ],
            [

              -17532819.8,
              -12482310.1
            ],
            [

              -20037508.34,
              -12482310.1
            ],
            [

              -20037508.34,
              -12482310.1
            ],
            [

              -20037508.34,
              19994875.24
            ],
            [

              -20037508.34,
              19994875.24
            ]
          ]
        ]
      }
    }
  }
}