Maps
Find addresses, resolve coordinates, calculate routes
A search with a result list, geocoding in both directions and routes with stopovers. Several map providers work behind the API, and you pay per successful request.
For businesses and self-employed professionals only
- Address search 1.00 EUR per 1,000 successful requests
- Geocoding 1.00 EUR per 1,000 successful requests
- Route 2.00 EUR per 1,000 successful requests
/v1/maps/search?q=Alexanderplatz%201%20Berlin&limit=1
curl "https://api.flowdata.one/v1/maps/search?q=Alexanderplatz%201%20Berlin&limit=1" \
-H "Authorization: Bearer fd_YOUR_KEY"
{
"success": true,
"addresses": [
{
"lat": 52.5219,
"lng": 13.4132,
"full_address": "Alexanderplatz 1, 10178 Berlin, Germany",
"address_name": "Alexanderplatz 1",
"address_number": "1",
"street_name": "Alexanderplatz",
"postcode_name": "10178",
"locality_name": "Mitte",
"place_name": "Berlin",
"region_name": "Berlin",
"region_code": "BE",
"country_name": "Germany",
"country_code": "DE"
}
],
"attribution": "NOTICE: © 2026 Creative Skyline and its suppliers. All rights reserved. Use of this data is subject to the Creative Skyline Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}
Fields and structure as in the API, the values are examples.
Endpoints
Every response carries success, the result and a note in attribution. Use language to choose the language of the results.
| GET | /v1/maps/search |
Address and place search with q, optionally limit (1 to 10), country, proximity and types. |
|---|---|---|
| GET | /v1/maps/geocode |
Address to coordinates with address, coordinates to address with lng and lat. |
| GET | /v1/maps/directions |
Route with origin, destination, waypoints and profile: driving, driving-traffic, walking or cycling. |
The three tools
-
Address search
Up to 10 results with
full_address, street, house number, postal code, city, region and country. Narrow it down withcountryandproximity. -
Geocoding
One call, two directions:
addressreturns coordinates,lngandlatreturn an address. -
Routes
Distance and duration between two points, optionally with stopovers (
waypoints, separated by|) and alternative routes.
Providers and storage
-
Several providers
Depending on the query and availability, Mapbox, Google, MapTiler, Nominatim or Radar answers. FlowData makes the choice.
-
Result store
We store found addresses and answer identical requests from there. An answer from the store is billed like any other.
Screenshots show the FlowData interface in German, with the example data of a fictional company.
What to expect
Search terms and coordinates go to the map provider that answers. We keep found addresses in our result store.
A search with no results is free, and so are requests that end in an error.
The API returns data, not map tiles. To show a map you embed a map library yourself.
The map providers have their own terms of use. The response names them in the
attributionfield, and according to that note results may not be stored permanently.
Responses via Nominatim contain data from OpenStreetMap: © OpenStreetMap contributors, available under the Open Database License (ODbL). OpenStreetMap license
Frequently asked questions
full_address) and its parts, so you can compose it freely in your form or database.
driving-traffic. driving, walking and cycling are also available.