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
Los siguientes son ejemplos de uso del feed Samsara:
- 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 Samsara:
- 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, tal y 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/segundo (unos 100 eventos por segundo aproximadamente).
- Advanced: incorpora y procesa datos a 250 KB/segundo (unos 1000 eventos por segundo aproximadamente).
- Dedicated: incorpora y procesa datos a 2500 KB/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 describen las variables de análisis de feed y el tiempo que representan. La primera vez que el alimentador funcione después de arrancar o reiniciar, el tiempo $feed.FeedLastScheduledStart será el tiempo de funcionamiento actual menos cinco minutos.
- $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.
Parámetros
A continuación se indican los parámetros del feed Samsara:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
URL | La URL 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. Para encontrar la URL del extremo de la API de Samsara, consulte la descripción general de la API de Samsara. | 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 |
Parámetros de la URL | Parámetros de URL opcionales 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 hora personalizado. Este parámetro es opcional. | Cadena de caracteres |
Registro adicional | Especifica si se activa el registro de solicitudes y respuestas HTTP sin procesar emitidas por Velocity a la URL de Samsara. Este parámetro es opcional. Nota:Active este parámetro únicamente para resolver problemas y desactívelo una vez que estén resueltos. Una vez activado, inicie el feed; los registros del nivel de depuración están disponibles en la página de registros del feed. Si es necesario, póngase en contacto con el Esri técnico de Soporte para que le ayude a solucionar los problemas. | Booleano |
Consideraciones y limitaciones
A continuación se indican las consideraciones y limitaciones de uso del feed Samsara:
- 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 fecha y hora de yyyy-MM-dd'T'HH:mm:ss'Z'.
- La API de Samsara se puede sondear cada cinco segundos.