Usage
This endpoint helps you to keep track of your current usage of the MapTrip Server API (see limits for regular usage and demo usage).
The usage refers to your company. If you use several users or API keys, the result contains the sum of them.
Usage is counted per day and reset daily at midnight (Central European Time).
Query Usage Data
The endpoint [GET] /usage
does not have any parameters:
curl -X "GET" "https://api.maptrip.de/v1/usage" -H "accept: application/json" -H "Authorization: Bearer <token>"
The result contains your company, the day to which the data relates and the usage data:
{
"company": "Your Company",
"daily": {
"for": "2024-02-15",
"usage": {
"geocoder": 1251,
"route": 940,
"optimize": 25,
"detour": 682
}
}
}
The use of the API endpoints is aggregated. For example, the value geocoder
contains the sum of the
endpoints [GET] /geocoder
, [GET] /geocoder/structured
and [GET] /geocoder/reverse
, as they count for the same limit.
Additional Statistics
For some endpoints, the usage data contains additional statistics. For example, for the endpoint
[GET] /route
you can see how many of the calculated routes contained toll information. All these statistics
are named <api>-stats-<name>
These statistics are available:
route-stats-sum-distance
: The total distances of calculated routes in kmroute-stats-count-traffic
: The number of routes calculated with traffic informationroute-stats-count-toll
: The number of calculated routes with length of toll roadsroute-stats-count-toll-costs
: The number of calculated routes with toll costsroute-stats-count-international
The number of calculated routes through several countriesroute-stats-count-emergency
: The number of calculated emergency routesroute-stats-count-detour
: The number of routes calculated with a detour profileroute-stats-count-vehicle-attributes
: The number of routes calculated with vehicle attributes like height, weight, axle load etc.remote-stats-count-send-itinerary
: The number of itineraries sent to a deviceremote-stats-count-send-reference-route
: : The number of reference routes sent to a devicematrix-stats-sum-routes
: The number of routes calculated for route matrices