Интеграция с сайтами — различия между версиями

Материал из TK
Перейти к: навигация, поиск
Строка 1: Строка 1:
Интеграция со сторонними сайтами для отображения местоположения машин организации заключается в добавлении на страницу сайта объекта&nbsp;iframe со заранее сформированной ссылкой с токеном.<span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;"></span>
+
Интеграция со сторонними сайтами для отображения местоположения машин организации заключается в добавлении на страницу сайта объекта&nbsp;iframe со заранее сформированной ссылкой с токеном.
 
<div>
 
<div>
 
== Создание токена ==
 
== Создание токена ==
Строка 5: Строка 5:
 
{| border="0" cellspacing="0" cellpadding="5" style="width: 100%;"
 
{| border="0" cellspacing="0" cellpadding="5" style="width: 100%;"
 
|-
 
|-
| http://wiki.tk-chel.ru/images/2/29/Token.png<br/>
+
| style="vertical-align: top;" | http://wiki.tk-chel.ru/images/2/29/Token.png<br/>
 
| style="vertical-align: top;" |
 
| style="vertical-align: top;" |
 
<span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;">Для доступа к сайту (и использования iframe) без ввода логина и пароля необходимо создать токен. Он создается в разделе /Install веб-интерфейса. В токене зашифрован логин, пароль и другая информация,&nbsp;</span>
 
<span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;">Для доступа к сайту (и использования iframe) без ввода логина и пароля необходимо создать токен. Он создается в разделе /Install веб-интерфейса. В токене зашифрован логин, пароль и другая информация,&nbsp;</span>
Строка 17: Строка 17:
 
<span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;">'''Activity period'''&nbsp;- срок действия токена. Можно не указывать, тогда токен будет бессрочный. Также можно указывать одно из значений, тогджа токен будет действовать либо ДО либо ПОСЛЕ указанной даты-времени.</span>
 
<span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;">'''Activity period'''&nbsp;- срок действия токена. Можно не указывать, тогда токен будет бессрочный. Также можно указывать одно из значений, тогджа токен будет действовать либо ДО либо ПОСЛЕ указанной даты-времени.</span>
   
  +
|-
<span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;">После нажатия на кнопку&nbsp;'''Create token'''&nbsp;будет создан и показан&nbsp;токен. Далее будет использован бессрочный&nbsp;токен&nbsp;</span>5776C670CBBD2FE10677845A1A7D7583 полученный для логина-пароля demo/demo.
 
  +
| style="vertical-align: top;" colspan="2" | <span style="color: rgb(0, 18, 32); font-family: Tahoma, Verdana; font-size: 13.3333330154419px; line-height: normal;">После нажатия на кнопку&nbsp;'''Create token'''&nbsp;будет создан и показан&nbsp;токен. Далее будет использован бессрочный&nbsp;токен&nbsp;</span><span style="line-height: 20.7999992370605px;">5776C670CBBD2FE10677845A1A7D7583 полученный для логина-пароля demo/demo.</span><br/>
 
 
|}
 
|}
   

Версия 21:19, 5 апреля 2015

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

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

Token.png

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

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

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

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

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

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

Описание параметров

Параметр
Назначение
Используется в
1 (местоположение) 2 (треки)
map тип карты (полный список карт в параметре MapsEnabled) да (необязательный)
да (необязательный)
serials номера приборов, через запятую да (необязательный)

sd начало периода в формате YYYYMMDD или YYYYMMDD-HHMM
да (необязательный)
ed конец периода в формате YYYYMMDD или YYYYMMDD-HHMM

да (необязательный)
(если отсутствует -
трек выводится за сутки параметра sd)

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

<iframe src='http://demo.tk-nav.com/Strict/Index/A6CB2007DD716D04B478C77AB929F1B8?map=osm' width='600' height='600'></iframe>

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

Integrate_1.jpg

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

<iframe src='http://demo.tk-nav.com/Strict/Index/A6CB2007DD716D04B478C77AB929F1B8?map=osm&serials=9999986' width='600' height='600'></iframe>

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

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

<iframe src='http://demo.tk-nav.com/Strict/Index/A6CB2007DD716D04B478C77AB929F1B8?map=osm&serials=9999986&sd=20140320' width='600' height='600'></iframe>

<iframe src='http://demo.tk-nav.com/Strict/Index/A6CB2007DD716D04B478C77AB929F1B8?map=osm&serials=9999986&sd=20140320&ed=20140321' width='600' height='600'></iframe>

Integrate 2.jpg

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

1. <iframe src='(AG Mobile) http://demo.tk-nav.com/Strict/Filter/A6CB2007DD716D04B478C77AB929F1B8?map=osm&carPath=/DemoCEBIT/Couriers%20(AG%20Mobile)' width='600' height='600'></iframe>
В данном примере будут отображены все ТС из подгруппы Couriers группы Demo.

2. <iframe src='http://demo.tk-nav.com/Strict/Filter/A6CB2007DD716D04B478C77AB929F1B8?map=osm&geoPath=/DemoCEBIT/Chelyabinsk/Districts' width='600' height='600'></iframe>
В данном примере будут отображены все ТС, которые в данный момент находятся в геозонах, расположенных в подгруппе MyCities группы Demo.
Обратите внимание! ТС, местоположение которых находится ВНЕ геозон - отображатся не будут. Но как только эти ТС войдут в одну из геозон указанной группы - они отобразятся на карте.

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