GisWare WEB сервер для картографических сервисов в IT- технологиях

GWS API (JSON)

Программный интерфейс позволяет по HTTP соединению производить прием и передачу данных на сервер GWS (GISWARE WEB server v. 3) в формате JSON.

Функции API

ОБЩЕЕ

1. Открытие новой сессии
Адрес: /api/new_session
Формат запроса HTTP: GET

2. Получение тайла карты (в формате OSM)
Адрес: /api/tile/
Формат запроса HTTP: GET

МАРШРУТИЗАЦИЯ

3. Расчет и нанесение на карты оптимального маршрута по множеству пунктов
Адрес: /api/route.gws
Формат запроса HTTP: POST

4. Расчет и нанесение на карты множества оптимальных маршрутов в задачах развоза
Адрес: /api/delivery.gws
Формат запроса HTTP: POST

ГЕОКОДИРОВАНИЕ

5. Поиск и нанесение на карты адреса
Адрес: /api/address.gws
Формат запроса HTTP: POST

6. Поиск и нанесение на карты населенного пункта
Адрес: /api/city.gws
Формат запроса HTTP: POST

Общие требования по работе с API

1. Все функции (кроме одной) требуют параметры текущей сессии пользователя. Их можно получить с помощью функции открытия новой сессии пользователя.
2. При аренде GWS сервера часть функций требуют указания ключа доступа (ключа API). В этом случае сессию пользователя необходимо создавать также с ключом доступа. Приобрести ключ доступа или получить бесплатный пробный ключ можно на сайте www.samlogist.com в разделе "Клиенты GISWARE WEB сервера".
3. При развертывании GWS сервера в своей сети используется электронный ключ HASP, указание ключей доступа в запросах не требуется.

Документация

Описание программного интерфейса GWS API (json)- Открыть

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

(функции API демонстрируются с использованием публичного GWS сервера по адресу http://109.124.101.250, поэтому для работы с примерами используйте бесплатный пробный ключ, который можно получить на сайте www.samlogist.com в разделе "Клиенты GISWARE WEB сервера"- Получить пробный ключ.) 1. Примеры построения запросов на GWS JSON API - Открыть 2. Тестовая страница карты, сформированная с использованием Leaflet по запросам получения тайла карты в формате принятом в OSM (для данного примера ключ доступа не требуется). Перейти 3. Тестовая страница демонстрации расчета маршрутов развоза, реализует отправку данных по HTTP соединению и получение результата расчета рейсов - Перейти 4. Тестовая страница демонстрации расчета маршрута, реализует отправку данных по HTTP соединению и получение результата расчета маршрута - Перейти 5. Тестовая страница демонстрации поиска адресов и городов с подсказками при вводе контекста, реализует отправку данных по HTTP соединению и получение координаты - Перейти 6. Тестовая страница демонстрации геокодирования адреса, реализует отправку данных (адресной строки) по HTTP соединению и получение координаты адреса - Перейти 7. Тестовая страница демонстрации поиска ближайшего адреса к заданной точке, реализует отправку данных (координат точки) по HTTP соединению и получение ближайшего адреса - Перейти 8. Пример программы на C# с исходным кодом - демонстрация расчета доставки и предтавление результатов в таблицах и на картах.  Использованы open source средства - SDK MapControlWPF от Mocrosoft (https://xamlmapcontrol.codeplex.com) и перекодировщик Json - объекты c# от Newtonsoft (http://www.newtonsoft.com/json). Дистрибутив программы содержит релиз программы (папка BIN), демонстрационные данные (папка Data), исходные тексты и ресурсы программы (папка Source). Скачать программу. Для запуска щелкните по ярлыку GWSDeliveryApiDemo.exe в папке BIN. Для демонстрации загружайте данные из папки Data. 9. Пример программы на C# с исходным кодом - демонстрация расчета маршрутов, поиска адресов и предтавление результатов на картах.  Использованы open source средства - SDK MapControlWPF от Mocrosoft (https://xamlmapcontrol.codeplex.com) и перекодировщик Json - объекты c# от Newtonsoft (http://www.newtonsoft.com/json). Дистрибутив программы содержит релиз программы (папка BIN), демонстрационные данные (папка Data), исходные тексты и ресурсы программы (папка Source). Скачать программу. Для запуска щелкните по ярлыку GWSApiDemo.exe в папке BIN.