{"id":13858,"date":"2025-05-07T15:27:13","date_gmt":"2025-05-07T12:27:13","guid":{"rendered":"https:\/\/www.fmsdocumentation.com\/api-viaggi\/"},"modified":"2025-05-08T09:35:06","modified_gmt":"2025-05-08T06:35:06","slug":"api-viaggi","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/it\/api\/api-viaggi\/","title":{"rendered":"API Viaggi"},"content":{"rendered":"\n

L’API Trips \u00e8 dedicata all’output della cronologia dei viaggi dell’oggetto per il periodo richiesto.<\/p>\n\n

Struttura della richiesta:<\/p>\n\n

GET \/objects\/{objectId}\/trips?version=1&from_datetime=<..>&to_datetime=<..>&continuation_token=<..>&limit=<..>&api_key=<..> HTTP\/1.1\nHOST:api.fm-track.com\nContent-Type:application\/json;charset=UTF-8<\/p>\n\n

Parametri della richiesta:<\/p>\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Parameter<\/th>Type<\/th>Description<\/th>Required<\/th>\n<\/tr>\n<\/thead>\n
objectId<\/td>String<\/td>External object ID<\/td>Yes<\/td>\n<\/tr>\n
from_datetime<\/td>Date time<\/td>Finds records starting from the specified date and time. Date and time format example: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>Yes<\/td>\n<\/tr>\n
to_datetime<\/td>Date time<\/td>Finds records ending at the specified date and time. Date and time format example: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>No<\/td>\n<\/tr>\n
continuation_token<\/td>Date time<\/td>Displays from what date and time the data is shown if the record limit was reached.<\/td>No<\/td>\n<\/tr>\n
limit<\/td>Integer<\/td>How many records will be included in the response (default value - 100 records, maximum value - 1000 records).<\/td>No<\/td>\n<\/tr>\n
version<\/td>String<\/td>API version<\/td>Yes<\/td>\n<\/tr>\n
api_key<\/td>String<\/td>User identification key<\/td>Yes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n

Esempio di risposta: <\/p>\n\n

{\n\t\"continuation_token\": \"2019-05-24T06:58:48.121Z\",\n\t\"trips\": [\n      {\n        \"object_id\": \"ID0000\",\n        \"trip_type\":\"BUSINESS\",\n        \"trip_duration\": 4781,\n        \"mileage\": 10.56,\n        \"driver_ids\": [\"asdf321\",\"123asdf\",\"fdsa123\"],\n        \"trip_start\": {\n          \"datetime\": \"2019-05-24T06:58:48.121Z\",\n          \"longitude\": 11.2222,,\n          \"latitude\": 33.444,\n          \"address\": {\n            \"country\": \"Denmark\",\n            \"country_code\": \"DK\",\n            \"county\": \"\",\n            \"region\": \"\",\n            \"locality\": \"Herlev\",\n            \"street\": \"Unnamed Road\",\n            \"house_number\": \"\",\n            \"zip\": \"2730\"\n          },\n          \"trip_end\": {\n            \"datetime\": \"2019-05-24T06:58:48.121Z\",\n            \"longitude\": 0,\n            \"latitude\": 0,\n            \"address\": {\n              \"country\": \"Denmark\",\n              \"country_code\": \"DK\",\n              \"county\": \"\",\n              \"region\": \"\",\n              \"locality\": \"Herlev\",\n              \"street\": \"Unnamed Road\",\n              \"house_number\": \"\",\n              \"zip\": \"2730\"\n            },\n          },\n\t...\n\t]\n}<\/pre><\/div>\n\n
Se un parametro \u00e8 stato inserito in modo errato, il sistema risponder\u00e0 con un codice di errore. Tutti i codici di errore sono descritti nella sezione API<\/a>. I parametri per i quali non vengono forniti dati non sono inclusi nella risposta. L’elenco completo dei parametri di risposta \u00e8 disponibile alla fine di questa sezione.     <\/p>\n\n
Parametri di risposta:<\/p>\n\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
Parameter<\/th>Type<\/th>Description<\/th>Units<\/th>\n<\/tr>\n<\/thead>\n
continuation_token<\/td>String<\/td>Displays from what date and time the data is shown if the record limit was reached.<\/td><\/td>\n<\/tr>\n
trips<\/td>Array<\/td>Contains all parameters in accordance to the request<\/td><\/td>\n<\/tr>\n
object_id<\/td>String<\/td>Object identifier<\/td><\/td>\n<\/tr>\n
trip_type<\/td>Enum<\/td>Trip type
\nPossible values:
\nUNKNOWN
\nNONE
\nPRIVATE
\nBUSINESS
\nWORK<\/td>		<\/td>\n<\/tr>\n
trip_duration<\/td>Datetime<\/td>Trip duration<\/td>s<\/td>\n<\/tr>\n
mileage<\/td>Number<\/td>Mileage pass during the trip<\/td>m<\/td>\n<\/tr>\n
driver_ids<\/td>Array<\/td>Container for all driver IDs assigned to the vehicle during the trip.<\/td><\/td>\n<\/tr>\n
trip_start<\/td>Array<\/td>Container for trip start parameters<\/td><\/td>\n<\/tr>\n
datetime<\/td>Datetime<\/td>Date and time point of coordinate generated in hardware
\nFormat: \"yyyy-mm-ddThh:mm:ss.sssZ\"<\/td>		Datetime<\/td>\n<\/tr>\n
longitude<\/td>Number<\/td>Longitude<\/td>Degrees<\/td>\n<\/tr>\n
latitude<\/td>Number<\/td>Latitude<\/td>Degrees<\/td>\n<\/tr>\n
address<\/td>Array<\/td>Container for address parameters<\/td><\/td>\n<\/tr>\n
country<\/td>String<\/td>Country name<\/td><\/td>\n<\/tr>\n
country_code<\/td>String<\/td>Country code<\/td><\/td>\n<\/tr>\n
county<\/td>String<\/td>County name<\/td><\/td>\n<\/tr>\n
region<\/td>String<\/td>Region name<\/td><\/td>\n<\/tr>\n
locality<\/td>String<\/td>Locality name<\/td><\/td>\n<\/tr>\n
street<\/td>String<\/td>Street name<\/td><\/td>\n<\/tr>\n
house_number<\/td>String<\/td>House number<\/td><\/td>\n<\/tr>\n
zip<\/td>String<\/td>ZIP code<\/td><\/td>\n<\/tr>\n
trip_end<\/td>Array<\/td>Container for trip end parameters<\/td><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n
\n\n
\u2039   <\/span> API dell’oggetto <\/a><\/div> 
API per l’analisi dei tempi di guida   \u203a <\/span> <\/a><\/div>\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"
L’API Trips \u00e8 dedicata all’output della cronologia dei viaggi dell’oggetto per il periodo richiesto. Struttura della richiesta: GET \/objects\/{objectId}\/trips?version=1&from_datetime=&to_datetime=&continuation_token=&limit=&api_key= HTTP\/1.1 HOST:api.fm-track.com Content-Type:application\/json;charset=UTF-8 Parametri della richiesta: Esempio di risposta: Se un parametro \u00e8 stato inserito in modo errato, il sistema risponder\u00e0 con un codice di errore. Tutti i codici di errore sono descritti nella sezione API. … Continua a leggere API Viaggi<\/span><\/a><\/p>\n","protected":false},"author":5,"featured_media":0,"parent":14003,"menu_order":6,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-13858","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/13858","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\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/comments?post=13858"}],"version-history":[{"count":1,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/13858\/revisions"}],"predecessor-version":[{"id":13863,"href":"https:\/\/www.fmsdocumentation.com\/it\/wp-json\/wp\/v2\/pages\/13858\/revisions\/13863"}],"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=13858"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}