Bergingsvoertuigpositie (Towing-vehicle-position)
- Niels
Towing Vehicle Position Resources Api
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
Parameter | Type | Omschrijving |
|---|---|---|
tenantId | int | Het nummer van de administratie |
id | Guid | Opdracht identifier |
De resource locatie komt ook terug in de 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": "/tenants/1/orders/017d993e-593a-4046-86f0-3f1c25312b67/towing-vehicle-position"
}Veld | Type | Omschrijving |
|---|---|---|
coordinates | Coördinaten van het voertuig. Deze kunnen onbekend zijn. | |
updatedAt | DateTimeOffset | Tijdstip waarop de coördinaten ontvangen zijn |
resourceType | string | vaste waarde: |
resourceReference | string | Resource referentie |
Â