Points of Interest
Points of interest (POIs) are points that are of interest for navigation, route planning or map applications. They consist of a coordinate and other properties that describe the point. These properties can be, for example, a name, the address or URLs.
The MapTrip Server API provides endpoints to query points of interest in a bounding box. The result is a GeoJSON feature collection of all POIs in the bounding box.
Truck Parking Areas
The MapTrip Server API provides access to truck parking areas by our partners Happy Trucker and Bosch Secure Truck Parking. Live information on occupancy is provided for German parking areas by Toll Collect.
License option required
Querying truck parking areas requires a separate license option. If you are interested in this, please contact our sales team.
Properties
The endpoint [GET] /poi/parking/{from}/{to} returns truck parking areas in the specified bounding box. Every parking area is returned as a point feature with properties. Not all properties are available for every provider:
| Property | Bosch Secure Truck Parking | Happy Trucker | Toll Collect SID | Description |
|---|---|---|---|---|
provider |
Bosch | HappyTrucker | TollCollect | the data provider |
id |
yes | yes | yes | the ID of the parking area |
name |
yes | yes | yes | the name of the parking area |
address |
yes | yes | no | the address of the area |
images |
yes | yes | no | a list of URLs to images of this area |
details |
yes | yes | no | the URL to the details page with additional information and booking options |
road |
no | no | yes | the road where this parking area is located |
spaces |
no | no | yes | the amount of parking spaces at this area |
occupancy |
no | no | yes | the current occupancy status (one of SPACES_AVAILABLE, ALMOST_FULL and FULL) |
Example
The resulting GeoJSON looks like this:
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
9.93985,
53.668306
]
},
"properties": {
"provider": "TollCollect",
"id": "DE-SH-007101",
"name": "Bönningstedt Ost",
"road": "A7",
"spaces": "14",
"occupancy": "ALMOST_FULL"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
9.966111,
53.52694
]
},
"properties": {
"images": [
"https://api.maptrip.de/internal/poi/parking/image/png/4021",
"https://api.maptrip.de/internal/poi/parking/image/webp/4022",
"https://api.maptrip.de/internal/poi/parking/image/jpeg/4023",
"https://api.maptrip.de/internal/poi/parking/image/png/4024",
"https://api.maptrip.de/internal/poi/parking/image/jpeg/3959",
"https://api.maptrip.de/internal/poi/parking/image/png/7052"
],
"address": {
"city": "Hamburg",
"zipcode": "20457",
"street": "Buchheisterstraße 16",
"country": "DEU"
},
"provider": "Bosch",
"name": "Cruise Center Steinwerder",
"details": "https://portal.bosch-secure-truck-parking.com/en/?detail=1&id=4604&locale=en",
"id": "4604"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
9.966111,
53.52694
]
},
"properties": {
"images": [
"https://happy-trucker.de/image/bosch/3959.jpeg",
"https://happy-trucker.de/image/bosch/5746e609ab39cfe25315ed946293de8f.png",
"https://happy-trucker.de/image/bosch/4024.png",
"https://happy-trucker.de/image/bosch/4021.png",
"https://happy-trucker.de/image/bosch/4022.webp",
"https://happy-trucker.de/image/bosch/ad1b7ec52eab78e3180c7cd87d9ce913.png"
],
"address": {
"city": "Hamburg",
"zipcode": "20457",
"street": "Buchheisterstraße 16",
"housenumber": "",
"country": "DEU"
},
"provider": "HappyTrucker",
"name": "Cruise Center Steinwerder",
"details": "https://www.happy-trucker.de/en/truck-parking/cruise-center-steinwerder-413",
"id": "413"
}
}
]
}
Names and detail URLs are available in several languages. You can use the HTTP header Accept-Language to choose the language. If the specified language is not supported or there is no Accept-Language header, English is used as default.
Fuel Stations
The MapTrip Server API provides access to fuel stations and fuel prices by our partner clever-tanken.de.
License option required
Querying fuel stations requires a separate license option. If you are interested in this, please contact our sales team.
There are three endpoints related to fuel stations:
[GET] /poi/fuelstations/{from}/{to}queries all fuel stations in the provided bounding box. The result is a GeoJSON feature collection with a point feature for every station. Every station has the propertiesidandname.[GET] /poi/fuelstations/{fuelType}/{from}/{to}also returns a GeoJSON with all the fuel stations in the bounding box. Every fuel station has two additional properties: The latestpricefor the provided fuel type in Euro, and the brand of the fuel station.[GET] /poi/fuelstations/{id}queries detailed information for a fuel station like the address, payment information, opening hours, services and the prices for all types of fuel.
Fuel Types
The API currently supports these fuel types:
DieselSuper E5Super E10SuperPlusAutogas
Example: GeoJSON with fuel stations
This curl command fetches the fuel stations in the center of Bonn including prices for Diesel:
curl -X GET "https://api.maptrip.de/v1/poi/fuelstations/Diesel/50.7250666%2C7.0705372/50.7499723%2C7.1117788" -H "accept: application/json" -H "Authorization: Bearer <token>"
The resulting GeoJSON looks like this:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | |
Stations which do not offer the specified type of fuel are not returned.
A call to the endpoint [GET] /poi/fuelstations/{from}/{to} would return the same result without the highlighted properties price and brand.
Example: Fuel station details
To retrieve the details of the fuel station from the example above, you can use the property id:
curl "https://api.maptrip.de/v1/poi/fuelstations/149122" -H "accept: application/json" -H "Accept-Language: en" -H "Authorization: Bearer <token>"
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 | |
The texts in the highlighted lines are translated according to the header Accept-Language.
Texts are available in English (default), German and Ukrainian.
Road Works
There are two endpoints which return road works on German highways provided by Die Autobahn GmbH des Bundes. They return the same road works, but in one case as point layer and in the other case as line layer.
Depending on your use case, you can use one or the other layer or combine both. For example, you can show the point layer on overview maps and add the detailed lines when zooming into the map.
Properties
| Property | Description | Example |
|---|---|---|
id |
Identifier for this road works | DE-MIA#2025-008782#1 |
type |
Type of the road works (construction or maintenance) | ConstructionWorks |
road |
Name of the road or identifier of the highway | A23 |
startName |
Name of the beginning of the section being worked on | Buddenkuhle |
endName |
Name of the end of the section being worked on | Rathebur |
startDate |
Start date of the road works | 2025-08-04 |
endDate |
End date of the road works | 2025-09-07 |
length |
Length of the road works in meters | 250 |
residualRoadWidth |
Remaining width available for vehicles in meters | 7.0 |
speedLimit |
Speed limit for this road works | 50 |
description |
Description of the road works | Straßenneubau |
laneStatus |
Status code indicating which lanes can be used | 2oerx |
Example
This request queries road works in Hamburg as a point feature layer:
curl "https://api.maptrip.de/v1/poi/roadworks/points/53.60778%2C9.87150/53.52173%2C10.06651" -H "accept: application/json" -H "Authorization: Bearer <token>"
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
10.022998,
53.523663
]
},
"properties": {
"endDate": "2025-10-24",
"road": "A255",
"endName": "Buntentor",
"description": "Beseitigung Unfallfolgen",
"id": "DE-MIA#2025-050530#1",
"type": "MaintenanceWorks",
"laneStatus": "2ooooxrx",
"startDate": "2025-10-23"
}
},
...
]
}