{"id":2079,"date":"2017-04-21T08:34:44","date_gmt":"2017-04-21T08:34:44","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/status-api\/"},"modified":"2019-07-12T12:49:25","modified_gmt":"2019-07-12T10:49:25","slug":"api-de-streaming-de-coordenadas-de-objeto","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/es\/api\/api-de-streaming-de-coordenadas-de-objeto\/","title":{"rendered":"API de streaming de coordenadas de objeto"},"content":{"rendered":"\n

\n\nEl prop\u00f3sito principal de la API de streaming de coordenadas de objeto es informar al usuario sobre cambios del objeto. Esta API funciona como un stream de informaci\u00f3n, usando tecnolog\u00eda SSE (eventos enviados por servidor)<\/a>. Al enviar una solicitud de API, al principio se muestra la \u00faltima conocida coordenada para cada objeto, luego se mostrar\u00e1n datos nuevos tan pronto como se ocurren cambios. No hay necesidad de enviar la solicitud de API de nuevo a menos que no hay conectividad de streaming\n\n<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Note
Debido a que la API devuelve la \u00faltima conocida coordenada, en los casos cuando el streaming de la API estaba activo y tuvo que reconectarse por alguna raz\u00f3n sin recibir coordenadas nuevas, el usuario recibir\u00e1 la \u00faltima conocida coordenada, duplicando el registro de coordenada. Hay que tener esto en cuenta, porque puede producir problemas en algunos sistemas.\n\nSe puede iniciar el streaming de la API para un objeto espec\u00edfico o todos los objetos disponibles para el usuario.<\/p><\/p>\n\n\n\n

\n\nEjemplo de solicitud para un objeto espec\u00edfico:\n\n<\/p>\n\n\n\n

GET \/object-coordinates-stream?version=1&object_id=<…>&api_key=<…>
HOST:api.fm-track.com
Content-Type:text\/event-stream;charset=UTF-8<\/p>\n\n\n\n

\n\nEjemplo de solicitud para todos los objetos disponibles:\n\n<\/p>\n\n\n\n

GET \/object-coordinates-stream?version=1&api_key=<…>
HOST:api.fm-track.com
Content-Type:text\/event-stream;charset=UTF-8<\/p>\n\n\n\n

Dos par\u00e1metros son obligatorios para que funcione esta API:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
version<\/td>Cadena<\/td>Versi\u00f3n de la API, actualmente solo version=1 est\u00e1 disponible<\/td>\n<\/tr>\n
api_key<\/td>Cadena<\/td>Clave de identificaci\u00f3n del usuario<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n

Se puede incluir un par\u00e1metro adicional a la solicitud:<\/p>\n\n\n\n\n\n\n\t\n\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>Cadena<\/td>ID del objeto externo<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n

Respuesta del servidor:<\/p>\n\n\n\n

\n
{\n    \"object_id\" : \"abc123\",\n    \"datetime\" : \"2017-04-13T06:58:48.090Z\",\n    \"ignition_status\" : \"UNKNOWN\",\n    \"position\" : {\n        \"altitude\" : 0,\n        \"direction\" : 0,\n        \"latitude\" : 0,\n        \"longitude\" : 0,\n        \"hdop\": 0,\n        \"satellites_count\" : 0,\n        \"speed\" : 0\n    },\n    \"device_inputs\" : {\n        \"digital_input_1\" : true,\n        \"digital_input_2\" : true,\n        \"digital_input_3\" : true,\n        \"digital_input_4\" : true,\n        \"power_supply_voltage\" : 0,\n        \"ibutton\" : \"xxxxxxxxxx\",\n        \"first_driver_id\" : \"xxxxxxxxxx\",\n        \"second_driver_id\" : \"xxxxxxxxxx\",\n         \"temperature_sensor_0\": 0,\n         \"temperature_sensor_1\": 0,\n         \"temperature_sensor_2\": 0,\n         \"temperature_sensor_3\": 0,\n         \"temperature_sensor_0_id\": \"xxxxxxxxxx\"\n    },\n    \"calculated_inputs\":{\n        \"mileage\" : 0\n    }\n}<\/pre>\n<\/div>\n\n\n
Todos los par\u00e1metros de respuesta que se puede recibir:<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>Unidades<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>Cadena<\/td>Identificador del objeto en el sistema<\/td>Texto<\/td>\n<\/tr>\n
datetime<\/td>Fecha y hora<\/td>La fecha y hora de coordenada, generada en el hardware. Formato: \"yyyy-mm-ddThh:mm:ss.sssZ\"<\/td>Seg\u00fan ISO8601<\/td>\n<\/tr>\n
ignition_status<\/td>Enum<\/td>Indica el estado de ignici\u00f3n del objeto.
\n\"ON\" - Ignici\u00f3n encendida 
\n\"OFF\" - Ignici\u00f3n apagada
\n\"UNKNOWN\" - No hay datos de ignici\u00f3n
\n<\/td>		ON - OFF<\/td>\n<\/tr>\n
position<\/td>Array<\/td>Contiene todos los par\u00e1metros de registros GPS<\/td><\/td>\n<\/tr>\n
latitude<\/td>Decimal<\/td>Coordenada GPS - valor de latitud<\/td>Grados<\/td>\n<\/tr>\n
longitude<\/td>Decimal<\/td>Coordenada GPS - valor de longitud<\/td>Grados<\/td>\n<\/tr>\n
altitude<\/td>N\u00famero entero<\/td>Coordenada GPS - valor de altitud<\/td>N\u00famero<\/td>\n<\/tr>\n
direction<\/td>N\u00famero entero<\/td>Direcci\u00f3n de movimiento en grados<\/td>0 = norte, creciente en el sentido horario<\/td>\n<\/tr>\n
speed<\/td>N\u00famero entero<\/td>Velocidad del objeto en movimiento<\/td>km\/h<\/td>\n<\/tr>\n
satellites_count<\/td>N\u00famero entero<\/td>Cantidad de visibles sat\u00e9lites GPS o GLONASS (depende de la configuraci\u00f3n del dispositivo) al generar el registro en el dispositivo<\/td>N\u00famero<\/td>\n<\/tr>\n
device_inputs<\/td>Array<\/td>Contiene los par\u00e1metros recibidos desde el hardware<\/td><\/td>\n<\/tr>\n
power_supply_voltage<\/td>N\u00famero entero<\/td>Voltaje de fuente de alimentaci\u00f3n del dispositivo<\/td>mV<\/td>\n<\/tr>\n
ibutton<\/td>Cadena<\/td>C\u00f3digo de iButton o tarjeta RFID de un conductor asignado a un veh\u00edculo<\/td>Texto<\/td>\n<\/tr>\n
hdop<\/td>Decimal<\/td>Precisi\u00f3n de coordenada GPS<\/td>N\u00famero<\/td>\n<\/tr>\n
first_driver_id<\/td>Cadena<\/td>C\u00f3digo de tac\u00f3grafo del primer conductor<\/td>Texto<\/td>\n<\/tr>\n
second_driver_id<\/td>Cadena<\/td>C\u00f3digo de tac\u00f3grafo del segundo conductor<\/td>Texto<\/td>\n<\/tr>\n
digital_input_1<\/td>Booleano<\/td>Estado del objeto configurado o su equipo: 
\nTrue - activo 
\nFalse - inactivo<\/td>		True - False (Verdadero - Falso)<\/td>\n<\/tr>\n
digital_input_2<\/td>Booleano<\/td>Estado del objeto configurado o su equipo: 
\nTrue - activo 
\nFalse - inactivo<\/td>		True - False (Verdadero - Falso)<\/td>\n<\/tr>\n
digital_input_3<\/td>Booleano<\/td>Estado del objeto configurado o su equipo: 
\nTrue - activo 
\nFalse - inactivo<\/td>		True - False (Verdadero - Falso)<\/td>\n<\/tr>\n
digital_input_4<\/td>Booleano<\/td>Estado del objeto configurado o su equipo: 
\nTrue - activo 
\nFalse - inactivo<\/td>		True - False (Verdadero - Falso)<\/td>\n<\/tr>\n
temperature_sensor_0<\/td>Decimal<\/td>Datos de sensor de temperatura<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_1<\/td>Decimal<\/td>Datos de sensor de temperatura<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_2<\/td>Decimal<\/td>Datos de sensor de temperatura<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_3<\/td>Decimal<\/td>Datos de sensor de temperatura<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_0_id<\/td>Cadena<\/td>ID de sensor de temperatura<\/td>Texto<\/td>\n<\/tr>\n
calculated_inputs<\/td>Array<\/td>Contiene los par\u00e1metros calculados en el sistema desde otros par\u00e1metros, seg\u00fan la configuraci\u00f3n<\/td><\/td>\n<\/tr>\n
mileage<\/td>Decimal<\/td>Distancia recorrida por el dispositivo (depende de la configuraci\u00f3n del dispositivo)<\/td>km<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
\u00a0<\/p>\n
Se puede ver los puntos finales de API, los par\u00e1metros de solicitudes y las respuestas en \u201cSwagger\u201d haciendo clic en este enlace:\u00a0https:\/\/api.fm-track.com<\/a><\/p>\n
Nota
Por favor tenga en cuenta que la respuesta del servidor es un stream de datos, de los mismos datos, recibidos desde el dispositivo. Todos los datos recibidos se proporcionan “como est\u00e1n”. Esto significa que el dispositivo puede peri\u00f3dicamente enviar coordenadas de una ubicaci\u00f3n previa entre registros de la ubicaci\u00f3n actual. La API no comprueba o gestiona la continuidad de los datos recibidos.<\/p><\/p>\n
\n
\u2039   <\/span> API de historial de coordenadas de objeto v2 <\/a><\/div> 
API de streaming de coordenadas de objeto v2   \u203a <\/span> <\/a><\/div><\/p>","protected":false},"excerpt":{"rendered":"
El prop\u00f3sito principal de la API de streaming de coordenadas de objeto es informar al usuario sobre cambios del objeto. Esta API funciona como un stream de informaci\u00f3n, usando tecnolog\u00eda SSE (eventos enviados por servidor). Al enviar una solicitud de API, al principio se muestra la \u00faltima conocida coordenada para cada objeto, luego se mostrar\u00e1n … Sigue leyendo API de streaming de coordenadas de objeto<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2084,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2079","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2079","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/comments?post=2079"}],"version-history":[{"count":10,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2079\/revisions"}],"predecessor-version":[{"id":8098,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2079\/revisions\/8098"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2084"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/media?parent=2079"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}