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 Id del vehículo.
epoch Fecha y hora Numérico Fecha y hora en formato Unix time.

OUTPUT:

(ver: Location Data Object)

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 Placa del vehículo.
epoch Fecha y hora Numérico Fecha y hora en formato Unix time.

OUTPUT:

(ver: Location Data Object)

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

Cada objeto tiene estos campos:

campo read-only
vehId correlativo vehículo
driverId correlativo conductor
vehDescr texto que describe al 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 lugar donde se encuentra
orgn lugar donde inició el viaje
refId id de geocerca/POI en que se encuentra
epoch unix timestamp
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 descipción de evento
speed km/h
heading rumbo del último punto (grados)
odometer km
ignOnHrs horas ignición encendida
tripDist km
direction rumbo promedio de ultimos 10 puntos (grados)