{"id":2082,"date":"2017-04-21T08:16:21","date_gmt":"2017-04-21T08:16:21","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/history-api\/"},"modified":"2019-07-19T12:57:32","modified_gmt":"2019-07-19T10:57:32","slug":"api-de-historial-de-coordenadas-de-objeto","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/es\/api\/api-de-historial-de-coordenadas-de-objeto\/","title":{"rendered":"API de historial de coordenadas de objeto"},"content":{"rendered":"\n

El prop\u00f3sito principal de la API de historial de coordenadas de objeto es mostrar los datos historiales (coordenadas) de un objeto. La API de historial de coordenadas de objeto tiene dos puntos finales, as\u00ed que hay dos tipos de solicitudes. El primer tipo de solicitud es para un objeto y una fecha y hora espec\u00edfica. Solo se muestran datos grabados a una fecha y hora especificada.<\/p>\n\n\n\n

Ejemplo de solicitud para una fecha y hora espec\u00edfica:<\/p>\n\n\n\n

GET \/objects\/{object_id}\/coordinates\/{datetime}?version=1&api_key=<…>
HOST:api.fm-track.com
Content-Type:application\/json;charset=UTF-8<\/p>\n\n\n\n

Este tipo de solicitud necesita tres par\u00e1metros (sin contar el API_key) para que la solicitud de API trabaje:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\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
datetime<\/td>Fecha y hora<\/td>El registro solicitado para la fecha y hora especificada. Ejemplo de fecha y hora: \u201c2017-04-13T06:58:48.090Z\u201d, seg\u00fan el est\u00e1ndar ISO-8601<\/td>\n<\/tr>\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

Nota
Se recomienda utilizar el par\u00e1metro datetime desde el segundo punto final de API de historial de coordenadas de objeto, porque el par\u00e1metro de fecha y hora se espec\u00edfica por el segundo y el sistema no busca datos cerca de la fecha especificada.<\/p>\n\n\n\n

Se muestra un ejemplo de respuesta a continuaci\u00f3n, cuando todos los par\u00e1metros fueron incluidos y el API_key es v\u00e1lido:<\/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\n
Si se ha introducido un par\u00e1metro o API_key incorrecto, el sistema responder\u00e1 con un c\u00f3digo de error. Los c\u00f3digos de errores se describen en API<\/a>. Los par\u00e1metros se describen al final de este cap\u00edtulo.<\/p>\n\n\n\n
El segundo punto final de la API de historial muestra un array de datos historiales para un peri\u00f3do definido, que se puede usar al enviar el primer tipo de solicitud de API.<\/p>\n\n\n\n
Ejemplo de solicitud para un peri\u00f3do espec\u00edfico:<\/p>\n\n\n\n
GET \/objects\/{object_id}\/coordinates?version=1{&from_datetime,to_datetime,continuation_token,limit}&api_key=<…>
HOST:api.fm-track.com
Content-Type:application\/json;charset=UTF-8<\/p>\n\n\n\n
Este tipo de solicitud necesita tres par\u00e1metros (sin contar el API_key) para que la solicitud de API trabaje:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
objectId<\/td>Cadena<\/td>ID del objeto externo<\/td>\n<\/tr>\n
fromDatetime<\/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, seg\u00fan el est\u00e1ndar ISO-8601 <\/td>\n<\/tr>\n
version<\/td>Cadena<\/td>Versi\u00f3n de la API<\/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
Los par\u00e1metros opcionales que no son obligatorios, pero pueden ser incluidos en la solicitud:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
toDatetime<\/td>Fecha y hora<\/td>Encuentra registros hasta la fecha y hora especificada. El sistema buscar\u00e1 registros hasta la fecha actual o hasta que se alcance el l\u00edmite de registros. Ejemplo de fecha y hora: \u201c2017-04-13T06:58:48.090Z\u201d, seg\u00fan el est\u00e1ndar ISO-8601<\/td>\n<\/tr>\n
continuationToken<\/td>Fecha y hora<\/td>Incluye un s\u00edmbolo de continuaci\u00f3n, mostrar\u00e1 el siguiente conjunto de registros despu\u00e9s de alcanzar el l\u00edmite previo de registros <\/td>\n<\/tr>\n
limit<\/td>N\u00famero entero<\/td>Fija el l\u00edmite de registros en la respuesta del sistema (el valor por defecto es 100 registros, el valor m\u00e1ximo es 1000 registros)<\/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
Ejemplo de respuesta:<\/p>\n\n\n\n
\n
{\n  \"continuation_token\": \"2017-04-13T06:58:48.121Z\",\n  \"items\": [\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    }\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\n\t\n\t
Par\u00e1metro<\/th>Tipo<\/th>Descripci\u00f3n<\/th>Unidades<\/th>\n<\/tr>\n<\/thead>\n
continuation_token<\/td><\/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>Fecha y hora<\/td>\n<\/tr>\n
items<\/td>Array<\/td>Contiene todos los par\u00e1metros seg\u00fan la solicitud<\/td><\/td>\n<\/tr>\n
object_id<\/td>Cadena<\/td>ID del objeto externo<\/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\"
\n<\/td>		Seg\u00fan ISO-8601<\/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<\/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
\n<\/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
\n<\/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
\n
\n<\/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
\n
\n<\/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
Se puede ver los puntos finales de API, los par\u00e1metros de solicitudes y las respuestas en \u201cSwagger\u201d haciendo clic en este enlace: https:\/\/api.fm-track.com<\/a><\/p>\n
\n
\u2039   <\/span> API <\/a><\/div> 
API de historial de coordenadas de objeto v2   \u203a <\/span> <\/a><\/div><\/p>","protected":false},"excerpt":{"rendered":"
El prop\u00f3sito principal de la API de historial de coordenadas de objeto es mostrar los datos historiales (coordenadas) de un objeto. La API de historial de coordenadas de objeto tiene dos puntos finales, as\u00ed que hay dos tipos de solicitudes. El primer tipo de solicitud es para un objeto y una fecha y hora espec\u00edfica. … Sigue leyendo API de historial de coordenadas de objeto<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2084,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2082","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2082","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=2082"}],"version-history":[{"count":18,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2082\/revisions"}],"predecessor-version":[{"id":8183,"href":"https:\/\/www.fmsdocumentation.com\/es\/wp-json\/wp\/v2\/pages\/2082\/revisions\/8183"}],"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=2082"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}