Geocoding wandelt eine Adresse in Koordinaten um, etwa um Kundenadressen auf einer Karte anzuzeigen oder Entfernungen zu berechnen. Umgekehrt findest du mit Reverse Geocoding die Adresse zu einem Punkt, zum Beispiel zu einem GPS-Standort aus einer App. Beides läuft über denselben Endpunkt und liefert genau einen, den besten Treffer.
Adresse in Koordinaten umwandeln
Übergib die Adresse im Parameter address, höchstens 256 Zeichen. Optional schränkst du mit country auf ein Land ein und wählst mit language die Sprache der Namen (Standard de).
curl "https://api.flowdata.one/v1/maps/geocode?address=Alexanderplatz%201,%2010178%20Berlin&country=DE&language=de" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
Die Antwort enthält im Feld address genau einen Treffer:
{
"success": true,
"address": {
"lat": 52.521918,
"lng": 13.413215,
"full_address": "Alexanderplatz 1, 10178 Berlin, Deutschland",
"address_name": "Alexanderplatz 1",
"address_number": "1",
"street_name": "Alexanderplatz",
"postcode_name": "10178",
"locality_name": "Mitte",
"place_name": "Berlin",
"place_code": "BE",
"region_name": "Berlin",
"region_code": "BE",
"country_name": "Deutschland",
"country_code": "DE"
},
"attribution": "NOTICE: © 2026 ..."
}
Die Felder sind dieselben wie bei der Ortssuche, dazu kommt place_code, ein Kürzel des Ortes. Die Bedeutung aller Felder steht in Wie suche ich mit Maps nach Orten und Adressen?.
Koordinaten in eine Adresse umwandeln
Für den umgekehrten Weg gibst du statt address die beiden Parameter lat (Breitengrad, -90 bis 90) und lng (Längengrad, -180 bis 180) mit. Sobald beide gesetzt sind, arbeitet der Endpunkt rückwärts.
curl "https://api.flowdata.one/v1/maps/geocode?lat=52.5219&lng=13.4132" \
-H "Authorization: Bearer fd_DEIN_SCHLUESSEL"
Die Antwort hat dieselbe Form wie oben. Du bekommst die Adresse, die dem Punkt am nächsten liegt.
Wenn nichts gefunden wird
Findet Maps keine passende Adresse, kommt HTTP 404 zurück:
{"success":false,"error":"No address data found for this address"}
Beim Reverse Geocoding lautet der Text No address found for the specified coordinates. Typische Ursachen sind Tippfehler, eine fehlende Postleitzahl, ein falscher Ländercode oder Koordinaten, die auf Wasser oder freies Gelände zeigen.
Fehlen sowohl address als auch lat und lng, oder gibst du nur einen der beiden Koordinatenwerte an, antwortet Maps mit HTTP 422 und nennt unter details die betroffenen Felder:
{"success":false,"error":"Invalid parameters","details":{"address":["Das Feld address ist erforderlich, wenn keines von lng / lat vorhanden ist."]}}
Warum bekomme ich eine Nachbaradresse?
Maps merkt sich bereits ermittelte Adressen, damit wiederholte Anfragen schneller beantwortet werden. Beim Reverse Geocoding kann deshalb eine schon bekannte Adresse in unmittelbarer Nähe zurückkommen, etwa das Nachbarhaus. Für Karten ist das in der Regel genau genug. Brauchst du die Hausnummer exakt, lass die Person die Adresse bestätigen.
Aus demselben Grund können Namen in einer anderen Sprache ankommen als der in language angegebenen, wenn die Adresse schon einmal in dieser anderen Sprache ermittelt wurde.
Warum passt das Ergebnis bei kurzen Eingaben nicht?
Geocoding ist für vollständige Adressen gedacht. Bei sehr kurzen oder allgemeinen Eingaben wie „Berlin“ oder „Hauptstraße“ kann ein beliebiger Treffer zurückkommen, der den Begriff enthält, zum Beispiel irgendeine Straßenadresse in Berlin. So bekommst du verlässliche Ergebnisse:
- Gib Straße, Hausnummer, Postleitzahl und Ort an.
- Setze
country, wenn du das Land kennst. - Für Suchbegriffe, Ortsnamen und Autovervollständigung nutzt du die Ortssuche. Sie liefert mehrere Treffer, aus denen du den richtigen auswählst.
Was kostet eine Anfrage?
Geocoding wird je 1.000 erfolgreiche Anfragen berechnet, in beide Richtungen zum selben Preis. Antworten mit HTTP 404 oder 422 und Serverfehler sind kostenlos. Die Beträge stehen auf der Preisseite, Details in FlowData-Preise verstehen.
Gut zu wissen
- Achte auf die Namen: Geocoding nutzt die getrennten Parameter
latundlng. In der Routenberechnung schreibst du Koordinaten dagegen alsLängengrad,Breitengradin einen Wert, siehe Wie berechne ich mit Maps eine Route?. - Die Antwort enthält einen Nutzungshinweis im Feld
attribution. Die Daten dürfen nicht dauerhaft gespeichert werden.