{"info":{"_postman_id":"e1e4d8bf-314b-4c61-9508-4d1b54ce4549","name":"Localización Instantánea","description":"

La siguiente API Rest tiene como objetivo brindar información sobre el último estado de cada uno de los vehículos su flota registrados en Tranciti.

\n

El API responde los siguientes datos por cada vehículo:

\n\n

Resumen de endpoints:

\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50892995","collectionId":"e1e4d8bf-314b-4c61-9508-4d1b54ce4549","publishedId":"2sBXVeDrAN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-06T12:43:37.000Z"},"item":[{"name":"Obtener token de autorización","id":"4c6657e3-c1a4-403b-ae69-db4a70ac973f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.waypoint.cl/auth/login?user={{user}}&password={{password}}","description":"

Request que permite obtener el token de autorización.

\n

Se recomienda utilizar el paso de variables en la URL a fin de no revelar información confidencial

\n

Respuestas:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CódigoDescripción
200Petición procesada correctamente. Se retorna el AccessToken en el body.
400Se ha producido un error por falta de parámetros o parámetros incorrectos.
\n
\n
{\n    \"AccessToken\": \"eyJraWQiOiJEREhzTFdYUURUOGpBYSt4TElsUnlyNzg3WHUrVjB3RmMwaZVPSIsImFsZyI6IlJTMjU2In0.eyJzdWIiOiIzYjc0MzE2OS1iMTU1LTRkZTEtYWRiMS04NjJmNjI3NDIwYzUiLCJldmVudF9pZCI6IjjOWMzLTE3YjEtNGE4Zi04NzViLWRmMTJkOTYzNTYzYiIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE2OTkwMzgyNDYsImlzcyI6Imh0dHBzOlwvXC9gtww56jb2duaXRvLWlkcC51cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xXzNMSno1anJRNiIsImV4cCI6MTY5OTA0MTg0MywiaWF0IjoxNjk5MDM4MjQ2LCJqdGkiOiIwNWIxZTgxZS0yMzAzLTRjMjUtODJiOC0zOTU5YWEzMzE5MGIiLCJjbGllbnRfaWQiOiIybHJ2NWs4M204c2NwcnI2cGxwdmFyYWFjayIsInVzZXJuYW1lIjoiZWZlcm5hbmRleiJ9.NZ72Wz7IxRJYFqLRy5J7HL7M-d_DcsF3DOjNnTeMhSuAmwzPrCwIKqCgcjDjMZ1GPYYCgTAQPHNcLoF8AOoyw_6rv2f8rcvDGhunKFxS1S2B4eICCF94JUtVkFrNKrjgy9wiXeEHsnxhmx543g8jm_UsymC_IqRsjaOuTv5AXU67nIz4HpVY_tH_fXWwrTtLlpxmYYY_oaYpFvmBqf8m5nSzckJUllM-aVaPhc_wRA1YOMhOi_8T_L_xQZJoJnrQg34_qHC0M_qFQSg0HPYhDas4qOqgfCNdoI57BqzoJIHNNpbn7yp25R0DdR5vxJ9lFKBZ00lICS3YLeXY_iCiN3V05An2ZQ\"\n}\n\n
\n\n
{\n    \"error\": {}\n}\n\n
\n\n
{\n    \"error\": \"Invalid password for user USER\"\n}\n\n
\n","urlObject":{"protocol":"https","path":["auth","login"],"host":["api","waypoint","cl"],"query":[{"key":"user","value":"{{user}}"},{"key":"password","value":"{{password}}"}],"variable":[]}},"response":[{"id":"876a0bc6-9077-40b7-8a2c-3b859dac0acd","name":"Obtener token de autorización","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.waypoint.cl/auth/login?user={{user}}&password={{password}}","protocol":"https","host":["api","waypoint","cl"],"path":["auth","login"],"query":[{"key":"user","value":"{{user}}"},{"key":"password","value":"{{password}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 03 Nov 2023 19:13:02 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"985"},{"key":"Connection","value":"keep-alive"},{"key":"x-amzn-RequestId","value":"ddbdbcbd-846b-4d32-93c8-bbb42da2de44"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Content-Type,X-Amz-Date,Authorization,X-Api-Key,X-Amz-Security-Token"},{"key":"x-amz-apigw-id","value":"N1fpIG8MyK4EWyA="},{"key":"Access-Control-Allow-Methods","value":"OPTIONS,GET"},{"key":"X-Requested-With","value":"*"},{"key":"X-Amzn-Trace-Id","value":"Root=1-6545463a-43cefda41674e8310dd6646a;Sampled=0;lineage=4d9fa0f3:0"}],"cookie":[],"responseTime":null,"body":"{\n \"AccessToken\": \"eyJraWQiOiJEREhzTFdYUURUOGpBYSt4TElsUnlyNzg3WHUrVjB3RmMwaHlWWnVnTzZVPSIsImFsZyI6IlJTMjU2In0.eyJzdWIiOiIlnoc0MzE2OS1iMTU1LTRkZTEtYWRiMS04NjDIwYzUiLCJldmVudF9pZCI6IjRlM2ZlMTlkLWViNWMtNGJmNS1iYzgyLThhOWVkY2RmYzViNiIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE2OTkwMzg3ODIsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy1lYXN0LTEuYW1hem9uYXdzLmNvbVwvdXMtZWFzdC0xXzNMSno1anJRNiIsImV4cCI6MTY5OTA0MjM3OSwiaWF0IjoxNjk5MDM4NzgyLCJqdGkiOiJkNTc2YTFjMy1jNjJmLTQ3YjYtYWQ2YS0wZmQxYWE2MDlOWIiLCJjbGllbnRfaWQiOiIybHJ2NWskjs84M204c2NwcnI2cGxwdmFyYWFjayIsInVzZXJuYW1lIjoiZWZlcm5hbmRleiJ9.aQzYILtIVr7WGnk93pGSghBAuVGz3_7cPYAcoCO-xmqD_voe5yEEzoPWaiMYgeHKCq08fRCsoVTO00OXx_toLkwjt_H-Y2knF2Fed2TWJ4q6wugtUrOqwEL2ZTgT0CDiKhMwy0VG_QLzShHXA2peQFPiqKIbrcteQ1gmS-zUyZVHjZgvD1A6UIR31kuROuC2G9Jt0_KyZ1nRk-QwLZgfBWhYfGqjfPL6rv76iXTMmVqtaOShJVj1jIVieSyywQiIjCpflukQRKdl_lSbmKVX2T7KJM-_HYPJCVmwIsCQO_Cvt8R9mC4gbhWjW2ScNrNLNKRCErfp99rhQgCx8JHDnQ\"\n}"}],"_postman_id":"4c6657e3-c1a4-403b-ae69-db4a70ac973f"},{"name":"Obtener últimos datos","id":"bce699cf-a0cc-4a38-a79c-b263372f4997","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[{"key":"x-api-key","value":"{{x-api-key}}","type":"text"},{"key":"id-client","value":"{{id-client-autorizado}}","type":"text"}],"url":"https://api.tranciti.com/localizacion-instantanea/obtener?idClient={{idClient-vehiculos}}","description":"

Este endpoint permite obtener la última información reportada desde los equipos GPS instalados en los vehículos del cliente.

\n

Datos de entrada

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NombreUsoObtenciónDescripción
x-api-keyHeaderSecreto entregado junto con acceso al APINecesario para tener acceso al API. Permite identificar y aplicar planes de uso.
id-clientHeaderEntregado junto con acceso al APINecesario para tener acceso al API. Permite identificar nivel de acceso otorgado a este cliente en particular.
Authorization(token)HeaderObtenido al hacer loginNecesario para tener acceso al listado de vehículos entregado por el API. El listado de vehículos entregado corresponde a ser aquellos a los que el usuario tiene acceso a ver.
idClientQuery ParamEntregado junto con acceso al APINecesario para tener acceso al listado de vehículos entregado por el API. El listado de vehículos entregado serán los de este cliente y de ningún otro. Puede o no ser igual a la cabecera \"id-client\", permitiendo acceso multicliente dentro de un mismo tenant.
\n

Respuestas

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CódigoDescripción
200La solicitud fue exitosa. En el body de la respuesta se encuentra un listado (data) de los vehículos con sus datos.
400Falta parámetro idClient o es inválido (por ejemplo, no es número)
401No se envió la cabecera Authorization con el token o el token está incorrecto (por ejemplo, no cumple con el formato esperado)
401El token entregado no pudo ser usado para verificar el usuario (por ejemplo, no fue enviado en su totalidad o fue modificado)
500Error interno
\n

Desglose y explicación de datos por vehículo

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Nombre del campoTipo de valorDescripciónDefault, no configurado o dato no encontrado
patenteStringPlaca/patente del vehículo'n/a'
imeiint (long)Imei del dispositivo instalado en el vehículo-1
epochint (long)Fecha de generación del dato GPS en formato epoch (en milis)-1
nsatintNúmero de satélites registrados en el dato GPS. A mayor, mejor calidad.-1
hdopintDilución horizontal de la precisión. A menor valor, mayor confianza en el valor de posición.-1
ignintIgnición del vehículo en ese dato GPS. 1 representa encendida y 0 apagada.-1
latfloatLatitud de la posición GPS0
lonfloatLongitud de la posición GPS.0
cogint“Course over ground”, representa el ángulo contra el norte geográfico (0° es Norte, 180° es Sur)0
sogint“Speed over ground”. Velocidad del vehículo según el registro GPS.0
adc, adc2, adc3, adc4intEntradas analógicas del GPS. Su interpretación depende de lo configurado
en el equipo GPS.		-200
input1, input2, input3, input4intEntradas digitales del GPS. Son señales de ON/OFF (0 o 1) conectadas a
distintos sensores o dispositivos eléctricos. Su interpretación depende de lo configurado en el
equipo GPS.		-1
powerStringIndica si el GPS está recibiendo corriente o no, con valores 'Activado' y 'Desactivado' respectivamente.'Desactivado'
bateriafloatBatería del vehículo según el equipo GPS (en volts)0
bateriaintfloatBatería interna del equipo GPS (en volts)0
odometroint (long)Odómetro registrado en el dato GPS según el equipo.0
eventidintIdentificador del evento que provocó el envío de datos GPS al sistema.0
conductorStringNombre del conductor registrado en la plataforma en el momento de la
generación del dato GPS		'DESCONOCIDO'
\n
","urlObject":{"protocol":"https","path":["localizacion-instantanea","obtener"],"host":["api","tranciti","com"],"query":[{"key":"idClient","value":"{{idClient-vehiculos}}"}],"variable":[]}},"response":[{"id":"47550e2e-f78a-4970-bca7-6576348cc42d","name":"Ejemplo Obtener últimos datos","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJraWQiOiJ2pRcFNEMVlaVXlHQ2IyXC9TWGwzR3VOS2hHeVgyTm83XC9jZGs9IiwiYWxnIjoiUlMyNTYifQ.eyJzdWIiOiIyNjA2MzdiOS04NjUzLTQ2NTAtOWNhYy00NjdkMGJkOTk3N2UiLCJpc3MiOiJodHRwczpcL1wvY29nbml0by1pZHAudXMtZWFtYXpvbmF3cy5jb21cL3VzLWVhc3QtMV8zUVZTV2l0NkEiLCJjbGllbnRfaLberTOWQiOiIycDY4czRvZnNoNzMxNm9oaWd1ZW0waWZpciIsIm9yaWdpbl9qdGkiOiJmNGRlMzU3NC03ZjBjLTQwMDUtYThjMC01YWQ4ZGUzNmYyZTciLCJldmVudF9pZCI6IjNlYWasQzN2ZiLWNhZjktNDQ5ZC04YWZlLTBlYzE3YjczNjZlYSIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiYXdzLmNvZ25pdG8uc2lnbmluLnVzZXIuYWRtaW4iLCJhdXRoX3RpbWUiOjE3NTk0Mzc3NDgsImV4cCI6MTc1OTQ0MTM0OCwiaWF0IjoxNzU5NDM3NzQ5LCJqdGkiOiJhMWNhOTM4ZC0yNjQ3LTQ2ZTMtYjQzNy01ZTc4NjIyOGU0NWEiLCJ1c2VybmFtZSI6ImdyZWF0X3Njb3R0In0.VOA9ObYcTEHHCAqGQd9-EYQ-5LL5hvjrb1eZPbPgsF1gF0gVV0oakNVtBz-Qwn2VCoOXwLDNpKHXvai23_Bm6Vfz16lF6I6XOHeRmgOId73No74irZWz3SqzTHGt-qfAXz25IURJNGbkE8OzwPiOXSpWa40gVgAxkXWvqGGpMSnFEC4HBch7vA07TKkOL0j83ZN7Y1jQF07Nhere-0Xk8kULlhPiPq86tIEGybL1rTjh2deHz1UN62nU5ratc5Zfc05JtMLT8u041fA8b1RRUItcdyyq5VeqPmnoIvn31n9NbqvPAeVxSAg2mKDiw9wW49EEemoxcgw","type":"text"},{"key":"id-client","value":"12345678","type":"text"},{"key":"x-api-key","value":"ppbGkuNSapiKeyGYUB78321A7Cip8iWFkgexampleIOS8","type":"text"}],"url":{"raw":"https://api.tranciti.com/localizacion-instantanea/obtener?idClient=12345678","protocol":"https","host":["api","tranciti","com"],"path":["localizacion-instantanea","obtener"],"query":[{"key":"idClient","value":"12345678"}]}},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"patente\": \"WAYP-25\",\n \"imei\": \"333222111000000\",\n \"epoch\": 1370375496000,\n \"nsat\": 9,\n \"hdop\": 1,\n \"ign\": -1,\n \"lat\": -33.428,\n \"lon\": -70.61221,\n \"cog\": 346,\n \"sog\": 0,\n \"adc\": -201,\n \"adc2\": -200,\n \"adc3\": -200,\n \"adc4\": -200,\n \"input1\": 1,\n \"input2\": 1,\n \"input3\": -1,\n \"input4\": -1,\n \"power\": \"Desactivado\",\n \"bateria\": 2,\n \"bateriaint\": 0,\n \"odometro\": 0,\n \"eventid\": -1,\n \"conductor\": \"DESCONOCIDO\"\n },\n {\n \"patente\": \"WAYP-26\",\n \"imei\": \"333222111000001\",\n \"epoch\": 1656091864000,\n \"nsat\": 4,\n \"hdop\": 0.2,\n \"ign\": 1,\n \"lat\": -33.419357,\n \"lon\": -70.60877,\n \"cog\": 89,\n \"sog\": 0,\n \"adc\": -201,\n \"adc2\": -200,\n \"adc3\": -200,\n \"adc4\": -200,\n \"input1\": -1,\n \"input2\": -1,\n \"input3\": -1,\n \"input4\": -1,\n \"power\": \"Desactivado\",\n \"bateria\": 0,\n \"bateriaint\": -200,\n \"odometro\": 0,\n \"eventid\": -1,\n \"conductor\": \"DESCONOCIDO\"\n },\n {\n \"patente\": \"EJEM-01\",\n \"imei\": \"333222111000002\",\n \"epoch\": 1454083461000,\n \"nsat\": 8,\n \"hdop\": 1,\n \"ign\": -1,\n \"lat\": -35.019867,\n \"lon\": -71.248856,\n \"cog\": 0,\n \"sog\": 0,\n \"adc\": -300,\n \"adc2\": -200,\n \"adc3\": -200,\n \"adc4\": -200,\n \"input1\": 1,\n \"input2\": 1,\n \"input3\": -1,\n \"input4\": -1,\n \"power\": \"Activado\",\n \"bateria\": 12,\n \"bateriaint\": 0,\n \"odometro\": 20000,\n \"eventid\": -1,\n \"conductor\": \"DESCONOCIDO\"\n },\n {\n \"patente\": \"AAPR-95\",\n \"imei\": \"333222111000003\",\n \"epoch\": 1516927744000,\n \"nsat\": 10,\n \"hdop\": 1,\n \"ign\": -1,\n \"lat\": -33.419365,\n \"lon\": -70.60877,\n \"cog\": 38,\n \"sog\": 0,\n \"adc\": -200,\n \"adc2\": -200,\n \"adc3\": -200,\n \"adc4\": -200,\n \"input1\": -1,\n \"input2\": 1,\n \"input3\": -1,\n \"input4\": -1,\n \"power\": \"Desactivado\",\n \"bateria\": 1,\n \"bateriaint\": 3.45,\n \"odometro\": 100,\n \"eventid\": -1,\n \"conductor\": \"DESCONOCIDO\"\n }\n ]\n}"}],"_postman_id":"bce699cf-a0cc-4a38-a79c-b263372f4997"}]}