# Navixy Web Service

{% hint style="info" %}
**Категория протокола:** Протокол консолидации данных
{% endhint %}

#### Содержание

1. [Что такое Navixy Web Service?](#what-is-ws)
2. [Техническая информация о Navixy Web Service](#tech-info-ws)
3. [Конфигурация Navixy Web Service](#ws-config)
4. [Настройка](#setting-up)
5. [Управление](#managing)
6. [Устранение неполадок](#troubleshooting)

### Что такое 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`: код события согласно [ID события Navixy Generic Protocol](https://www.navixy.com/docs/iot-logic-api/technologies/navixy-generic-protocol/navixy-generic-protocol-10/predefined-event-identifiers)

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

#### Настройка

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

1. Перейдите в **Устройства и настройки** в левой боковой панели.
2. Выберите нужное устройство из **Объекты** списка.
3. Найдите **Передача данных** блок, разверните его и нажмите <img src="/files/c1b9db26d215bd68d464544bff2c854baa7115ce" alt="" data-size="line">.
4. В открывшемся окне нажмите «+», чтобы добавить новую ретрансляцию.
5. В диалоге **Новый протокол ретрансляции** введите необходимую информацию. Для протокола Navixy Web Service заполните следующие поля:

<table><thead><tr><th width="187.8182373046875">Параметр</th><th>Описание</th></tr></thead><tbody><tr><td>Имя</td><td>Описательная метка для идентификации этой конфигурации протокола ретрансляции. Введите имя, чтобы этот ретранслятор было легко идентифицировать.</td></tr><tr><td>Протокол и логин</td><td>Используемый для ретрансляции протокол связи. Выберите <strong>Navixy Web Service</strong> из раскрывающегося меню.</td></tr><tr><td>Адрес</td><td>URL или IP-адрес целевого сервера.<br><strong>Примечание</strong>: Он не используется Navixy Web Service, введите любой допустимый формат адреса.</td></tr><tr><td><strong>Порт</strong></td><td>Сетевой порт для подключения к целевому серверу.<br><strong>Примечание</strong>: Он не используется Navixy Web Service, введите любой номер порта.</td></tr><tr><td>Логин</td><td>Уникальный идентификатор этого соединения ретранслятора. Введите любой логин, который еще не используется другим ретранслятором в вашей системе.</td></tr><tr><td>Пароль</td><td>Код аутентификации для этого соединения ретранслятора. Введите уникальный пароль для защиты этой конфигурации ретранслятора.</td></tr></tbody></table>

6. Переключите **Включено** тумблер в положение «вкл.», чтобы активировать ретрансляцию данных. Пока ретранслятор отключен, он не будет передавать данные.
7. Этот **Управление ретрансляцией** экран должен выглядеть примерно так, с логином и паролем Navixy Web Service. Убедитесь, что статус **Активен** если вы хотите, чтобы этот ретранслятор отправлял данные.\
   ![](/files/55d0ffbdbdaa3e112b291a4af26ef008455cd890)
8. Далее ретранслятор нужно связать с устройством. Для этого включите тумблер с нужным именем ретранслятора в **Передача данных** блоке. External ID не требуется для протокола Navixy Web Service.\
   ![](/files/862885f1ca4c45cbf94294b317eba96b54fb6691)

{% hint style="success" %}
Вы успешно создали и включили новый протокол ретрансляции для этого устройства. Теперь ретранслятор доступен для всех устройств в аккаунте, вы можете включить его, переключив тумблер в настройках других устройств.
{% endhint %}

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

Обязательные параметры:

* **Логин и пароль**: Они должны совпадать с учетными данными, которые вы настроили в конфигурации ретранслятора
* **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-запрос выглядит следующим образом, замените его соответствующей информацией:

{% code overflow="wrap" %}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org">

   <soapenv:Header>
   <tem:authentication>
     <login>username</login>
     <password>password</password>
   </tem:authentication>
   </soapenv:Header>
   <soapenv:Body>
   <tem:dataRequest>
      <!--1 to 100 repetitions:-->
      <deviceIds>IMEI of device</deviceIds>
      <startDate>2022-08-30T00:00:00Z</startDate>
      <endDate>2022-08-31T00:00:00Z</endDate>
   </tem:dataRequest>
   </soapenv:Body>
</soapenv:Envelope>
```

{% endcode %}

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

```xml
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
    <S:Body>
        <ns:getLocationDataResponse xmlns:ns="http://tempuri.org">
            <result>
                <dateGps>2019-10-15T08:48:50.000Z</dateGps>
                <ignition>false</ignition>
                <latitude>75.9270866</latitude>
                <longitude>-85.5207616</longitude>
                <speedGps>0.0</speedGps>
                <unitPlate>JRT1550</unitPlate>
                <altitude>284.0</altitude>
                <course>N</course>
                <deviceId>866258048802349</deviceId>
                <numSat>15</numSat>
                <odometer>59845</odometer>
                <eventId>401</eventId>
            </result>
        </ns:getLocationDataResponse>
    </S:Body>
</S:Envelope>
```

#### Управление

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

1. В любом **Передача данных** блоке нажмите <img src="/files/28af1e082105ef7431745f7f092746f6ac2d3f5c" alt="" data-size="line"> чтобы открыть список доступных протоколов.
2. Нажмите <img src="/files/c96f2e92ddc442c546e1a81d48759cfc8de9f035" alt="" data-size="line"> чтобы изменить настройки ретранслятора, такие как имя, данные для входа или статус включения.
3. Нажмите <img src="/files/11e0323f0e1c48933930de9e9ea03e688930085b" alt="" data-size="line"> и подтвердите удаление ретранслятора

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

{% hint style="info" %}
Чтобы включить/отключить ретранслятор для определенного устройства, переключите тумблер с нужным именем ретранслятора в **Передача данных** блок.
{% endhint %}

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

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

1. Установите Soap UI
2. В меню File выберите «New SOAP Project»
3. Вставьте правильный путь в поле WSDL в соответствии с сервером и выберите **Create sample requests for all operations?**
4. US: <https://soap.us.navixy.com/LocationDataService?wsdl>
5. EU: <https://soap.navixy.com/LocationDataService?wsdl>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/user/ru/guide/devices-and-settings/data-forwarding/navixy-ws.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.