Query for location-based apps
These location-based PACE apps deliver additional services for PACE customers based on their current position. You can (or should) trigger this whenever:
- A longer stand-still is detected
- The engine is turned off
- Every 5 seconds if the user "left the road"
Please note that calling this API is very cheap and can be done regularly.
Query parameters
-
filter[latitude]
number(float) Required Latitude
-
filter[longitude]
number(float) Required Longitude
-
filter[appType]
string Type of location-based app
Value is
fueling
.
400
application/vnd.api+json
Bad request
401
application/vnd.api+json
OAuth token missing or invalid or a linked identity is missing.
Linked identity missing is a special case where you need to make sure that the user has additionally logged in / authorized with a third-party.
This is not relevant for most use-cases.
The specific error code that identifies a missing linked identity is missing-linked-identity
Example:
{
"errors": [
{
"id": "cbgmhslmp1o9or9kh1p0",
"title": "Missing linked identity for authorized access",
"detail": "Linked identity is needed to access this resource, please check why the user does not have a linked identity",
"status": "401",
"code": "missing-linked-identity"
}
]
}
406
application/vnd.api+json
The specified accept header is invalid
500
application/vnd.api+json
Internal server error