El tipo de feed Samsara de ArcGIS Velocity envía solicitudes HTTPS a la URL de la API de Samsara especificada con parámetros relevantes.
Ejemplos
A continuación se enumeran algunos ejemplos de casos de uso del feed:
- La API de Samsara con la URL https://api.samsara.com/fleet/vehicles/stats?types=gps se consulta cada cinco segundos para recuperar la ubicación actual de los vehículos y estadísticas relevantes.
- La API de Samsara con la URL https://api.samsara.com/fleet/equipment/locations se consulta cada minuto para recuperar la ubicación actual del equipo.
- Cualquier extremo de solicitud GET de la API de Samsara (v2) que devuelva un objeto de datos y paginación en la respuesta JSON.
Notas de uso
Tenga en cuenta lo siguiente al trabajar con el feed:
- El feed Samsara sondea la URL de la API de Samsara para cargar los datos a la velocidad especificada en el paso Intervalo de sondeo de feed del asistente de configuración.
Nota:
El feed no debe configurarse para que se ejecute con una frecuencia superior a la que la API de Samsara puede devolver entidades.
- Cuando se establece un intervalo de sondeo, el sondeo se produce en intervalos de tiempo regulares en lugar de a la hora de inicio del feed. Por ejemplo, si un feed está configurado para realizar un sondeo de datos cada cinco minutos y el feed se inicia a las 8:03 de la mañana, la primera solicitud de datos se realiza a las 8:05 de la mañana, la próxima, a las 8:10, y así sucesivamente.
- Los niveles de licencia de suscripción de Velocity tienen límites en cuanto a la cantidad de datos que puede incorporar un feed, como se resume a continuación. Si los feeds superan el límite de procesamiento de su nivel de licencia, se escribe un mensaje en los registros y se envía un correo electrónico en el que se indica que se ha alcanzado el límite. Si el procesamiento de datos se mantiene por encima del límite durante más de una hora, el feed se interrumpe. Si es necesario, póngase en contacto con su representante de Esri o el Soporte técnico de Esri para explorar los niveles de licencia de Velocity compatibles con sus flujos de trabajo. Los niveles de licencia son los siguientes:
- Standard: incorpora y procesa datos a 25 KB por segundo (unos 100 eventos por segundo aproximadamente).
- Advanced: incorpora y procesa datos a 250 KB por segundo (unos 1000 eventos por segundo aproximadamente).
- Dedicated: incorpora y procesa datos a 2500 KB por segundo (unos 10.000 eventos por segundo aproximadamente).
- Los parámetros de URL admiten variables globales de feed. De forma predeterminada, las variables globales de feed se convierten en tiempo Epoch (milisegundos desde el 1 de enero de 1970 UTC). Opcionalmente, puede convertir las variables globales de feed a segundos de Epoch (segundos desde el 1 de enero de 1970) y a una cadena de caracteres de formato de fecha y hora. A continuación, se enumeran las variables de análisis del feed y el momento que representan. La primera vez que el alimentador funcione después de arrancar o reiniciar, $feed.FeedLastScheduledStartTime es $feed.FeedScheduledStartTime menos el valor del paso Intervalo de sondeo de feed. Esto permite que el feed reciba datos desde la hora de inicio ajustada hasta la hora actual, lo que evita la ingesta de un volumen elevado de datos históricos.
- $feed.FeedStartTime: la hora de inicio del feed
- $feed.FeedScheduledStartTime: la hora a la que está programada la próxima recurrencia del feed
- $feed.FeedLastScheduledStartTime: la hora a la que se programó la última recurrencia del feed
- El feed de Samsara procesa automáticamente la respuesta JSON de la API de Samsara en el objeto data devuelto, y aplana el JSON.
- Puede aplanar matrices y proporcionar exenciones específicas de aplanamiento de matrices. Separe las exenciones de aplanamiento de matrices múltiples con comas.
- Velocity gestiona automáticamente las respuestas paginadas de la API de Samsara para procesar todas las funciones.
- Después de configurar los parámetros de conexión de feed, defina el esquema y los parámetros de campo clave.
- Al utilizar un feed de la lista desplegable del extremo de Samsara, los tipos se pueden especificar en los parámetros de URL (por ejemplo, gps, engineStates).
Parámetros
Los siguientes son los parámetros del feed:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
| Extremo de Samsara | Especifica la URL de la API de Samsara. Entre los extremos compatibles de Samsara se incluyen los siguientes:
| URL de la API de Samsara |
| URL (Condicional) | La URL personalizada de la API de Samsara. Este debe ser un extremo de solicitud GET de la API de Samsara, ya que el feed está obteniendo datos para su ingestión. La URL, junto con los parámetros de URL proporcionados, controla los datos que devuelve la API de Samsara. Este parámetro está disponible cuando el parámetro Extremo de Samsara se establece en la opción Otros. | Cadena de caracteres |
| Clave de API | La clave de la API de Samsara. Proporcione la clave de la API en el siguiente formato: samsara_api_<yourAPIKey>. | Cadena de caracteres |
| Cargar solo datos recientes (Condicional) | Cargue únicamente los datos más recientes tras la carga inicial de datos. Cuando este parámetro está activado, el feed procesa todos los datos en la primera ejecución y, en las ejecuciones posteriores, solo las actualizaciones recientes. Este parámetro solo se admite para los dos extremos de Samsara siguientes:
| Booleano |
| Parámetros de la URL (Opcional) | Parámetros de URL que se incluirán en la URL de la solicitud HTTP enviada a la URL de Samsara especificada. Aunque los parámetros también se pueden establecer en el parámetro URL, los parámetros de URL introducidos aquí invalidan cualquier parámetro coincidente suministrado en el parámetro URL. Los parámetros definidos aquí siempre tienen codificación URL. Este parámetro admite variables globales de feed. | Par de clave-valor |
| Variables globales | Convierta las variables globales de feed a un formato de fecha y de hora personalizado. | Cadena de caracteres |
| Registro adicional (Opcional) | Active este parámetro para especificar si se pueden registrar solicitudes y respuestas HTTP sin procesar emitidas por Velocity en la URL de Samsara. 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
Plantéese lo siguiente al utilizar el feed:
- Para utilizar este tipo de feed se requiere una suscripción a Samsara y una clave de la API.
- La actual generación de interfaces API de Samsara utiliza el formato RFC 3339 para las marcas de tiempo. Para configurarlo, defina el parámetro Hora de inicio en el campo con esta cadena de fecha y hora y proporcione un formato de cadena de caracteres de fecha y hora de yyyy-MM-dd'T'HH:mm:ss'Z'.
- La API de Samsara se puede sondear cada cinco segundos.
- 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.