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. 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 enumeran algunos ejemplos de casos de uso del feed:
- 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 al trabajar con el 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 sección Esquema que aparece más abajo.
- Los datos de Geotab están altamente normalizados y la fuente Geotab (LogRecord) feed sigue un esquema fijo de forma predeterminada. El feed 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 el feed recopila 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 más información, consulte la sección Campos adicionales más adelante.
- El intervalo recomendado para sondear datos de Geotab es cada 30 segundos o más.
Esquema
En la tabla siguiente figuran los atributos de esquema y los tipos de datos correspondientes para el feed:
| Atributo | Tipo 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 |
| latitude | Float64 |
| longitude | Float64 |
| speed | Float64 |
| groupIds | Cadena de caracteres |
| groupNames | Cadena de caracteres |
Campos adicionales
A continuación se indican los campos de atributos adicionales y los tipos de datos correspondientes para el feed:
| Atributo | Tipo 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
Los siguientes son los parámetros del feed:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
| URL | URL utilizada para autenticar Geotab, por ejemplo, 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 | Nombre de usuario utilizado para autenticar Geotab. | Cadena de caracteres |
| Contraseña | Contraseña utilizada 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. Para el procesamiento en tiempo real, solo se recuperan los vehículos que son miembros de entidad del grupo Sweepers. 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 obtener 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 |
| Registro adicional (opcional) | Especifica si el registro de solicitudes y las respuestas HTTP sin procesar emitidas por Velocity a la API de Geotab están activadas. Nota:Active este parámetro para la localización de averías y desactívelo cuando haya finalizado. Una vez activado, inicie el feed; los registros del nivel de depuración estarán disponibles en la página de registros del feed. Si es necesario, póngase en contacto con el equipo de Esri técnico de Soporte para que le ayuden a solucionar los problemas. | Booleano |
Consideraciones y limitaciones
- 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 que provengan de Geotab. 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 incorpora a todos los tipos de vehículos desde Geotab, no solo a los vehículos quitanieves. En los vehículos sin sensor, el valor de diagnóstico es nulo. Si se define primero un grupo de quitanieves, solo se recuperan los camiones quitanieves de Geotab y se incluye el campo de diagnóstico personalizado para el estado relevante de la pala quitanieves.
- Los campos adicionales solo tienen 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 cualquier campo adicional. Los campos sin un valor son nulos, una cadena de caracteres vacía o contienen una cadena predefinida de Geotab.
- Si las credenciales del usuario no son válidas, el feed vuelve a intentar la conexión hasta tres veces. En los registros aparecen errores de credenciales no válidas. El feed intenta reiniciarse automáticamente tras un retraso, según el programa de recurrencia configurado.