Geotab (LogRecord)

为了获得实时自动车辆定位 (AVL) 数据,ArcGIS Velocity 中的 Geotab (LogRecord) 源类型将通过将 HTTP 请求发送到指定 URL 来定期轮询 Geotab LogRecord 数据库表。 有关 Geotab 的详细信息,请参阅 Geotab 文档中的关于 Geotab。 Geotab (LogRecord) 源类型不同于 Geotab (DeviceStatusInfo) 源类型,前者从 Geotab 数据库的 LogRecord 表请求数据。 LogRecord 表通常比 Geotab 数据库的 DeviceStatusInfo 表更新频率更高,虽然其包含的属性比 DeviceStatusInfo 表少。 这一点使 Geotab (LogRecord) 源可以更频繁地接收位置更新。

示例

以下是 Geotab (LogRecord) 源的用例:

  • 某城市希望在冬季监控他们的扫雪车车队。 Geotab (LogRecord) 源可用于观察每辆卡车的实时位置并收集其他辅助信息(例如犁板是否接合到位或除冰盐的存储容器是否达到了低阈值)。
  • 一家废物管理公司希望通过数据驱动型分析来提高车队的运营效率。 可使用 Geotab (LogRecord) 源来实时采集每辆车的位置、驾驶员、负载重量、空闲时间和燃料水平。

用法说明

使用 Geotab (LogRecord) 源时,请记住以下事项:

  • Geotab (LogRecord) 源可使用 Geotab 数据库表中的数据来构造事件。 例如,可从 LogRecord 表中检索位置、速度和方位角属性。 可使用 Device 表来检索诸如 VIN、车牌等附加属性信息。 可从 Group 表中获取到与每个设备关联的组名称和组 ID。 有关详细信息,请参阅下面的“方案”表。
  • 来自 Geotab 的数据将高度规范化,默认情况下,Geotab (LogRecord) 源将遵循固定的方案。 Geotab (LogRecord) 源将自动设置位置、日期和时间以及追踪 ID。 可以更改追踪 ID 字段。
  • 可以提供可选的诊断 ID,以便使用其他属性值对方案进行增强。 例如,如果车辆配备有用于监控总燃料用量的传感器,则提供 DiagnosticDeviceTotalFuelId 诊断 ID 将导致该源在新的属性字段中收集该特定信息。 诊断字段将反映在源方案中。
  • 可以指定一个或多个可选组,以限制可从 Geotab (LogRecord) 源检索的设备数据类型。
  • 可以将包含驾驶员信息的其他字段追加到 Geotab (LogRecord) 源的默认方案。 仅选择具有 Geotab 提供的值的字段。 如果字段未知,值可能为空、空字符串或包含 Geotab 预定义的字符串。 有关其他信息,请参阅下面的“其他字段”表。
  • 建议将轮询 Geotab 数据的间隔设置为每 30 秒或更长时间。 有关详细信息,请参阅 Geotab 文档中的速率限制

方案

下表列出了可用于 Geotab (LogRecord) 源的方案属性及其数据类型:

属性数据类型

device_id

字符串

vehicleName

字符串

vehicleSerialNumber

字符串

vin

字符串

vehicleEngineType

字符串

vehicleLicensePlate

字符串

vehicleLicenseState

字符串

deviceType

字符串

dateTime

字符串

latitude

Float64

longitude

Float64

speed

Float64

groupIds

字符串

groupNames

字符串

附加字段

下表列出了可用于 Geotab (LogRecord) 源的其他属性及其数据类型:

属性数据类型

firstName

字符串

lastName

字符串

phoneNumber

字符串

phoneNumberExtension

字符串

employeeNo

字符串

id

字符串

name

字符串

companyName

字符串

参数

下表列出了 Geotab (LogRecord) 源参数:

参数描述数据类型

URL

用于对 Geotab 进行身份验证的 URL。 URL 的形式通常为 https://[myserver].geotab.com/apiv1

字符串

数据库

Geotab 数据库的名称。

字符串

用户名

用于对 Geotab 进行身份验证的用户名。

字符串

密码

用于对 Geotab 进行身份验证的密码。

密码

组(可选)

用于过滤实体成员的可选组名称。 例如,道路清扫车辆可能属于名为 Sweepers 的组。 系统仅会为实时处理检索属于 Sweepers 组实体成员的车辆。

注:

可以使用分号 (;) 指定多个组。

字符串

诊断 ID(可选)

用于获取诊断值的可选诊断 ID。 例如,DiagnosticDeviceTotalFuelId 是用于从配备有合适传感器车辆中检索总燃料消耗的诊断 ID。

系统将为每个诊断 ID 添加一个诊断值字段和一个诊断时间戳字段。

注:

可以使用分号 (;) 指定多个诊断 ID。

字符串

附加字段

可用于使用驱动程序信息丰富源方案的其他字段列表。

注:

仅选择具有 Geotab 提供的值的字段。 否则,生成的字段值可能为空、空字符串或包含 Geotab 预定义的字符串。

字符串

其他日志记录

指定是否对 Velocity 发送到 Geotab API 的原始 HTTP 请求和响应进行日志记录。 设置此参数属于可选操作。

注:

仅启用此参数以进行故障排除,并在完成故障排除时禁用。 在启用参数后启动源,调试级别日志即会出现在源日志页面上。 如有必要,请联系 Esri 技术支持以获得故障排除方面的帮助。

布尔

注意事项和限制

使用 Geotab (LogRecord) 源时,请记住以下事项:

  • 在每个轮询间隔,Geotab 将提供它在上次轮询时编译的数据;在该轮询之后编译的数据将不包含在内。 提供的数据可能会早于源所发起的上次轮询的时间戳。
  • 诊断值将以不同于其他设备数据的速率更新。 因此,每个诊断字段都将具有对应的时间戳字段。 请考虑诊断值是否与从 Geotab 检索到的其他数据的最新时间戳在时间上相关。
  • 在指定唯一的诊断 ID 时,可以首先使用组来过滤来自 Geotab 的设备类型。 每个诊断 ID 都会使来自 Geotab 的所有车辆的方案得到增强。 例如,系统会将用于捕获扫雪车犁板状态的诊断追加到来自 Geotab 的所有车辆类型,而非仅仅追加到扫雪车。 对于没有传感器的车辆,该诊断值将为空。 如果首先定义了一个扫雪车组,则系统只会从 Geotab 中检索扫雪车,且会生成与相关扫雪车犁板状态相对应的自定义诊断字段。
  • 如果其他字段由 Geotab 在数据库中提供,则它们将仅包含值。 在选择其他字段之前,考虑组织的 Geotab 设备报告的信息。 不含值的字段将为空、空字符串或包含 Geotab 预定义的字符串。