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

Our API provided 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.

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`)

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

Our API provided 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 properties id and name.
[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 latest price for 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:

Diesel
Super E5
Super E10
SuperPlus
Autogas

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:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          7.1012,
          50.738101
        ]
      },
      "properties": {
        "id": "149122",
        "name": "bft Bonn Zentrum",
        "price": "1.579",
        "brand": "bft"
      }
    },
    ...
  ]
}

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>"

{
  "name": "bft Bonn Zentrum",
  "brand": "bft",
  "address": {
    "city": "Bonn",
    "zipcode": "53111",
    "street": "Kölnstr. 10-16"
  },
  "payment": [
    "American Express",
    "AVIA Tankkarte",
    "Cash",
    "Diners Club",
    "DKV",
    "EC",
    "EuroCard/MasterCard",
    "euroShell Tankkarte",
    "girocard",
    "Maestro",
    "Total Card",
    "UTA",
    "V-Pay",
    "VISA",
    "Westfalen Service Card"
  ],
  "openingHours": [
    "Monday-Friday: 00:00-24:00",
    "Saturday: 00:00-24:00",
    "Sunday: 00:00-24:00",
    "Holiday (NRW): 00:00-24:00"
  ],
  "services": [
    "Shop",
    "Car wash",
    "Garage",
    "ATM"
  ],
  "prices": [
    {
      "fuelType": "SuperE5",
      "price": 1.619,
      "date": "2025-07-24T13:25:29Z"
    },
    {
      "fuelType": "Diesel",
      "price": 1.519,
      "date": "2025-07-24T13:07:36Z"
    },
    {
      "fuelType": "SuperPlus",
      "price": 1.699,
      "date": "2025-07-24T13:25:29Z"
    },
    {
      "fuelType": "SuperE10",
      "price": 1.559,
      "date": "2025-07-24T13:25:29Z"
    }
  ]
}

The texts in the highlighted lines are translated according to the header Accept-Language. Texts are available in English (default), German and Ukrainian.