Тип канала Geotab (LogRecord) в ArcGIS Velocity будет периодически запрашивать таблицу базы данных Geotab LogRecord для получения данных автоматического определения местоположения транспортного средства в режиме реального времени (AVL) путем отправки HTTP запроса по указанному URL. Тип канала Geotab (LogRecord) отличается от типа канала Geotab (DeviceStatusInfo) тем, что запрашивает данные из таблицы LogRecord базы данных Geotab. Таблица LogRecord обычно обновляется чаще, чем таблица DeviceStatusInfo базы данных Geotab, хотя она содержит меньше атрибутов, чем таблица DeviceStatusInfo. Это позволяет каналу Geotab (LogRecord) получать обновления местоположения чаще.
Примеры
Ниже приведены примеры использования канала:
- Город хочет следить за своим парком снегоуборочных машин в зимний сезон. Канал Geotab (LogRecord) используется для наблюдения за местоположением каждого грузовика в режиме реального времени и сбора другой вспомогательной информации, такой как задействован ли нож или заканчивается ли противогололедная соль в контейнере.
- Компания по утилизации отходов хочет повысить эффективность своего парка с помощью анализа данных. Канал Geotab (LogRecord) используется для сбора данных о местоположении каждого транспортного средства, водителе, весе груза, времени простоя и уровне топлива в режиме реального времени.
Примечания по использованию
При работе с каналом учитывайте следующее:
- Канал Geotab (LogRecord) конструирует события, используя данные из таблиц в базе данных Geotab. Например, атрибуты местоположения, скорости и направления извлекаются из таблицы LogRecord. Таблица device используется для получения дополнительной атрибутивной информации, такой как VIN, номерной знак автомобиля и т.д. Имена групп и идентификаторы групп, связанные с каждым устройством, получаются из таблицы group. Для получения более подробной информации см. раздел Схема ниже.
- Данные из Geotab нормализованы, и канал Geotab (LogRecord) по умолчанию следует фиксированной схеме. Канал автоматически устанавливает местоположение, дату и время, а также track ID. Поле track ID можно изменить.
- Также можно предоставлять другие диагностические ID для улучшения схемы с дополнительными значениями атрибутов. Например, если транспортное средство оснащено датчиком для контроля общего расхода топлива, предоставление DiagnosticDeviceTotalFuelId диагностического идентификатора позволит каналу собрать эту конкретную информацию в новом поле атрибута. Диагностические поля отражаются в схеме канала.
- Можно указать одну или несколько дополнительных групп, чтобы ограничить тип данных устройства, извлекаемых из канала Geotab (LogRecord).
- К схеме по умолчанию канала Geotab (LogRecord) можно присоединить дополнительные поля с информацией о водителе. Выбирайте только поля, в которых есть значения, предоставленные Geotab. Если поле неизвестно, то значение может быть нулевым, пустой строкой или содержать строку, преднастроенную Geotab. Более подробную информацию см. в разделе Дополнительные поля, приведенном ниже.
- Рекомендуемый интервал опроса для получения данных Geotab составляет 30 секунд или более.
Схема
В следующей таблице перечислены атрибуты схемы и их типы данных для канала:
| Атрибут | Тип данных |
|---|---|
| device_id | Строка |
| vehicleName | Строка |
| vehicleSerialNumber | Строка |
| vin | Строка |
| vehicleEngineType | Строка |
| vehicleLicensePlate | Строка |
| vehicleLicenseState | Строка |
| deviceType | Строка |
| dateTime | Строка |
| latitude | Float64 |
| longitude | Float64 |
| speed | Float64 |
| groupIds | Строка |
| groupNames | Строка |
Дополнительные поля
Ниже приведены дополнительные атрибутивные поля и их типы данных для канала:
| Атрибут | Тип данных |
|---|---|
firstName | Строка |
lastName | Строка |
phoneNumber | Строка |
phoneNumberExtension | Строка |
employeeNo | Строка |
id | Строка |
name | Строка |
companyName | Строка |
Параметры
Ниже приведены параметры канала:
| Параметр | Описание | Тип данных |
|---|---|---|
| URL | URL-адрес аутентификации Geotab, например, https://[myserver].geotab.com/apiv1. | Строка |
| База данных | Имя базы данных Geotab. | Строка |
| Имя пользователя | Имя пользователя для авторизации в Geotab. | Строка |
| Пароль | Пароль для авторизации в Geotab. | Пароль |
| Группы (дополнительный) | Дополнительные имена группы для фильтрации элементов. Например, транспортные средства для подметания улиц могут принадлежать к группе с именем Sweepers. Только транспортные средства, являющиеся участниками элемента группы Sweepers, извлекаются для обработки в режиме реального времени. Примечание:Укажите несколько групп, используя символ точки с запятой (;). | Строка |
| Диагностические ID (дополнительный) | Дополнительные диагностические идентификаторы используются для получения диагностических значений. Например, DiagnosticDeviceTotalFuelId - это диагностический идентификатор, используемый для получения общего расхода топлива от транспортных средств, оснащенных датчиком. Для каждого диагностического идентификатора добавляется поле диагностического значения и поле диагностической метки времени. Примечание:Укажите несколько диагностических идентификаторов, используя точку с запятой (;). | Строка |
| Дополнительные поля | Список дополнительных полей, которые могут быть применены для обогащения схемы канала информацией о водителе. Примечание:Выбирайте только поля, в которых есть значения, предоставленные Geotab. В противном случае итоговое значение полей может быть нулевым, пустой строкой или содержать строку, преднастроенную Geotab. | Строка |
| Дополнительное ведение журнала (дополнительно) | Указывает, включено ли ведение журнала необработанных HTTP-запросов и ответов, исходящих от Velocity к Geotab API. Примечание:Включайте этот параметр только в целях устранения неполадок и отключайте его после завершения устранения неполадок. После включения запустите канал, журналы уровня отладки будут доступны на странице журналов канала. При необходимости обратитесь в Esri Technical Поддержка за помощью в устранении неполадок. | Boolean |
Советы и ограничения
- На каждом интервале опроса Geotab предоставляет данные, собранные во время последнего опроса; данные, собранные после этого опроса, не включаются. Введенные данные могут быть старше метки времени последнего опроса, проведенного каналом.
- Диагностические значения обновляются со скоростью, отличной от скорости обновления других данных устройства. По этой причине каждое диагностическое поле сопровождается полем метки времени. Подумайте, имеют ли диагностические значения временное отношение к последней метке времени других данных, полученных из Geotab.
- При задании уникальных диагностических идентификаторов сначала рассмотрите возможность использования групп для фильтрации типов устройств, поступающих из Geotab. Каждый диагностический идентификатор улучшает схему для всех транспортных средств из Geotab. Например, диагностика, которая фиксирует состояние ножа отвала снегоочистителя, добавляется ко всем типам транспортных средств из Geotab, а не только к снегоуборочным машинам. Для транспортных средств без датчика диагностическое значение пустое. Если сначала будет определена группа снегоочистительных машин, только снегоочистительные машины будут извлечены из Geotab и будут иметь настраиваемое диагностическое поле для соответствующего состояния ножа отвала снегоочистителя.
- Дополнительные поля будут содержать значения только в том случае, если Geotab предоставляет их в базе данных. Учитывайте информацию, которая поступает в отчетах устройств с Geotab вашей организации, перед выбором любых дополнительных полей. Поля, в которых нет значений, будут иметь значения null, с пустой строкой, либо содержать преднастроенную Geotab строку.
- Если учетные данные пользователя некорректны, канал попытается установить соединение до трех раз. Некорректные учетные данные появляются в журналах. Канал автоматически попытается перезапуститься после задержки, в соответствии с настроенным расписанием периодических запусков.