Geotab (LogRecord)

El tipo de feed Geotab (LogRecord) de ArcGIS Velocity sondea periódicamente una base de datos de geoetiquetas con datos de ubicación de vehículos (AVL) automáticos en tiempo real mediante el envío de una solicitud HTTP a una URL determinada. Para obtener más información acerca de Geotab, consulte Acerca de Geotab en la documentación de Geotab. El tipo de fuente Geotab (LogRecord) difiere del tipo de fuente Geotab (DeviceStatusInfo) al solicitar datos de la tabla LogRecord de la base de datos Geotab. Por lo general, la tabla LogRecord se actualiza con más frecuencia que la tabla DeviceStatusInfo de la base de datos Geotab, aunque contiene menos atributos que la tabla DeviceStatusInfo. Esto permite que una fuente de Geotab (LogRecord) reciba actualizaciones de ubicación con más frecuencia.

Ejemplos

A continuación se muestran ejemplos de usos de la fuente Geotab (LogRecord):

  • Un municipio desea monitorizar su flota de quitanieves durante la estación invernal. El feed Geotab (LogRecord) se utiliza para observar la ubicación en tiempo real de cada vehículo y recopilar otra información auxiliar como, por ejemplo, si la pala frontal está en uso o si los depósitos de sal de descongelación están en un umbral bajo.
  • Una empresa de gestión de residuos desea mejorar la eficiencia de su flota mediante análisis basados en datos. El feed Geotab (LogRecord) se utiliza para recopilar la ubicación, el conductor, el peso de carga, el tiempo de inactividad y el nivel de combustible de cada vehículo en tiempo real.

Notas de uso

Tenga en cuenta lo siguiente a la hora de trabajar con la fuente Geotab (LogRecord) feed:

  • El feed Geotab (LogRecord) construye eventos que utilizan los datos de tablas de la base de datos de Geotab. Por ejemplo, los atributos de ubicación, velocidad y rumbo se recuperan de la tabla LogRecord. La tabla Dispositivo se utiliza para recuperar información de atributos adicional, como número de chasis, la matrícula del vehículo, etc. Los nombres de grupo y los Id. de grupo asociados a cada dispositivo se obtienen de la tabla Grupo. Para obtener más información, consulte la tabla Esquema a continuación.
  • Los datos de Geotab están altamente normalizados y la fuente Geotab (LogRecord) feed sigue un esquema fijo de forma predeterminada. El feed de Geotab (LogRecord) define automáticamente la ubicación, la fecha y la hora y el Id. de rastreo. El campo de Id. de rastreo es modificable.
  • Es posible proporcionar Id. de diagnóstico opcionales para mejorar el esquema con valores de atributo adicionales. Por ejemplo, si un vehículo está equipado con un sensor para monitorizar el consumo total de combustible, al proporcionar el Id. de diagnóstico DiagnosticDeviceTotalFuelId causa que el feed recopile esta información específica en un nuevo campo de atributo. Los campos de diagnóstico se reflejan en el esquema del feed.
  • Se pueden especificar uno o varios grupos opcionales para limitar el tipo de datos de dispositivo que se recupera del feed Geotab (LogRecord).
  • Es posible incorporar campos adicionales con información del conductor al esquema predeterminado del feed Geotab (LogRecord). Elija solo campos que tengan valores proporcionados por Geotab. Si un campo es desconocido, el valor puede ser nulo, una cadena de caracteres vacía o contener una cadena predefinida por Geotab. Para obtener información adicional, consulte la tabla Campos adicionales a continuación.
  • El intervalo recomendado para sondear datos de Geotab es cada 30 segundos o más. Para obtener más información, consulte Límites de frecuencia en la documentación de Geotab.

Esquema

En la tabla siguiente figuran los atributos de esquema y los tipos de datos disponibles para la fuente Geotab (LogRecord) feed:

AtributoTipo de datos

device_id

Cadena de caracteres

vehicleName

Cadena de caracteres

vehicleSerialNumber

Cadena de caracteres

vin

Cadena de caracteres

vehicleEngineType

Cadena de caracteres

vehicleLicensePlate

Cadena de caracteres

vehicleLicenseState

Cadena de caracteres

deviceType

Cadena de caracteres

dateTime

Cadena de caracteres

latitud

Float64

longitud

Float64

velocidad

Float64

groupIds

Cadena de caracteres

groupNames

Cadena de caracteres

Campos adicionales

En la tabla siguiente figuran los atributos adicionales y los tipos de datos disponibles para la fuente Geotab (LogRecord) feed:

AtributoTipo de datos

firstName

Cadena de caracteres

lastName

Cadena de caracteres

phoneNumber

Cadena de caracteres

phoneNumberExtension

Cadena de caracteres

employeeNo

Cadena de caracteres

id

Cadena de caracteres

name

Cadena de caracteres

companyName

Cadena de caracteres

Parámetros

En la tabla siguiente figuran los parámetros de Geotab (LogRecord):

ParámetroDescripciónTipo de datos

URL

La URL utilizada para autenticar con Geotab. Normalmente, la URL tiene el formato de https://[myserver].geotab.com/apiv1.

Cadena de caracteres

Base de datos

El nombre de la base de datos de Geotab.

Cadena de caracteres

Nombre de usuario

El nombre de usuario para autenticar Geotab.

Cadena de caracteres

Contraseña

La contraseña para autenticar Geotab.

Contraseña

Grupos (opcional)

Nombres de grupo opcionales utilizados para filtrar por miembros de entidades. Por ejemplo, las barredoras pueden pertenecer a un grupo llamado Sweepers. Solo los vehículos que son miembros de entidad del grupo Sweepers se recuperarán para el procesamiento en tiempo real.

Nota:

Especifique varios grupos mediante un punto y coma (;).

Cadena de caracteres

Id. de diagnóstico (opcionales)

Id. de diagnóstico opcionales utilizados para obtener valores de diagnóstico. Por ejemplo, DiagnosticDeviceTotalFuelId es el Id. de diagnóstico utilizado para recuperar el consumo de combustible total de los vehículos equipados con el sensor correcto.

Se agrega un campo de valor de diagnóstico y un campo de marca de tiempo de diagnóstico para cada Id. de diagnóstico.

Nota:

Especifique varios Id. de diagnóstico con un punto y coma (;).

Cadena de caracteres

Campos adicionales

Lista de campos adicionales que puede utilizarse para enriquecer el esquema del feed con información del conductor.

Nota:

Elija solo campos que tengan valores proporcionados por Geotab. De lo contrario, el valor resultante de los campos puede ser nulo o una cadena de caracteres vacía o contener una cadena predefinida por Geotab.

Cadena de caracteres

Consideraciones y limitaciones

Tenga en cuenta lo siguiente cuando utilice la fuente feed Geotab (LogRecord):

  • En cada intervalo de sondeo, Geotab proporciona los datos que recopiló en el último sondeo; los datos recopilados después de ese sondeo no se incluyen. Los datos proporcionados pueden ser anteriores a la marca de tiempo del último sondeo realizado por el feed.
  • Los valores de diagnóstico se actualizan con una frecuencia distinta a la de otros datos de dispositivos. Por este motivo, cada campo de diagnóstico va acompañado de un campo de marca de tiempo. Considere si los valores de diagnóstico son temporalmente relevantes para la marca de tiempo más reciente de los otros datos recuperados de Geotab.
  • Al especificar Id. de diagnóstico únicos, puede utilizar grupos para filtrar el tipo de dispositivos de Geotab en primer lugar. Cada Id. de diagnóstico mejora el esquema de todos los vehículos provenientes de Geotab. Por ejemplo, un diagnóstico que captura el estado de una quitanieves se incorporará a todos los tipos de vehículos desde Geotab, no solo a los vehículos quitanieves. El valor de diagnóstico será nulo en el caso de los vehículos que carecen del sensor. Si se define primero un grupo de quitanieves, solo se recuperarán los vehículos quitanieves de Geotab y el campo de diagnóstico personalizado para el estado de la pala quitanieves pertinente.
  • Los campos adicionales solo tendrán valores si Geotab los proporciona en la base de datos. Tenga en cuenta la información proporcionada por los dispositivos Geotab de su organización antes de elegir campos adicionales. Los campos sin un valor serán nulos o una cadena de caracteres vacía o contendrán una cadena predefinida por Geotab.