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

La siguiente API Rest tiene como objetivo brindar información del último estado disponible de vehículos de su cliente en Tranciti, según los permisos del usuario autenticado y los filtros enviados en la solicitud.

\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-07-15T13:54:48.000Z"},"item":[{"name":"Obtener token de autorización","id":"f5435fd5-0ef2-419c-9179-d19ef7be12fc","request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"user\": \"{{user}}\",\n \"password\": \"{{password}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.waypoint.cl/auth/login","description":"

Request que permite obtener el token de autorización.

\n

Se recomienda utilizar el paso de variables en el body 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\": \"ACCESS.TOKEN\"\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":[],"variable":[]}},"response":[{"id":"8d38363a-5c6f-43b6-b7ce-0cff57e73ac5","name":"Obtener token de autorización","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"user\": \"{{user}}\",\n \"password\": \"{{password}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.waypoint.cl/auth/login"},"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,POST"},{"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\": \"ACCESS.TOKEN\"\n}"}],"_postman_id":"f5435fd5-0ef2-419c-9179-d19ef7be12fc"},{"name":"Obtener últimos datos","id":"c9d5fb67-70c9-4b36-9462-08e117c99f89","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}}&ioInfo=false&adcInfo=false&sensorInfo=false&zona=false","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\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.
ioInfoQuery Param (opcional)Definido por consumidor del APIBooleano (true o false). Si viene en true, agrega ioData en cada vehículo.
adcInfoQuery Param (opcional)Definido por consumidor del APIBooleano (true o false). Si viene en true, agrega adcData en cada vehículo.
sensorInfoQuery Param (opcional)Definido por consumidor del APIBooleano (true o false). Si viene en true, agrega sensorData en cada vehículo.
zonaQuery Param (opcional)Definido por consumidor del APIBooleano (true o false). Si viene en true, agrega zona en cada vehículo: el nombre de la zona geográfica creada dentro de la plataforma por la que está pasando actualmente el vehículo. Si el vehículo no está dentro de ninguna zona configurada, se retorna \"Desconocida\".
\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\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\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
reg_atint (long)Fecha en la que se registró el dato GPS en nuestro sistema en formato epoch (en milis)-1
grupoStringGrupo al que pertenece el vehículo registrado en la plataforma en el momento en el que se generó el dato GPS.'SIN GRUPO'
flotaStringFlota es el tipo de vehículo que tiene registrado en la plataforma el vehículo al momento de generarse el dato GPS.'SIN TIPO DE VEHICULO'
descStringDescripción que tiene el vehículo registrado en la plataforma al momento de generarse el dato GPS''
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
cogintCourse over ground, representa el ángulo contra el norte geográfico (0° es Norte, 180° es Sur).0
sogintSpeed 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 ON/OFF (0 o 1) conectadas a sensores/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, expresado en metros.0
horometroint (long)Horómetro registrado en el dato GPS según el equipo, expresado en segundos.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'
ioDataArray (0..n)Lista de señales de entrada/salida asociadas al vehículo. Solo se incluye si ioInfo=true.No se incluye si no se solicita.
ioData.ioNumerointNúmero o posición lógica del I/O en la configuración del equipo.No aplica
ioData.ioNombreStringNombre general del I/O.No aplica
ioData.ioSubclaseStringNombre de la subclasificación de ese I/O.No aplica
ioData.estadoActivoStringEtiqueta de estado cuando la señal está activa.No aplica
ioData.estadoInactivoStringEtiqueta de estado cuando la señal está inactiva.No aplica
adcDataArray (0..n)Lista de configuraciones ADC asociadas al vehículo. Solo se incluye si adcInfo=true.No se incluye si no se solicita.
adcData.idAdcConfiguracionintIdentificador de la configuración ADC asignada.No aplica
adcData.adcintNúmero de canal ADC al que corresponde la configuración.No aplica
adcData.idAdcnomintIdentificador del nombre/catalogación de ese ADC.No aplica
adcData.nomAdcnomStringNombre mostrado para ese canal ADC.No aplica
adcData.actAdcnombooleanIndica si la configuración/nombre está activa.No aplica
sensorDataArray (0..n)Lista de sensores calculados/configurados para el vehículo. Solo se incluye si sensorInfo=true.No se incluye si no se solicita.
sensorData.nombreSensorStringNombre del sensor.No aplica
sensorData.descripcionSensorStringDescripción funcional del sensor.No aplica
sensorData.adcintCanal ADC asociado al sensor, cuando corresponde.No aplica
sensorData.unidadBaseStringUnidad de medida de origen del sensor.No aplica
sensorData.unidadResultadoStringUnidad final en la que se reporta el valor del sensor.No aplica
sensorData.nombreClaseStringClase funcional del sensor.No aplica
sensorData.valorIdealfloatValor ideal o de referencia definido para el sensor.No aplica
sensorData.valorMaxfloatValor máximo esperado para el sensor.No aplica
sensorData.valorMinfloatValor mínimo esperado para el sensor.No aplica
sensorData.inputVoltagefloatValor calculado/medido de entrada para el sensor.No aplica
sensorData.multiplicadorAdcfloatFactor de multiplicación aplicado al valor ADC.No aplica
sensorData.idClaseintIdentificador de la clase del sensor.No aplica
sensorData.idUnidadBaseintIdentificador de la unidad de medida base.No aplica
sensorData.idUnidadResultadointIdentificador de la unidad de medida resultado.No aplica
sensorData.idSensorintIdentificador único del sensor configurado.No aplica
zonaStringNombre de la zona geográfica (geocerca) creada dentro de la plataforma por la que está pasando actualmente el vehículo. Solo se incluye si zona=true.No se incluye si no se solicita. Si se solicita y el vehículo no está dentro de ninguna zona configurada, se retorna \"Desconocida\".
\n
","urlObject":{"protocol":"https","path":["localizacion-instantanea","obtener"],"host":["api","tranciti","com"],"query":[{"key":"idClient","value":"{{idClient-vehiculos}}"},{"description":{"content":"

Opcional. true o false. Si es true, incluye ioData en cada vehículo.

\n","type":"text/plain"},"key":"ioInfo","value":"false"},{"description":{"content":"

Opcional. true o false. Si es true, incluye adcData en cada vehículo.

\n","type":"text/plain"},"key":"adcInfo","value":"false"},{"description":{"content":"

Opcional. true o false. Si es true, incluye sensorData en cada vehículo.

\n","type":"text/plain"},"key":"sensorInfo","value":"false"},{"description":{"content":"

Opcional. true o false. Si es true, incluye zona en cada vehículo: el nombre de la zona geográfica creada dentro de la plataforma por la que está pasando actualmente el vehículo. Si el vehículo no está dentro de ninguna zona configurada, se retorna \"Desconocida\".

\n","type":"text/plain"},"key":"zona","value":"false"}],"variable":[]}},"response":[{"id":"06d3cffc-e873-4875-a0af-c7b9214b9dd5","name":"Ejemplo Obtener últimos datos","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{token}}","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&ioInfo=false&adcInfo=false&sensorInfo=false","protocol":"https","host":["api","tranciti","com"],"path":["localizacion-instantanea","obtener"],"query":[{"key":"idClient","value":"12345678"},{"key":"ioInfo","value":"false"},{"key":"adcInfo","value":"false"},{"key":"sensorInfo","value":"false"}]}},"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"patente\": \"JL-1089\",\n \"imei\": \"354676056027187\",\n \"epoch\": 1771222163010,\n \"reg_at\": -1,\n \"grupo\": \"General\",\n \"flota\": \"RAMPA FRIO\",\n \"desc\": \"Rampa Frio\",\n \"nsat\": -1,\n \"hdop\": -1,\n \"ign\": -1,\n \"lat\": 0,\n \"lon\": 0,\n \"cog\": 0,\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\": 0,\n \"bateriaint\": 0,\n \"odometro\": 0,\n \"horometro\": 0,\n \"eventid\": -1,\n \"conductor\": \"DESCONOCIDO\",\n \"ioData\": [\n {\n \"ioNumero\": 4,\n \"ioNombre\": \"PUERTA\",\n \"ioSubclase\": \"Puerta Trasera\",\n \"estadoActivo\": \"CERRADA\",\n \"estadoInactivo\": \"ABIERTA\"\n }\n ],\n \"adcData\": [\n {\n \"idAdcConfiguracion\": 32,\n \"adc\": 1,\n \"idAdcnom\": 5,\n \"nomAdcnom\": \"Refrigerado 1\",\n \"actAdcnom\": true\n }\n ],\n \"sensorData\": []\n },\n {\n \"patente\": \"JL-1652\",\n \"imei\": \"358539072404010\",\n \"epoch\": 1771222164268,\n \"reg_at\": -1,\n \"grupo\": \"General\",\n \"flota\": \"RAMPA FRIO\",\n \"desc\": \"Rampa Frio\",\n \"nsat\": -1,\n \"hdop\": -1,\n \"ign\": -1,\n \"lat\": 0,\n \"lon\": 0,\n \"cog\": 0,\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\": 0,\n \"bateriaint\": 0,\n \"odometro\": 0,\n \"horometro\": 0,\n \"eventid\": -1,\n \"conductor\": \"DESCONOCIDO\",\n \"ioData\": [\n {\n \"ioNumero\": 4,\n \"ioNombre\": \"PUERTA\",\n \"ioSubclase\": \"Puerta Trasera\",\n \"estadoActivo\": \"ABIERTA\",\n \"estadoInactivo\": \"CERRADA\"\n }\n ],\n \"adcData\": [\n {\n \"idAdcConfiguracion\": 1182,\n \"adc\": 1,\n \"idAdcnom\": 5,\n \"nomAdcnom\": \"Refrigerado 1\",\n \"actAdcnom\": true\n }\n ],\n \"sensorData\": [\n {\n \"nombreSensor\": \"Nivel de Bateria\",\n \"descripcionSensor\": \"Mide carga de bateria\",\n \"adc\": 3,\n \"unidadBase\": \"Porcentaje\",\n \"unidadResultado\": \"Porcentaje\",\n \"nombreClase\": \"Bateria\",\n \"valorIdeal\": 99,\n \"valorMax\": 100,\n \"valorMin\": 0,\n \"inputVoltage\": 100,\n \"multiplicadorAdc\": 1,\n \"idClase\": 2,\n \"idUnidadBase\": 3,\n \"idUnidadResultado\": 3,\n \"idSensor\": 2\n }\n ]\n }\n ]\n}"}],"_postman_id":"c9d5fb67-70c9-4b36-9462-08e117c99f89"}],"variable":[{"key":"ioInfo","value":"false"},{"key":"adcInfo","value":"false"},{"key":"sensorInfo","value":"false"},{"key":"zona","value":"false"}]}