PricingLog inGet startedAsk Navixy AI

Navixy Web Service

SOAP-эндпоинт для запроса данных отслеживания за указанный период

Категория протокола: Протокол консолидации данных

Содержание

  1. Что такое Navixy Web Service?

  2. Техническая информация о Navixy Web Service

  3. Конфигурация Navixy Web Service

  4. Настройка

  5. Управление

  6. Устранение неполадок

Что такое Navixy Web Service?

Navixy Web Service протокол пересылки данных передаёт данные парка из системы Navixy в любую стороннюю систему. Протокол гибкий и позволяет третьим сторонам сохранять данные парка в своих базах данных для любых целей или отображать данные на веб-ресурсах.

Поскольку этот протокол пересылки данных независим от платформы, он является идеальным вариантом для любого партнёра, работающего с XML-файлами.

Общая техническая информация о Navixy Web Service

Протокол Navixy Web Service использует SOAP для извлечения XML-данных с трекеров в рамках прикладного уровня модели OSI. Данные извлекаются по запросу.

Поля данных, которые отправляются:

  • dateGPS: Дата и время в UTC

  • ignition: Булево состояние зажигания

  • latitude

  • longitude

  • speedGPS: км/ч

  • unitPlate: Номерной знак

  • altitude: Метры

  • course: Направление движения транспортного средства, например: N,S,E,O,NO,NE,SO,SE

  • deviceId: IMEI

  • numSat: Количество спутников GNSS, используемых устройством

  • odometer: Пройденное расстояние в км

  • eventId: код события согласно Navixy Generic Protocol's event ID

Конфигурация Navixy Web Service

Настройка

Чтобы настроить пересылку данных в протоколе Navixy Web Service:

  1. Перейдите в Устройства и настройки в левой боковой панели.

  2. Выберите нужное устройство из Объекты списка.

  3. Найдите Пересылка данных портлет, разверните его и нажмите .

  4. В открывшемся окне нажмите "+", чтобы добавить новую ретрансляцию.

  5. В Новый протокол ретрансляции диалоге введите требуемую информацию. Для протокола Navixy Web Service заполните следующие поля:

Параметр
Пояснение

Имя

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

Протокол и логин

Протокол связи, используемый для ретрансляции. Выберите Navixy Web Service в выпадающем меню.

Адрес

URL или IP-адрес сервера назначения. Примечание: Не используется Navixy Web Service, введите любой корректный формат адреса.

Порт

Сетевой порт для подключения к серверу назначения. Примечание: Не используется Navixy Web Service, введите любой номер порта.

Логин

Уникальный идентификатор для этого соединения ретранслятора. Введите любой логин, который ещё не используется другим ретранслятором в вашей системе.

Пароль

Код аутентификации для этого соединения ретранслятора. Введите уникальный пароль для защиты этой конфигурации ретрансляции.

  1. Переключите Включено тумблер, чтобы активировать ретрансляцию данных. Ретранслятор не будет передавать данные, пока он отключён.

  2. Экран Управление ретрансляцией должен выглядеть примерно так, с логином и паролем Navixy Web Service. Убедитесь, что статус Активен если вы хотите, чтобы этот ретранслятор отправлял данные.

  3. Далее ретранслятор необходимо связать с устройством. Для этого включите тумблер с нужным именем ретранслятора в Пересылка данных портлете. Внешний ID не требуется для протокола Navixy Web Service.

Вы успешно создали и включили новый протокол ретрансляции для этого устройства. Теперь ретранслятор доступен для всех устройств в аккаунте — вы можете включить его, переключив тумблер в настройках других устройств.

Внешний доступ:

Требуемые параметры:

  • Логин и пароль: Они должны соответствовать учётным данным, которые вы указали в конфигурации ретранслятора

  • deviceIDs: Максимум 100

  • startDate и endDate: Например, 9 сентября 2022 г. 00:00 UTC по 11:59:59

    • UTC: 2022-09-01T00:00:00Z по 2022-09-01T11:59:59Z

Описание протокола в WSDL можно найти ниже, в зависимости от расположения сервера:

EU https://soap.navixy.com/LocationDataService?wsdl

US https://soap.us.navixy.com/LocationDataService?wsdl

SOAP-запрос должен быть выполнен с использованием одной из вышеуказанных страниц WSDL. Сам XML-запрос выглядит следующим образом, замените поля соответствующей информацией:

Пример ответа может выглядеть так:

Управление

Чтобы изменить или остановить пересылку данных, выполните следующие шаги:

  1. В любом Пересылка данных портлете нажмите чтобы открыть список доступных протоколов.

  2. Нажмите чтобы изменить настройки ретранслятора, такие как имя, данные для входа или статус включения.

  3. Нажмите и подтвердите удаление ретранслятора

Все изменения сохраняются автоматически.

Чтобы включить/отключить ретранслятор для определённого устройства, переключите тумблер с нужным именем ретранслятора в портлете устройства. Пересылка данных портлете.

Устранение неполадок

Для проверки и тестирования вашего SOAP-запроса к платформе рекомендуется использовать SoapUI, который доступен здесь: https://www.soapui.org/downloads/soapui/

  1. Установите Soap UI

  2. В меню File выберите «New SOAP Project»

  3. Вставьте корректный путь в поле WSDL в соответствии с сервером и выберите Создать примерные запросы для всех операций?

  4. US: https://soap.us.navixy.com/LocationDataService?wsdl

  5. EU: https://soap.navixy.com/LocationDataService?wsdl

ПредыдущаяILSPСледующаяRecurso Confiable

Последнее обновление

Это было полезно?