Menü

Dokumentation

Maps API

Suche Adressen und Orte, wandle Adressen in Koordinaten um und berechne Routen zwischen Punkten, mit einer Anfrage und einem Schlüssel.

Suche
https://api.flowdata.one/v1/maps/search
Geokodierung
https://api.flowdata.one/v1/maps/geocode
Routen
https://api.flowdata.one/v1/maps/directions

OpenAPI-Datei dieses Bereichs

Schnellstart

FlowData-Schlüssel
Diese API gehört zu FlowData und nutzt eigene Schlüssel (fd_...), die du im Dashboard unter API-Schlüssel anlegst. FlowSuite-Schlüssel (pk_..., at_...) funktionieren weiterhin, wir empfehlen aber einen FlowData-Schlüssel.
Datenquellen
Die Ergebnisse stammen von Kartendiensten: Mapbox, Google, MapTiler und Nominatim. Für ein Ergebnis wird deine Anfrage an einen dieser Anbieter übermittelt. Daten aus Nominatim: © OpenStreetMap-Mitwirkende, ODbL.

Überblick

Die Maps API bietet drei Funktionen:

  • Suche: Adressen und Orte weltweit finden
  • Geokodierung: Adressen in Koordinaten umwandeln und Koordinaten in Adressen
  • Routen: Routen zwischen zwei oder mehr Punkten berechnen

Jede erfolgreiche Antwort enthält ein Feld attribution mit den Nutzungsbedingungen der Daten.

Geokodierung

Vorwärts und rückwärts
Gib entweder address an (Adresse zu Koordinaten) oder lng und lat (Koordinaten zu Adresse).
GET
/v1/maps/geocode

Adresse oder Koordinaten auflösen

Wandelt eine Adresse in Koordinaten und vollständige Adressdaten um oder Koordinaten zurück in eine Adresse. Berechnet wird nur eine erfolgreiche Antwort; 404 ohne Treffer ist kostenlos.

Bearer fd_… 1,00 EUR je 1.000 erfolgreiche Anfragen

Query-Parameter

Name Typ Beschreibung
address string Adresse für die Vorwärtssuche
lng number Längengrad für die Rückwärtssuche, zusammen mit lat
lat number Breitengrad für die Rückwärtssuche, zusammen mit lng
country string Länderfilter, ISO 3166-1 alpha-2
language string Sprache der Ergebnisse, Standard de
curl -X GET "https://api.flowdata.one/v1/maps/geocode?address=Friedrichstra%C3%9Fe%2043%2C%2010117%20Berlin" \
  -H "Authorization: Bearer fd_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->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_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
  },
});

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

headers = {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    '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."
}

Routen

GET
/v1/maps/directions

Route berechnen

Berechnet eine Route zwischen zwei oder mehr Punkten, mit Entfernung, Dauer und Geometrie. Berechnet wird nur eine erfolgreiche Antwort; 404 ohne Route ist kostenlos.

Bearer fd_… 2,00 EUR je 1.000 erfolgreiche Anfragen

Query-Parameter

Name Typ Beschreibung
origin string
Pflicht
Startpunkt als lng,lat, zum Beispiel 13.4050,52.5200
destination string
Pflicht
Zielpunkt als lng,lat
profile string driving, driving-traffic, walking oder cycling, Standard driving-traffic
waypoints string Zwischenstopps als lng,lat, getrennt durch |
language string Sprache der Wegbeschreibung, Standard 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_DEIN_SCHLUESSEL" \
  -H "Accept: application/json"
use Illuminate\Support\Facades\Http;

$response = Http::withToken('fd_DEIN_SCHLUESSEL')
    ->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_DEIN_SCHLUESSEL',
    'Accept': 'application/json',
  },
});

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

headers = {
    'Authorization': 'Bearer fd_DEIN_SCHLUESSEL',
    '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."
}

Ein Schlüssel reicht für den Anfang.

Leg einen Schlüssel an und ruf die API auf. Client-Info kostet nichts, alles andere rechnest du je erfolgreicher Anfrage ab.

API-Schlüssel anlegen Dokumentation

FlowData richtet sich ausschließlich an Unternehmen und Selbstständige.