ArcGIS Velocity 中的 Geotab (DeviceStatusInfo) 源类型通过向指定 URL 发送 HTTP 请求的方式定期轮询 Geotab DeviceStatusInfo 数据库表，以获取实时自动车辆定位 (AVL) 数据。 有关 Geotab 的详细信息，请参阅 Geotab 文档中的关于 Geotab。 Geotab (DeviceStatusInfo) 源类型不同于 Geotab (LogRecord) 源类型，前者从 Geotab 数据库的 DeviceStatusInfo 表请求数据。 DeviceStatusInfo 表包含的属性比 LogRecord 表多，但更新频率总体上低于 Geotab 数据库的 LogRecord 表。
示例
以下是 Geotab (DeviceStatusInfo) 源的用例：
- 某城市希望在冬季监控他们的扫雪车车队。 Geotab (DeviceStatusInfo) 源可用于观察每辆卡车的实时位置并收集其他辅助信息（例如犁板是否接合到位或除冰盐的存储容器是否达到了低阈值）。
- 一家废物管理公司希望通过数据驱动型分析来提高车队的运营效率。 可使用 Geotab (DeviceStatusInfo) 源来实时采集每辆车的位置、驾驶员、负载重量、空闲时间和燃料水平。
用法说明
使用 Geotab (DeviceStatusInfo) 源时，请记住以下事项：
- Geotab (DeviceStatusInfo) 源可使用 Geotab 数据库表中的数据来构造事件。 例如，可从 DeviceStatusInfo 表中检索位置、速度和方位角属性。 可使用 Device 表来检索诸如 VIN、车牌等附加属性信息。 可从 Group 表中获取到与每个设备关联的组名称和组 ID。 有关详细信息，请参阅下面的方案。
- 来自 Geotab 的数据将高度规范化，默认情况下，Geotab (DeviceStatusInfo) 源将遵循固定的方案。 Geotab (DeviceStatusInfo) 源将自动设置位置、日期和时间以及追踪 ID。 可以更改追踪 ID 字段。
- 可以提供可选的诊断 ID，以便使用其他属性值对方案进行增强。 例如，如果车辆配备有用于监控总燃料用量的传感器，则提供 DiagnosticDeviceTotalFuelId 诊断 ID 将导致该源在新的属性字段中采集该特定信息。 诊断字段将反映在源方案中。
- 可以指定一个或多个可选组，以限制可从 Geotab (DeviceStatusInfo) 源检索的设备数据类型。
- 可以将包含驾驶员信息的其他字段追加到 Geotab (DeviceStatusInfo) 源的默认方案。 仅选择具有 Geotab 提供的值的字段。 如果字段未知，值可能为空、空字符串或包含 Geotab 预定义的字符串。 有关其他信息，请参阅下面的其他字段。
- 建议将轮询 Geotab 数据的间隔设置为每 30 秒或更长时间。 有关详细信息，请参阅 Geotab 文档中的速率限制。
方案
| 属性 | 数据类型 |
|---|---|
device_id | 字符串 |
vehicleName | 字符串 |
vehicleSerialNumber | 字符串 |
vin | 字符串 |
vehicleEngineType | 字符串 |
vehicleLicensePlate | 字符串 |
vehicleLicenseState | 字符串 |
deviceType | 字符串 |
dateTime | 字符串 |
latitude | Float64 |
longitude | Float64 |
speed | Float64 |
bearing | Int32 |
groupIds | 字符串 |
groupNames | 字符串 |
附加字段
| 属性 | 数据类型 |
|---|---|
firstName | 字符串 |
lastName | 字符串 |
phoneNumber | 字符串 |
phoneNumberExtension | 字符串 |
employeeNo | 字符串 |
id | 字符串 |
名称 | 字符串 |
companyName | 字符串 |
参数
| 参数 | 描述 | 数据类型 |
|---|---|---|
URL | 用于对 Geotab 进行身份验证的 URL。 URL 的形式通常为 https://[myserver].geotab.com/apiv1。 | 字符串 |
数据库 | Geotab 数据库的名称。 | 字符串 |
用户名 | 用于对 Geotab 进行身份验证的用户名。 | 字符串 |
密码 | 用于对 Geotab 进行身份验证的密码。 | 密码 |
组（可选） | 用于过滤实体成员的可选组名称。 例如，道路清扫车辆可能属于名为 Sweepers 的组。 系统仅会为实时处理检索属于 Sweepers 组实体成员的车辆。 注：可以使用分号 (;) 指定多个组。 | 字符串 |
诊断 ID（可选） | 用于获取诊断值的可选诊断 ID。 例如，DiagnosticDeviceTotalFuelId 是用于从配备有合适传感器车辆中检索总燃料消耗的诊断 ID。 系统将为每个诊断 ID 添加一个诊断值字段和一个诊断时间戳字段。 注：可以使用分号 (;) 指定多个诊断 ID。 | 字符串 |
附加字段 | 从其他字段列表中进行选择以丰富包含驾驶员信息的源方案。 注：仅选择具有 Geotab 提供的值的字段。 否则，生成的字段值可能为空、空字符串或包含 Geotab 预定义的字符串。 | 字符串 |
注意事项和限制
使用 Geotab (DeviceStatusInfo) 源时，需要牢记几点注意事项和限制：
- 在每个轮询间隔，Geotab 将提供它在上次轮询时编译的数据；在该轮询之后编译的数据将不包含在内。 提供的数据可能会早于源所发起的上次轮询的时间戳。
- 诊断值将以不同于其他设备数据的速率更新。 因此，每个诊断字段都将具有对应的时间戳字段。 请考虑诊断值是否与从 Geotab 检索到的其他数据的最新时间戳在时间上相关。
- 在指定唯一的诊断 ID 时，可以首先使用组来过滤来自 Geotab 的设备类型。 每个诊断 ID 都会使来自 Geotab 的所有车辆的方案得到增强。 例如，系统会将用于捕获扫雪车犁板状态的诊断追加到来自 Geotab 的所有车辆类型，而非仅仅追加到扫雪车。 对于没有传感器的车辆，该诊断值将为空。 如果首先定义了一个扫雪车组，则系统只会从 Geotab 中检索扫雪车，且会生成与相关扫雪车犁板状态相对应的自定义诊断字段。
- 如果其他字段由 Geotab 在数据库中提供，则它们将仅包含值。 在选择任何其他字段之前，考虑组织的 Geotab 设备报告的信息。 不含值的字段将为空、空字符串或包含 Geotab 预定义的字符串。