De TowingVehiclePositionResourcesApi kan gebruikt worden om de actuele positie van een bergingsvoertuig op te vragen voor een bepaalde opdracht. De positie wordt alleen teruggegeven als de opdracht de status ‘Toegewezen’ (Assigned) of ‘Ter plaatse’ (Arrived) heeft. Zodra de status ter plaatse is bereikt zal de voertuigpositie nog 15 minuten beschikbaar zijn.

Als de opdracht een andere status heeft of wanneer de 15 minuten verstreken zijn, zal er een 404 Not Found antwoord terug gegeven worden.

Positie opvragen

Zie Publieke API voor meer informatie over het algemene gebruik van de publieke API.

GET /tenants/{tenantId}/orders/{id}/towing-vehicle-position

De resource locatie komt ook terug in de https://rgbplus.atlassian.net/wiki/spaces/AS/pages/2169241606/Webhooks#nl.assistanceonline.webhooks.orderstatuschanged.v1.1 als TowingVehiclePositionReference.

Antwoordbericht

Als er een voertuigpositie gevonden is volgt er een JSON antwoord zoals het voorbeeld hieronder:

{
  "coordinates": {
    "latitude": 52.532,
    "longitude": 4.999432
  },
  "updatedAt": 2022-01-07T12:50:42.2466110Z,
  "resourceType": "nl.assistanceonline.resources.towing-vehicle-position.v1",
  "resourceReference": {
    "orderId": "017d993e-593a-4046-86f0-3f1c25312b67",
    "referenceString": "/tenants/1/orders/017d993e-593a-4046-86f0-3f1c25312b67/towing-vehicle-position",
    "tenantId": 1
  }
}