Интеграция с сайтами

Материал из TK
Перейти к: навигация, поиск

Интеграция со сторонними сайтами для отображения местоположения машин организации заключается в добавлении на страницу сайта объекта iframe со ссылкой вида

<iframe

код 5776C670CBBD2FE10677845A1A7D7583 называется токеном. Также Вы можете указать ряд параметров, которые с примерами рассмотрены ниже.

Создание токена

Token.png

Для доступа к сайту (и использования iframe) без ввода логина и пароля необходимо создать токен. Он создается в разделе /Install веб-интерфейса. В токене зашифрован логин, пароль и другая информация, 

которая необходима для входа на сайт и получения информации о транспортных средствах без ввода логина и пароля.

В окне создания токена Login и Password - это логин и пароль пользователя с ограниченными правами (как правило это пользователь "только для чтения").

UTC-offset - смещение времени от UTC (в настоящее время этот параметр в большинстве браузеров и операционных систем заполняется автоматически при открытии страницы веб-интерфейса.

Activity period - срок действия токена. Можно не указывать, тогда токен будет бессрочный. Также можно указывать одно из значений, тогджа токен будет действовать либо ДО либо ПОСЛЕ указанной даты-времени.

После нажатия на кнопку Create token будет создан и показан токен. Далее будет использован бессрочный токен 5776C670CBBD2FE10677845A1A7D7583 полученный для логина-пароля demo/demo.


Режим "местоположение всех доступных токену ТС"

<iframe src='http://m.tk-chel.ru/Strict/Index/5776C670CBBD2FE10677845A1A7D7583' width='600' height='600'></iframe>

Будут отображено последнее известное местоположение всех ТС, доступных токену.

Integrate_1.jpg

Режим "треки указанных ТС за период"

<iframe src='http://m2.tk-chel.ru/Strict/Index/5776C670CBBD2FE10677845A1A7D7583?serials=9999999,9999998' width='600' height='600'></iframe>

Будут отображено последнее известное ТС с указанными номерами приборов. Эти приборы также должны быть доступны токену. Если указан недоступный прибор или прибор, у которого нет данных - он не будет отображен на карте.

На обзорной карте видно местоположение ТС, если увеличить карту - можно увидеть трек ТС за сегодня. Также возможно использование дополнительных параметров sd/ed:

<iframe src='http://m2.tk-chel.ru/Strict/Index/5776C670CBBD2FE10677845A1A7D7583?serials=9999999,9999998&sd=20141201' width='600' height='600'></iframe>

<iframe src='http://m2.tk-chel.ru/Strict/Index/5776C670CBBD2FE10677845A1A7D7583?serials=9999999,9999998&sd=20141201&ed=20141203-1700' width='600' height='600'></iframe>

Здесь параметр sd - начало периода, ed - конец периода. Параметр ed необязательный, если он не указан - трек выводится за сутки, указанные в параметре sd.

Integrate 2.jpg

Режим "местоположение ТС с фильтрацией по группе или геозонам"

1. <iframe src='http://m2.tk-chel.ru/Strict/Index/5776C670CBBD2FE10677845A1A7D7583?carPath=/Demo/Couriers' width='600' height='600'></iframe>
В данном примере будут отображены все ТС из подгруппы Couriers группы Demo.

2. <iframe src='http://m2.tk-chel.ru/Strict/Index/5776C670CBBD2FE10677845A1A7D7583?geoPath=/Demo/MyCities' width='600' height='600'></iframe>
В данном примере будут отображены все ТС, которые в данный момент находятся в геозонах, расположенных в подгруппе MyCities группы Demo.
Обратите внимание! ТС, местоположение которых находится ВНЕ геозон - отображатся не будут. Но как только эти ТС войдут в одну из геозон указанной группы - они отобразятся на карте.

Данные примеры (параметры carPath и geoPath) можно использовать совместно.