{"id":8177,"date":"2019-07-19T12:35:07","date_gmt":"2019-07-19T10:35:07","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/api\/api-de-viajes\/"},"modified":"2019-09-05T16:12:23","modified_gmt":"2019-09-05T14:12:23","slug":"api-de-viajes","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/es\/api\/api-de-viajes\/","title":{"rendered":"API de viajes"},"content":{"rendered":"\n

La API de viajes se usa para proporcionar el historial de viajes de objetos para el periodo solicitado.<\/p>\n\n\n\n

Estructura de la solicitud:<\/p>\n\n\n\n

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

Par\u00e1metros de la respuesta:<\/p>\n\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>Obligatorio<\/th>\n<\/tr>\n<\/thead>\n
objectId<\/td>Cadena<\/td>El ID del objeto externo<\/td>S\u00ed<\/td>\n<\/tr>\n
from_datetime<\/td>Fecha y hora<\/td>Encuentra registros desde la fecha y hora especificada. Ejemplo de fecha y hora: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>S\u00ed<\/td>\n<\/tr>\n
to_datetime<\/td>Fecha y hora<\/td>Encuentra registros hasta la fecha y hora especificada. Ejemplo de fecha y hora: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>No<\/td>\n<\/tr>\n
continuation_token<\/td>Fecha y hora<\/td>Muestra desde cual fecha y hora se muestran los datos si se ha alcanzado el l\u00edmite de registros.<\/td>No<\/td>\n<\/tr>\n
limit<\/td>N\u00famero entero<\/td>Cu\u00e1ntos registros se incluyen en la respuesta (el valor por defecto - 100 registros, el valor m\u00e1ximo - 1000 registros).<\/td>No<\/td>\n<\/tr>\n
version<\/td>Cadena<\/td>La versi\u00f3n de la API<\/td>S\u00ed<\/td>\n<\/tr>\n
api_key<\/td>Cadena<\/td>La clave de identificaci\u00f3n del usuario<\/td>S\u00ed<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n

Ejemplo de la respuesta;<\/p>\n\n\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\n\n
Si se ha introducido un par\u00e1metro incorrecto, el sistema responder\u00e1 con un c\u00f3digo de error. Los c\u00f3digos de errores se describen en API<\/a>. Los par\u00e1metros sin datos no se incluir\u00e1n en la respuesta. Una lista completa de par\u00e1metros de respuesta est\u00e1 disponible al final de este cap\u00edtulo.<\/p>\n\n\n\n
Par\u00e1metros de la respuesta:<\/p>\n\n\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
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>Unidades<\/th>\n<\/tr>\n<\/thead>\n
continuation_token<\/td>Cadena<\/td>Se recibe el s\u00edmbolo de continuaci\u00f3n al solicitar una cantidad grande de registros para per\u00edodos largos, as\u00ed superando el predeterminado l\u00edmite de registros. El s\u00edmbolo de continuaci\u00f3n se mostrar\u00e1 al final de la respuesta y se puede usarlo para mostrar el siguiente conjunto de registros para el per\u00edodo seleccionado. Si no hay m\u00e1s registros despu\u00e9s del s\u00edmbolo de continuaci\u00f3n, la respuesta ser\u00e1 vac\u00eda.<\/td><\/td>\n<\/tr>\n
trips<\/td>Array<\/td>Contiene todos los par\u00e1metros seg\u00fan la solicitud<\/td><\/td>\n<\/tr>\n
object_id<\/td>Cadena<\/td>El ID del objeto<\/td><\/td>\n<\/tr>\n
trip_type<\/td>Enum<\/td>El tipo del viaje
\nValores posibles:
\nUNKNOWN
\nNONE
\nPRIVATE
\nBUSINESS
\nWORK<\/td>		<\/td>\n<\/tr>\n
trip_duration<\/td>Fecha y hora<\/td>La duraci\u00f3n del viaje<\/td>s<\/td>\n<\/tr>\n
mileage<\/td>N\u00famero<\/td>Kilometraje conducido durante el viaje<\/td>m<\/td>\n<\/tr>\n
driver_ids<\/td>Array<\/td>Contiene todos los IDs de conductor asignados al veh\u00edculo durante el viaje<\/td><\/td>\n<\/tr>\n
trip_start<\/td>Array<\/td>Contiene los par\u00e1metros del comienzo del viaje<\/td><\/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>Fecha y hora<\/td>\n<\/tr>\n
longitude<\/td>N\u00famero<\/td>Longitud<\/td>Grados<\/td>\n<\/tr>\n
latitude<\/td>N\u00famero<\/td>Latitud<\/td>Grados<\/td>\n<\/tr>\n
address<\/td>Array<\/td>Contiene los par\u00e1metros de direcci\u00f3n<\/td><\/td>\n<\/tr>\n
country<\/td>Cadena<\/td>El nombre del pa\u00eds<\/td><\/td>\n<\/tr>\n
country_code<\/td>Cadena<\/td>El c\u00f3digo del pa\u00eds<\/td><\/td>\n<\/tr>\n
county<\/td>Cadena<\/td>El nombre del condado<\/td><\/td>\n<\/tr>\n
region<\/td>Cadena<\/td>El nombre de la regi\u00f3n<\/td><\/td>\n<\/tr>\n
locality<\/td>Cadena<\/td>El nombre de la localidad<\/td><\/td>\n<\/tr>\n
street<\/td>Cadena<\/td>El nombre de la calle<\/td><\/td>\n<\/tr>\n
house_number<\/td>Cadena<\/td>El n\u00famero del inmueble<\/td><\/td>\n<\/tr>\n
zip<\/td>Cadena<\/td>El c\u00f3digo ZIP<\/td><\/td>\n<\/tr>\n
trip_end<\/td>Array<\/td>Contiene los par\u00e1metros del fin del viaje<\/td><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n
\n
\u2039   <\/span> API de objeto <\/a><\/div> 
API de an\u00e1lisis de tiempo de conductores   \u203a <\/span> <\/a><\/div>\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"
La API de viajes se usa para proporcionar el historial de viajes de objetos para el periodo solicitado. Estructura de la solicitud: 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 Par\u00e1metros de la respuesta: Ejemplo de la respuesta; Si se ha introducido un par\u00e1metro incorrecto, el sistema responder\u00e1 con un c\u00f3digo de error. Los c\u00f3digos de errores se … Sigue leyendo API de viajes<\/span><\/a><\/p>\n","protected":false},"author":5,"featured_media":0,"parent":2084,"menu_order":6,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-8177","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/8177","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\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/comments?post=8177"}],"version-history":[{"count":3,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/8177\/revisions"}],"predecessor-version":[{"id":8221,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/8177\/revisions\/8221"}],"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=8177"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}