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