> Функции вэб-сервиса по расчету расстояний

Функции вэб-сервиса по расчету расстояний

Описание web сервиса LoadService.
Данные при расчёте расстояний на сайте и в веб-сервисе могут отличаться.

На сайте мы обновили расчёт расстояний: километраж теперь точнее. Веб-сервис (RoutesService) не обновился, поэтому данные о расстояниях и маршрутах на сайте и в веб-сервисе могут отличаться.


Адрес веб-сервиса расчета расстояний: https://ati.su/RoutesService.asmx
Методы:
  • GetAllCities Возвращает полный список городов.
  • GetAllCountries Возвращает полный список стран.
  • GetAllRegions Возвращает полный список регионов.
  • GetCitiesListByPrefix Возвращает список городов по введенным первым буквам названия.
  • GetCountriesListByPrefix Возвращает список стран по введенным первым буквам названия.
  • GetDistance Возвращает расстояние между указанными городами по заданным параметрам маршрута.
  • GetRouteFull Возвращает подробный маршрут между указанными городами по заданным параметрам маршрута.

Авторизация:

Для авторизации необходимо вызвать метод LoginUser и передать в него строковые парамерты - имя Участника АТИ (userName) и пароль (password)

Метод возвращает строку - идентификатор авторизации (ticket), который используется для подтверждения авторизации при вызове методов веб-сервиса.


Для того, чтобы протестировать возможности вэб-сервиса, можно использовать специальный мандат: username='test', password='test'

В тестовом режиме расчет производится только по городам из регионов Москва и Московская область.


Вспомогательные методы:
  • GetAllCities Возвращает полный список городов.
  • GetAllCountries Возвращает полный список стран.
  • GetAllRegions Возвращает полный список регионов.

Единственный параметр для методов - ticket - строка - идентификатор авторизации которую вернул метод LoginUser


Получение списка городов по введенным первым буквам названия (GetCitiesListByPrefix)

Параметры метода:

  • string ticket - код авторизации
  • string prefixText - первые буквы названия городов
  • string count - максимальное количество городов, возвращаемых методом

Получение списка стран по введенным первым буквам названия (GetCountriesListByPrefix)

Параметры метода:

  • string ticket - код авторизации
  • string prefixText - первые буквы названия стран
  • string count - максимальное количество стран, возвращаемых методом

Получение расстояния между указанными городами (GetDistance)

Внимание! В тестовом режиме расчет ведется только по городам из регионов Москва и Московская область!


Параметры метода:

  • string ticket - код авторизации
  • string cities - список названий городов, разделенных символом ';'
  • bool useFerries - возможно ли использование паромов для составления маршрута
  • string bestTime - оптимизация маршрута по скорости/расстоянию
    • 'true' - самый "быстрый" маршрут
    • 'false' - самый короткий маршрут
  • bool winterRoad - возможно ли использование "зимников" для составления маршрута
  • bool includeOtherCountries - возможно ли прохождение маршрута по территории других государств (в случае, если все указанные точки маршрута находятся в пределах одного государства)
  • string exclCities - список названий городов, через которые не может проходить маршрут, разделенных символом ';'
  • string exclRegions - список названий регионов, через которые не может проходить маршрут, разделенных символом ';'
  • string exclCountries - список названий стран, через которые не может проходить маршрут, разделенных символом ';'
  • string speeds - задает скорость движения по дорогам маршрута различных типов *
  • string delays - задает задержки при прохождении городов различных типов **
* Параметр speeds: задается в виде выражений 'Id типа дороги=скорость движения', разделенных символом ';'
Типы дорог и скорости по умолчанию:
ID Тип дороги Скорость по умолчанию (км/ч)
2 Соединительная 50
3 Важная соединительная 60
4 Магистраль 70
5 Автомагистраль 80
10 Паромы 20
6 Зимник 30
0 Нет информации 40
1 Другой тип 40
** Параметр delays: задается в виде выражений 'Id типа пункта маршрута=время задержки', разделенных символом ';'
Типы пунктов маршрута и время задержки по умолчанию:
ID Тип населенного пункта Задержка по умолчанию (в минутах)
1 до 10.000 5
2 от 10.000 до 50.000 10
3 от 50.000 до 100.000 15
4 от 100.000 до 500.000 30
5 от 500.000 до 1.000.000 60
6 свыше 1.000.000 60
11 Таможня 60
12 Время погрузки/разгрузки 120

Получение подробного маршрута между указанными городами по заданным параметрам маршрута (GetRouteFull)

Внимание! В тестовом режиме расчет ведется только по городам из регионов Москва и Московская область!


Параметры метода аналогичны параметрам метода GetDistance