Menu

Documentation

Maps API

Search addresses and places, turn addresses into coordinates and calculate routes between points, with one request and one key.

Search
https://api.flowdata.one/v1/maps/search
Geocoding
https://api.flowdata.one/v1/maps/geocode
Directions
https://api.flowdata.one/v1/maps/directions

OpenAPI file for this area

Quick start

FlowData key
This API belongs to FlowData and uses its own keys (fd_...), which you create in the dashboard under API keys. FlowSuite keys (pk_..., at_...) keep working, but we recommend a FlowData key.
Data sources
Results come from map services: Mapbox, Google, MapTiler and Nominatim. To answer your request it is sent to one of these providers. Data from Nominatim: © OpenStreetMap contributors, ODbL.

Overview

The Maps API offers three functions:

  • Search: find addresses and places worldwide
  • Geocoding: turn addresses into coordinates and coordinates into addresses
  • Directions: calculate routes between two or more points

Every successful response contains an attribution field with the terms of use of the data.

Geocoding

Forward and reverse
Pass either address (address to coordinates) or lng and lat (coordinates to address).
GET
/v1/maps/geocode

Resolve an address or coordinates

Turns an address into coordinates and full address data, or coordinates back into an address. Only a successful response is billed; 404 without a result is free.

Bearer fd_… 1.00 EUR per 1,000 successful requests

Query parameters

Name Type Description
address string Address for the forward lookup
lng number Longitude for the reverse lookup, together with lat
lat number Latitude for the reverse lookup, together with lng
country string Country filter, ISO 3166-1 alpha-2
language string Language of the results, default de
curl -X GET "https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_YOUR_KEY')
    ->get('https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin',
    headers=headers,
)

data = response.json()
{
    "success": true,
    "address": {
        "full_address": "Friedrichstraße 43, 10117 Berlin, Deutschland",
        "lat": 52.5094,
        "lng": 13.3889,
        "place_name": "Berlin",
        "postcode_name": "10117",
        "country_name": "Deutschland",
        "country_code": "DE"
    },
    "attribution": "NOTICE: © 2026 FlowSuite and its suppliers. All rights reserved. Use of this data is subject to the Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}

Directions

GET
/v1/maps/directions

Calculate a route

Calculates a route between two or more points, with distance, duration and geometry. Only a successful response is billed; 404 without a route is free.

Bearer fd_… 2.00 EUR per 1,000 successful requests

Query parameters

Name Type Description
origin string
Required
Start point as lng,lat, for example 13.4050,52.5200
destination string
Required
Destination as lng,lat
profile string driving, driving-traffic, walking or cycling, default driving-traffic
waypoints string Waypoints as lng,lat, separated by |
language string Language of the instructions, default de
curl -X GET "https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163" \
  -H "Authorization: Bearer fd_YOUR_KEY" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_YOUR_KEY')
    ->get('https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163');

$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
import requests

headers = {
    'Authorization': 'Bearer fd_YOUR_KEY',
    'Accept': 'application/json',
}

response = requests.get(
    'https://api.flowdata.one/v1/maps/directions?origin=13.4050%2C52.5200&destination=13.3777%2C52.5163',
    headers=headers,
)

data = response.json()
{
    "success": true,
    "routes": [
        {
            "distance": 3120.4,
            "duration": 540.2,
            "legs": [
                {
                    "distance": 3120.4,
                    "duration": 540.2
                }
            ]
        }
    ],
    "attribution": "NOTICE: © 2026 FlowSuite and its suppliers. All rights reserved. Use of this data is subject to the Terms of Service (https://creativeskyline.de/agb). This response and the information it contains may not be retained."
}

One key is all it takes to start.

Create a key and call the API. Client info is free; everything else is billed per successful request.

Create an API key Documentation

FlowData is aimed exclusively at businesses and self-employed professionals.