{"id":14021,"date":"2025-05-08T09:35:07","date_gmt":"2025-05-08T06:35:07","guid":{"rendered":"https:\/\/www.fmsdocumentation.com\/api\/coordinate-delloggetto-api-di-streaming\/"},"modified":"2025-05-08T09:35:09","modified_gmt":"2025-05-08T06:35:09","slug":"coordinate-delloggetto-api-di-streaming","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/it\/api\/coordinate-delloggetto-api-di-streaming\/","title":{"rendered":"Coordinate dell’oggetto API di streaming"},"content":{"rendered":"\n

\n\nLo scopo principale delle API Object Coordinates Streaming \u00e8 quello di informare l’utente sui cambiamenti degli oggetti. Questa particolare API funziona come un flusso di informazioni, utilizzando la tecnologia SSE (server sent events)<\/a>. Una volta che l’utente ha inviato una richiesta API, per prima cosa viene visualizzata l’ultima coordinata nota per ogni oggetto, dopodich\u00e9 i nuovi dati verranno inviati all’utente non appena si verifica un cambiamento. Non \u00e8 necessario inviare nuovamente la richiesta API, a meno che la connessione allo streaming non sia stata interrotta. \n\n<\/p>\n\n

\"Questa<\/figure>\n\n

NoteSince the API first returns the last known coordinate, in cases when the API stream was ongoing and for some reason reconnected, with no new coordinates received between that time, the user will receive the last know coordinate, which has already been received once, thus duplicating the coordinate record. This should be kept in mind, since it may cause issues in various systems.<\/p><\/p>\n\n

Coordinate dell’oggetto Lo streaming API pu\u00f2 essere avviato sia per un oggetto specifico che per tutti gli oggetti disponibili all’utente.<\/p>\n\n

Esempio di richiesta per un oggetto specifico:<\/p>\n\n

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

\n\nEsempio di richiesta per tutti gli oggetti dei clienti:\n\n<\/p>\n\n

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

Affinch\u00e9 questa API funzioni, sono obbligatori solo due parametri:<\/p>\n\n\n\n\n\t\n\n\t\n\t
Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
version<\/td>String<\/td>Version of the API, currently only version=1 is available<\/td>\n<\/tr>\n
api_key<\/td>User identification key<\/td><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n

E solo un parametro opzionale pu\u00f2 essere incluso nella richiesta:<\/p>\n\n\n\n\n\t\n\n\t
Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>String<\/td>External object ID<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n

Risposta dal server:<\/p>\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
Tutti i campi di risposta che possono essere ricevuti con ogni tipo di parametro sono descritti nella tabella successiva:<\/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
Name<\/th>Type<\/th>Description<\/th>Units<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>String<\/td>Object identifier in our system<\/td>Text<\/td>\n<\/tr>\n
datetime<\/td>Date<\/td>Date and time point of coordinate generated in hardware
\nFormat: \"yyyy-mm-ddThh:mm:ss.sssZ\"
\n<\/td>		According ISO8601<\/td>\n<\/tr>\n
ignition_status<\/td>Enum<\/td>Indicating if object has ignition on.
\n\"ON\" - Ignition on
\n\"OFF\" - Ignition off
\n\"UNKNOWN\" - No data about ignition
\n<\/td>		ON - OFF<\/td>\n<\/tr>\n
position<\/td>Array<\/td>Contains all record GPS parameters<\/td><\/td>\n<\/tr>\n
latitude<\/td>Float<\/td>GPS coordinate - latitude value<\/td>Degrees<\/td>\n<\/tr>\n
longitude<\/td>Float<\/td>GPS coordinate - longitude value<\/td>Degrees<\/td>\n<\/tr>\n
altitude<\/td>Integer<\/td>GPS coordinate - altitude value<\/td>Number<\/td>\n<\/tr>\n
direction<\/td>Integer<\/td>Moving direction in degrees<\/td>0 = north, increasing clock-wise<\/td>\n<\/tr>\n
speed<\/td>Integer<\/td>Object moving speed<\/td>km\/h<\/td>\n<\/tr>\n
satellites_count<\/td>Integer<\/td>Number of visible GPS or GLONASS satellites(depends on device configuration) while generating record in device<\/td>Number<\/td>\n<\/tr>\n
device_inputs<\/td>Container for parameters received from hardware<\/td><\/td><\/td>\n<\/tr>\n
power_supply_voltage<\/td>Integer<\/td>Object power supply voltage<\/td>mV<\/td>\n<\/tr>\n
ibutton<\/td>String<\/td>iButton or RFID card code of a driver assigned to a vehicle<\/td>Text<\/td>\n<\/tr>\n
hdop<\/td>Float<\/td>GPS precision<\/td>Number<\/td>\n<\/tr>\n
first_driver_id<\/td>String<\/td>TCO code of the first driver<\/td>Text<\/td>\n<\/tr>\n
second_driver_id<\/td>String<\/td>TCO code of the second driver<\/td>Text<\/td>\n<\/tr>\n
digital_input_1<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
digital_input_2<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
digital_input_3<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
digital_input_4<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
temperature_sensor_0<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_1<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_2<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_3<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_0_id<\/td>String<\/td>Temperature sensor ID<\/td>Text<\/td>\n<\/tr>\n
calculated_inputs<\/td>Array<\/td><\/td><\/td>\n<\/tr>\n
mileage<\/td>float<\/td>Object driven distance (depends on object configuration)<\/td>km<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
Gli endpoint API, i parametri di richiesta e le risposte possono essere visualizzati in anteprima in “Swagger” attraverso questo link: https: \/\/api.fm-track.com<\/a><\/p>\n
Nota
Tieni presente che la risposta del server \u00e8 un flusso di dati, gli stessi che vengono ricevuti dal dispositivo. Tutti i dati ricevuti sono forniti “cos\u00ec come sono”. Ci\u00f2 significa che il dispositivo pu\u00f2 inviare periodicamente le coordinate di una posizione precedente tra le registrazioni della posizione attuale. L’API non controlla n\u00e9 gestisce la continuit\u00e0 dei dati ricevuti.   <\/p><\/p>\n
\n
\u2039   <\/span> Cronologia delle coordinate degli oggetti API v2 <\/a><\/div> 
Coordinate degli oggetti API di streaming v2   \u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Lo scopo principale delle API Object Coordinates Streaming \u00e8 quello di informare l’utente sui cambiamenti degli oggetti. Questa particolare API funziona come un flusso di informazioni, utilizzando la tecnologia SSE (server sent events). Una volta che l’utente ha inviato una richiesta API, per prima cosa viene visualizzata l’ultima coordinata nota per ogni oggetto, dopodich\u00e9 i … Continua a leggere Coordinate dell’oggetto API di streaming<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":14003,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-14021","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14021","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/comments?post=14021"}],"version-history":[{"count":1,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14021\/revisions"}],"predecessor-version":[{"id":14022,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14021\/revisions\/14022"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/14003"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/media?parent=14021"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}