791
правка
Изменения
→Геокодирование
==Трекинг по номеру==
"Трекинг по номеру" позволяет отслеживать заказ по его номеру. Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/tracking'''. При поиске заказа выводится таблица с подробностями. Поля таблицы настраиваются в "[[Личный кабинет курьерской службы#Настройка полей|админке]]" на вкладке "Поля трекинга по номеру".
Чтобы получить информацию о заказе, введите его номер в поле "Код" и нажмите кнопку "Найти".
*'''star''' - признак вывода в виде звёздочек. По умолчанию 1.
*'''hash''' - значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|SignatureUrl]]. Обязательный параметр.
*'''field''' - Пользовательское поле, для указания типа отзыва.
В системе MeaSoft такой сотрудник должен быть назначен [[Сотрудники#Виды сотрудников|агентом]], а также указан менеджером на вкладке "Основное" в <rspoiler text="карточке клиента">"Клиенты" → карточка клиента → вкладка "Основное" → поле "Менеджер" </rspoiler>, которого он привёл. Там же в поле "% менеджера" указывается размер вознаграждения агента в виде процента от заказов.
==Геокодирование==
Геокодирование выполняется запросом к серверу на адрес:
http://home.courierexe.ru/geocoder
GET-параметры:
* '''geocoder''' - в данном параметре может использоваться как полный адрес для разбора, так и в составе других параметров
* '''town''' - город
* '''address''' - адрес
* '''street''' - улица
* '''home''' - номер дома
* '''extracode''' - дополнительный параметр, зависит от клиента
Результатом является ответ в формате XML, например:
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<ymaps>
<GeoObjectCollection>
<featureMember>
<GeoObject>
<metaDataProperty>
<GeocoderMetaData>
<kind>house</kind>
</GeocoderMetaData>
</metaDataProperty>
<name>ул. Сталеваров, 20</name>
<Point>
<pos>37.8389496 55.754736</pos>
<kind>house</kind>
<zipcode>house</zipcode>
<distance>house</distance>
</Point>
</GeoObject>
</featureMember>
</GeoObjectCollection>
</ymaps>
</source>
Параметры ответа:
* '''name''' - найденный адрес
* '''pos''' - геокоординаты - долгота и широта
* '''kind''' - найденный элемент является домом, если значение house
* '''zipcode''' - индекс найденного объекта
* '''distance''' - расстояние до МКАД/КАД в метрах
Ответ в случае, если адрес не геокодирован
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<ymaps>
<error>
<status>429</status>
<message>Coordinates aren't found</message>
</error>
</ymaps>
</source>
