Saltar a contenido

API: Ubicaciones

M: Estado de flota

HTTP GET:
https://<hostname>/api/fleet/status
OUTPUT:
EJEMPLO CON CURL:
$ curl -u <api_key>:<password>
     -X GET
     https://<hostname>/api/fleet/status
RESPUESTA:
[
  {
    "vehId": 218,
    "driverId": 15,
    "vehDescr": "Mazda - Protege (P-453QRR)",
    "vehStat": 0,
    "place": "Parqueo Oficina",
    "orgn": "Casa de José",
    "refId": 132,
    "epoch": "1478723512",
    "x": "-90.514175",
    "y": "14.622769",
    "event": 0,
    "eventDescription": "en movimiento",
    "speed": 0,
    "heading": 34,
    "odometer": 512.08,
    "ignOn": 0,
    "ignOnHrs": 81.931,
    "tripDist": 2.8,
    "direction": 229
  },
  {
    "vehId": 224,
    "driverId": null,
    "vehDescr": "Toyota - Civic (P-789PQS)",
    "vehStat": 0,
    "place": "Parqueo Zona 3",
    "orgn": "Bodega de distribución",
    "refId": 132,
    "epoch": "1480351287",
    "x": "-90.514503",
    "y": "14.622666",
    "event": 4,
    "eventDescription": "ignition off",
    "speed": 0,
    "heading": 300,
    "odometer": 191.54,
    "ignOn": 1,
    "ignOnHrs": 10.853,
    "tripDist": 2.86,
    "direction": 194
  }
]

M: Ubicación por fecha

HTTP GET:
https://<hostname>/api/fleet/<vehicle_id>/<epoch>
URL PARAMETERS:
Nombre Tipo Requerido Descripción
vehicle_id Id del Vehículo Numérico sí Id del vehículo.
epoch Fecha y hora Numérico sí Fecha y hora en formato Unix time.
OUTPUT:
EJEMPLO CON CURL:
$ curl -u <api_key>:<password>
     -X GET
     https://<hostname>/api/fleet/2450/1521137708
RESPUESTA:
{
    "lastPointBefore": {
        "vehId": 250,
        "driverId": null,
        "vehDescr": "Mazda - CRX (P-453QRR)",
        "vehStat": 0,
        "place": "Parqueo Oficina",
        "orgn": "Bodega 3",
        "refId": "1319",
        "epoch": "1521070870",
        "x": "-90.518155",
        "y": "14.552508",
        "event": 2,
        "eventDescription": "apagó motor",
        "speed": 0,
        "heading": 7,
        "odometer": 16435.5,
        "ignOnHrs": 6098.7862
    },
    "firstPointAfter": {
        "vehId": 250,
        "driverId": "15",
        "vehDescr": "Mazda - CRX (P-453QRR)",
        "vehStat": 0,
        "place": "Parqueo Oficina",
        "orgn": "Parqueo Oficina",
        "refId": "1319",
        "epoch": "1521116499",
        "x": "-90.518155",
        "y": "14.552508",
        "event": 3,
        "eventDescription": "arrancó motor",
        "speed": 0,
        "heading": 7,
        "odometer": 16435.5,
        "ignOnHrs": 6098.7923
    }
}

M: Ubicación por fecha por número de placa

HTTP GET:
https://<hostname>/api/fleet/licensePlate/<license_plate>/<epoch>
URL PARAMETERS:
Nombre Tipo Requerido Descripción
license_plate Placa Texto sí Placa del vehículo.
epoch Fecha y hora Numérico sí Fecha y hora en formato Unix time.
OUTPUT:
EJEMPLO CON CURL:
$ curl -u <api_key>:<password>
     -X GET
     https://<hostname>/api/fleet/licensePlate/P-453QRR/1521137708
RESPUESTA:
{
    "lastPointBefore": {
        "vehId": "250",
        "driverId": 15,
        "vehDescr": "Mazda - CRX (P-453QRR)",
        "vehStat": "0",
        "place": "Parqueo Oficina",
        "orgn": "Bodega 3",
        "refId": "1319",
        "epoch": "1521070870",
        "x": "-90.518155",
        "y": "14.552508",
        "event": "2",
        "eventDescription": "apagó motor",
        "speed": "0",
        "heading": "7",
        "odometer": "16435.5",
        "ignOnHrs": "6098.7862"
    },
    "firstPointAfter": {
        "vehId": "250",
        "driverId": 15,
        "vehDescr": "Mazda - CRX (P-453QRR)",
        "vehStat": "0",
        "place": "Parqueo Oficina",
        "orgn": "Parqueo Oficina",
        "refId": "1319",
        "epoch": "1521116499",
        "x": "-90.518155",
        "y": "14.552508",
        "event": "3",
        "eventDescription": "arrancó motor",
        "speed": "0",
        "heading": "7",
        "odometer": "16435.5",
        "ignOnHrs": "6098.7923"
    }
}

O: Location Data Object

Contiene la ubicación y estado actual de un vehículo. Cada objeto tiene estos campos:

Campo Descripción
vehId Id del Vehículo
driverId Id del Conductor asignado al Vehículo
vehDescr Descripción del Vehículo
vehStat Estado del vehículo (0=normal, 1=en reparación, 2=fuera de uso, 3=dispositivo de rastreo en reparación, 4=uso esporádico
place Dirección en la que se encuentra el Vehículo.
orgn Lugar en donde se inició el viaje actual.
refId Id de la Geocerca en la que se encuentra el Vehículo.
epoch Fecha del último reporte de posición en formato Unix time.
x Longitud
y Latitud
event Id/Código de evento (0=en movimiento, 1=paró, 2=ignición apagada, 3=ignición encendida, etc)
eventDescription Nombre del evento
speed Velocidad del Vehículo en km/h
heading Rumbo del último reporte de posición en grados
odometer Odómetro del Vehículo en km
ignOnHrs Cantidad de horas que el Vehículo ha tenido la ignición encendida
tripDist Distancia recorrida en el viaje actual en km
direction Rumbo promedio de ultimos 10 reportes de posición en grados

Todos los campos son read-only (no editables).