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