Archives by date

Сервисы

WMS

GET /wms

Получение тайла слоя

Структура запроса:

GET /service/wms?service=WMS&request=GetMap&version=1.1.1&layers=kziokzn:vamin_kioski_p_vw&
        styles=vamin_kioski_p_vw_style_21_03_2011_19_20_16&format=image/png&transparent=true&height=256&
        width=256&srs=EPSG:900913&bbox=5283327.395071382,7514065.628545966,5322463.153553393,7553201.387027976&
        token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

Статус: 404 — ни один слой не найден в системе

Статус: 403 — нет доступа к слою

Статус: 500 — ошибка на сервере

GET /wms

Запрос легенды слоя

Структура запроса:

GET /service/wms?request=GetLegendGraphic&style=vamin_kioski_p_vw_style_21_03_2011_19_20_16&
        layer=kziokzn:vamin_kioski_p_vw&format=image/png&token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

Статус: 404 — слой не найден в системе

Статус: 403 — нет доступа к слою

Статус: 500 — ошибка на сервере

WFS

GET /wfs

Получение WFS слоя

Структура запроса:

GET /service/wfs?service=WFS&version=1.0.0&request=GetFeature&typeName=DEMO:kfu_building&outputFormat=json&
        bbox=40.14404296875,52.905589081407825,61.23779296875,57.630699148918424&token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

Статус: 404 — слой не найден в системе

Статус: 403 — нет доступа к слою

Статус: 500 — ошибка на сервере

Стиль слоя

GET /service/styles/{layerId}/{styleName}.sld

Запрос sld-файла стиля

Структура запроса:

GET /service/styles/367/set_wifi_iconstyle_02_10_2012_14_00_01.sld?token=bw3ty3h46yth

Ответ:

Статус: 200 — успешное выполнение

Статус: 404 — слой не найден в системе

Статус: 403 — нет доступа к слою

Статус: 500 — ошибка на сервере

Примеры использования

Подключение API

Для начала работы с API Вам необходимо в своем проекте сделать несколько подключений:

<script src="@utils.Config.baseHost/public/javascripts/libs/jquery/jquery-1.7.2.min.js" type="text/javascript"></script>
<script src="@utils.Config.baseHost/public/javascripts/libs/jquery/jquery-ui-1.9.2.custom.min.js" type="text/javascript"></script>

Кроме подключения jquery и jquery-ui, необходимо подключить сам API.

<script src="@utils.Config.baseHost/public/geoportal/geoportal-api.min.js" type="text/javascript"></script>

Создание простой карты

Для добавления карты у Вас должен быть DOM элемент, предположим, что он имеет id=”map”, тогда создание карты будет выглядеть следующим образом:

var map = new GeoPortal.Map(“map”);

Добавление и управления слоями

Далее на эту карту наверняка понадобится добавить несколько слоев.
Предположим, что мы знаем id слоя, который нам нужно добавить на карту (пусть id буде равен 204), найдем этот слой и добавим на карту.

function exampleForLayer(layer){
    map.addLayer(layer);	//обавляем слой на карту
    layer.setOpasity(0.6);	//добавляем слою прозрачность
}

GeoPortal.Layer.findLayerById(
    204,
    exampleForLayer,
    function(status, error){
        console.log(error);
    }
);

Динамические элементы

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

    var popup = new GeoPortal.Popup({closeButton: true, minWidth: 100});
    popup.setLatLng(new GeoPortal.LatLng(55,49));
    map.addLayer(popup)

    var marker = new GeoPortal.Marker(new GeoPortal.LatLng(55,49))
    map.addMarker(marker);

    var polyline = new GeoPortal.Vector.PolyLine([new GeoPortal.LatLng(55,49), new GeoPortal.LatLng(55.1, 49.1)]);
    map.addLayer(polyline);

Регистрация

Регистрация пользователя

POST /registration

{
    "login": ,
    "paswd": ,
    "email": ,
    "status": ,
    "ur_fio": "",
    "ur_address": ,
    "phone":  
}

// логин
// пароль
// email
// 1 - юридическое лицо, 2 - физическое
// ФИО
// адрес
// телефон

{
    "res" : 1, 
    "resText":
}

Список полей для регистрации

GET /registration/form

{ 
   "name":, 
   "rusName":, 
   "required":, 
   "values":
}

// английское название параметра
// русское название параметра
// обязательный ли параметр: true, false
// какие может применять значения (важен для параметра status)

{
    "res": 1,
        "fields": {
        "general": [{    
            "name": "login",
            "rusName": "Логин",
            "required": true,  
            "values": "" 
        }]
    },
    "url": "/rest/registration/" 
}

// название поля
// русское название поля
// обязательное ли поле true или false

Проверка логина на существование в системе

POST /registration/checklogin

 {
     "login": ""
 }

// логин

{
     "res": 1,
     "check":
 }

// true или false, свободен ли логин

Пользователи

Список пользователей

Доступ для пользователей (кроме администратора всех ведомств, которому всегда доступен запрос) определяется в настройках системы

GET /users

{
    "res": 1,
    "users": [{
        "id": ,
        "login": ,
        "fio": ,
        "role_id": ,
        "department_id":  
    }]
}

// id пользователя
// логин
// ФИО
// id роли: 6, 7 - обычный пользователь, 10 - админ ведомства, 8 - админ всех ведомств
// id ведомства, либо null, если пользователь с ролью 8

{
    "res": 0,
    "resText": "У вас нет прав для получения данных." 
}

Количество пользователей в системе

GET /users/count

{
    "res": 1,
    "count": "{количество}" 
}

Стандартное хранилище данных для пользователя, если оно существует

GET /users/standartStore

{
    "res": 1,
    "store": {
        "id": ,
        "host": ,
        "port": ,
        "database": 
    }
}

// ip адрес host, напр."178.213.246.98"
// порт, напр. "5432"
// название базы данных, напр. "testdb2" 

Города

Список городов

GET /city

{
	"res": 1,
	"cities": [{
		"id": ,
		"name": ,
		"photo": ,
		"matrix": ,
		"order": 
	}]
}

// id города
// название
// название фотографии
// матрица перелета
// порядок отображения