Ein Geocode ist eine Koordinate, die eine Adresse einem Punkt auf der Erde zuordnet. Er verbindet die Ortsnamen, die Menschen verwenden („10 Downing Street, London“), mit Geometrie, die Maschinen lesen können (51.5034, -0.1276). Hinter jeder Kartenmarkierung, die Sie je angeklickt haben, jeder Schaltfläche „Hierhin liefern“ und jeder Suche „In der Nähe“ steckt irgendwo ein Geocode.
Dieser Leitfaden erklärt, was ein Geocode genau ist, was eine Geocoding-API im Betrieb neben der Koordinate zurückgibt, wie Sie Trefferpräzision und Konfidenz lesen und wo die typischen Stolpersteine liegen.
Was ein Geocode wirklich ist
Streng genommen ist ein Geocode ein einzelner Punkt auf der Erdoberfläche, ausgedrückt als Paar aus Breiten- und Längengrad in einem bekannten Bezugssystem (fast immer WGS84, dasselbe System, das auch das GPS Ihres Smartphones nutzt). Der Breitengrad reicht von -90 (Südpol) bis +90 (Nordpol), der Längengrad von -180 bis +180, mit 0 am Nullmeridian von Greenwich.
Im weiteren Sinn meint „Geocode“ oft das Ergebnis einer Geocoding-API. Dieses Ergebnis enthält neben der Koordinate meist eine Reihe weiterer Metadaten: die normalisierte Adresse, eine Orts-ID, eine Präzisionsstufe, einen Konfidenzwert und eine Bounding Box. Im Code speichern und verarbeiten Sie in der Praxis dieses umfangreichere Objekt.
Die Koordinate allein sagt Ihnen, wo etwas liegt. Die Metadaten sagen Ihnen, wie sicher Sie sein können, dass dieses Wo stimmt.
Forward und Reverse Geocoding
Es gibt zwei Richtungen, und meist deckt derselbe API-Endpoint beide ab.
Forward Geocoding macht aus Text Koordinaten. Eingabe: „Eiffel Tower, Paris“. Ausgabe: 48.8584, 2.2945, dazu die Art des gefundenen Orts (hier eine Sehenswürdigkeit), die Verwaltungsgliederung (Paris, Île-de-France, Frankreich) und eine Bounding Box für das Objekt.
Reverse Geocoding macht aus Koordinaten Text. Eingabe: 48.8584, 2.2945. Ausgabe: eine strukturierte Adresse (Avenue Gustave Eiffel, 75007 Paris, Frankreich), die Art des Orts und meist eine Liste nahegelegener Points of Interest.
Forward Geocoding steckt hinter der Adressvervollständigung im Checkout, hinter Filialfindern und hinter Pipelines, die eine CSV-Datei auf eine Karte bringen. Reverse Geocoding steckt hinter Schaltflächen wie „Abholung in der Nähe“, hinter Fotos mit Ortsangabe und hinter jeder Funktion, bei der Nutzer eine Markierung auf die Karte setzen und die App einen Namen dafür braucht. Die nächsten Abschnitte behandeln die Antwort beim Forward Geocoding, Reverse Geocoding hat weiter unten einen eigenen Abschnitt.
Was eine Geocoding-API zurückgibt
Eine Koordinate allein reicht nicht, um eine Funktion auszuliefern. Eine ernstzunehmende Geocoding-API gibt ein strukturiertes Objekt zurück, mit dem Ihr Code Entscheidungen treffen kann. Diese Felder zählen:
latitude/longitudein WGS84formatted_address: die normalisierte Adresse als Zeichenkette für die Anzeigeplace_id: eine stabile Kennung, die Sie speichern und später erneut auflösen könnenprecision(manchmalmatch_typeoderaccuracy): rooftop, street, neighbourhood, postcode, locality oder country. Für geschäftliche Entscheidungen ist dieses Feld das wichtigsteconfidence: ein Zahlenwert (oft 0 bis 1), der angibt, wie sicher sich die API istbbox: die Bounding Box des gefundenen Objekts, nützlich, um den Kartenausschnitt an das Ergebnis anzupassenaddress_components: die Adresse in strukturierten Teilen (Straße, Hausnummer, Stadt, Region, Land, Postleitzahl)country_codeim Format ISO 3166-1 alpha-2
Zwei echte Datensätze können sehr unterschiedliche Präzision haben. Einen Treffer auf Gebäudeebene (rooftop) für eine Wohnadresse brauchen Sie, bevor Sie eine Lieferung losschicken. Ein Treffer auf Ebene der Postleitzahl genügt für „Zeig mir die nächste Filiale“. Ein Treffer auf Ortsebene (locality) heißt, dass Sie nur die Stadt kennen. Das reicht selten, um ohne Rückfrage zu handeln.
Wo Geocodes eingesetzt werden
Geocodes arbeiten unauffällig unter den meisten standortbezogenen Produktfunktionen.
- Adressvervollständigung: Jeder Tastendruck in einem Checkout-Formular löst ein Forward Geocoding aus, das eine sortierte Liste möglicher Treffer zurückgibt
- Filial- und Standortfinder: Die aktuelle Position des Nutzers (ein Geocode) wird mit einer Liste gespeicherter Standorte (ebenfalls Geocodes) abgeglichen und nach Haversine-Entfernung sortiert
- Zustellung und Disposition: Ein Forward Geocoding der Kundenadresse gibt der Fahrer-App eine genaue Koordinate für die Route
- Inserate und Bestände: Plattformen für Immobilien, Ferienwohnungen und Hotels geocoden jedes Inserat einmal beim Import, speichern die Koordinate und nutzen sie für die Suche „in dieser Gegend“
- Auswertungen und Dashboards: Eingehende Datensätze (Bestellungen, Support-Tickets, IoT-Ereignisse) erhalten einen Geocode, damit Sie sie nach Region zusammenfassen oder auf einer Karte zeigen können
- KI-Agenten und Assistenten: Fragt jemand ein LLM nach „einem Restaurant in meiner Nähe“, wandelt ein Geocoding-Schritt den Standort des Nutzers und die Kandidaten in Koordinaten um, damit das Modell mit Entfernungen rechnen kann
In all diesen Fällen ist der Geocode der gemeinsame Schlüssel. Er sorgt dafür, dass zwei Datensätze über denselben Ort auf derselben Karte landen, auch wenn der eine „Straße“ und der andere „Str.“ schreibt.
Reverse Geocoding im Detail
Reverse Geocoding nimmt eine WGS84-Koordinate und gibt den nächstgelegenen sinnvollen Ort zurück. Die eigentliche Arbeit steckt im Wort „sinnvoll“. Ein Punkt mitten auf einem Parkplatz hat keine eigene Adresse. Eine GPS-Position zehn Meter vor der Küste liegt gar nicht an Land. Der Reverse Geocoder muss entscheiden, welches Objekt der Nutzer mit großer Wahrscheinlichkeit meint: das Gebäude vor ihm, die Straße, auf der er gefahren ist, oder den Park, den er gerade betreten hat.
Diese Entscheidung zeigt sich in zwei Feldern, die Sie vor allen anderen lesen sollten:
- Art des Orts (manchmal
layerodermatch_type): Gebäude oder Adresse, Straße, Stadtteil, Ort, Park, Gewässer. Das Feld sagt, worauf der Punkt aufgelöst wurde. - Entfernung: wie weit das gefundene Objekt vom Abfragepunkt entfernt liegt. Ein Adresstreffer in drei Metern ist solide. Ein Straßentreffer in siebzig Metern heißt meist, dass die Markierung auf einem Feld gelandet ist.
Der Rest der Antwort entspricht dem Forward Geocoding: eine formatierte Adresse in der angefragten Sprache, eine Orts-ID, die Adressbestandteile und ein ISO-Ländercode.
Wo Reverse Geocoding eingesetzt wird
In jedem dieser Fälle erzeugt das Gerät oder der Nutzer zuerst einen Punkt, und die Adresse ergibt sich daraus:
- Checkout mit Markierung: Der Nutzer schiebt die Markierung genau auf seine Haustür, und die App zeigt ihm die Adresse zur Bestätigung
- Fotos mit Ortsangabe: Aus einer EXIF-Koordinate wird „Paris, Frankreich“ statt zweier Zahlen, auch wenn Sie alte Fotobibliotheken nachträglich im Stapel verarbeiten
- Schaltflächen „In der Nähe“: Die Position des Geräts wird zu einem Ort aufgelöst, mit dem eine Suche startet
- Telemetrie von Flotten und IoT-Geräten: Fahrtbeginn, Stopps und Sensorereignisse kommen als Koordinaten an und erhalten beim Import einmal eine Beschriftung, damit Dashboards Straßennamen zeigen
Weil hier die Koordinate die maßgebliche Quelle ist, speichern Sie die Koordinate und behandeln die aufgelöste Adresse als Anzeigewert, den Sie aktualisieren können.
Stolpersteine beim Reverse Geocoding
Punkte an der Küste und im Wasser. GPS-Rauschen setzt Markierungen regelmäßig in einen Fluss oder ein paar Meter aufs Meer. Manche APIs geben dann nichts zurück, andere springen zur nächsten Straße, wieder andere nennen das Gewässer. Legen Sie fest, wie Ihre Oberfläche mit einem Treffer im Wasser umgeht, statt jede Antwort als Straßenadresse zu behandeln.
Treffer nur auf Ebene der Postleitzahl. Außerhalb dichter Gebiete kann das nächste Ergebnis ein Postleitzahlgebiet von mehreren Quadratkilometern sein. Es sieht gültig aus, taugt aber nicht als Grundlage für eine Aktion. Prüfen Sie deshalb die Art des Orts, bevor Sie das Ergebnis als bestätigte Adresse anzeigen.
Sprache. Ein Punkt in Tokio kann je nach angefragter Sprache in Kanji, in Romaji oder auf Englisch zurückkommen. Zeigen Sie Nutzern lokalisierte Namen und führen Sie interne Logs in einer einheitlichen Sprache.
Punkte in großen Anlagen. Parks, Hochschulgelände und Einkaufszentren sind Polygone. Eine Markierung irgendwo darin sollte auf die Anlage aufgelöst werden, nicht nur auf die nächste Straße. Testen Sie deshalb auch mit Punkten abseits des Mittelpunkts.
Verrauschte GPS-Spuren. Legen Sie bei Fahrzeugdaten die Spur zuerst per Map Matching auf das Straßennetz und wenden Sie Reverse Geocoding erst dann auf die angepassten Punkte an. Sonst bekommt ein Auto auf der Autobahn die Adresse eines Hauses daneben.
Koordinaten in eine Adresse umwandeln
„Koordinaten in Adresse umwandeln“ ist der alltägliche Name für Reverse Geocoding. Je nachdem, wie viele Koordinaten Sie haben, gibt es drei Wege.
Eine Koordinate, von Hand. Fügen Sie Breiten- und Längengrad in das Koordinaten-Tool ein, und es zeigt die nächstgelegene Adresse auf der Karte. Sie können auch auf die Karte klicken oder die Markierung verschieben.
Viele Koordinaten, im Code. Rufen Sie einen Reverse-Geocoding-Endpoint mit dem Punkt auf und fordern Sie genau ein Ergebnis an:
curl "https://gateway.mapmetrics-atlas.net/reverse-geocode/?point.lat=52.3905&point.lon=4.829&size=1&token=YOUR_API_KEY"
Die Antwort ist eine GeoJSON FeatureCollection. Die Felder, die Sie zuerst lesen, gekürzt:
{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [4.82924, 52.39044] },
"properties": {
"layer": "address",
"label": "Rhôneweg 20, Amsterdam",
"accuracy": "point",
"country_code": "NL"
}
}
layer sagt Ihnen, worauf der Punkt aufgelöst wurde. address steht für eine Adresse mit Hausnummer. Ein Ergebnis vom Typ street oder locality bedeutet, dass keine Adresse nah genug lag.
Prüfen Sie die Eingabe, bevor Sie etwas aufrufen. Die meisten Koordinatenfehler entstehen vor der Abfrage:
- Reihenfolge. Karten-Apps und die meisten Formulare schreiben den Breitengrad zuerst (52.3905, 4.829). GeoJSON und viele APIs schreiben den Längengrad zuerst. Vertauschen Sie die Werte, landet ein Punkt in Amsterdam im Indischen Ozean vor Somalia.
- Format. 52°23'25.8"N 4°49'44.4"E ist derselbe Punkt in Grad, Minuten und Sekunden. Rechnen Sie ihn vor dem Senden in Dezimalgrad um (52.3905, 4.8290).
- Dezimalkomma. Im Deutschen ist „52,3905“ die normale Schreibweise. Viele APIs und URL-Parameter erwarten aber einen Dezimalpunkt und lesen „52,3905“ als zwei Zahlen. Ersetzen Sie vor dem Aufruf also das Komma durch einen Punkt.
Wie genau die Koordinate sein muss
Ein Reverse Geocoder gibt die Adresse zurück, die dem Punkt am nächsten liegt. Die Antwort ist also nur so gut wie die Koordinate. Wir haben gemessen, wie weit Adressen in drei dichten Innenstädten auseinanderliegen, mit allen OpenStreetMap-Adresspunkten in einem Quadrat von 1 km mal 1 km. Das Ergebnis haben wir mit der Strecke am Boden verglichen, die jede Nachkommastelle abdeckt:
| Nachkommastellen | Strecke am Boden (Breite) | Strecke am Boden (Länge bei 52° N) |
|---|---|---|
| 3 | 111 m | 68 m |
| 4 | 11 m | 6,8 m |
| 5 | 1,1 m | 0,68 m |
| 6 | 0,11 m | 0,07 m |
| Innenstadt (1 km²) | Adresspunkte | Hausnummern | Median-Abstand zur nächsten Hausnummer | Nächste Hausnummer innerhalb von 5 m |
|---|---|---|---|---|
| Berlin, Kreuzberg | 1.510 | 824 | 14,6 m | 2 % |
| Madrid, rund um die Puerta del Sol | 3.252 | 1.860 | 10,0 m | 8 % |
| Amsterdam, Grachtengürtel | 9.227 | 4.113 | 5,0 m | 51 % |
Daraus folgen drei Schlüsse:
- Vier Nachkommastellen reichen nicht für ein Haus. Wer auf vier Nachkommastellen rundet, verschiebt einen Punkt in Amsterdam um bis zu 6,5 m. Wer die Stellen einfach abschneidet, verschiebt ihn um bis zu 13 m. Das sind ein oder zwei Grachtenhäuser oder in Madrid der nächste Hauseingang. Nutzen Sie für alles auf Adressebene fünf oder sechs Nachkommastellen.
- Eine Smartphone-Position trifft die Straße, nicht immer die Tür. GPS-fähige Smartphones sind unter freiem Himmel typischerweise auf 4,9 m genau, laut GPS.gov, zwischen hohen Gebäuden ungenauer. In Kreuzberg landet das meist auf der richtigen Hausnummer, im Grachtengürtel unter Umständen beim Nachbarn. Zeigen Sie bei einer Lieferadresse das Ergebnis an und lassen Sie den Nutzer bestätigen oder die Markierung verschieben.
- Ein Punkt kann viele Adressen tragen. Die 9.227 Adresspunkte in Amsterdam teilen sich 4.113 Hausnummern, weil jede Wohnung eine eigene Adresse hat (Keizersgracht 123-1, 123-2 und so weiter), fast an derselben Stelle. Keine Koordinate kann zwischen ihnen unterscheiden. Fragen Sie deshalb nach der Wohnung.
Methode und Rohdaten finden Sie in scripts/seo/blog-keyword-research/what-is-a-geocode-address-spacing.mjs und docs/blog-keyword-research/what-is-a-geocode-address-spacing-2026-09-30.json. Die Strecken am Boden und die Rundungsfehler stammen aus what-is-geojson.mjs im selben Ordner. Adressdaten © OpenStreetMap-Mitwirkende (ODbL), abgefragt am 30. September 2026.
Stolpersteine im Betrieb
Geocoding gehört zu den Problemen, die am ersten Tag einfach aussehen und mit jeder Woche schwieriger werden.
Mehrdeutige Adressen. Der U.S. Geological Survey zählt in den USA 93 bewohnte Orte namens Springfield. Ohne Angaben zu Land, Region oder Postleitzahl ist Forward Geocoding ein Münzwurf. Übergeben Sie immer so viel Kontext wie möglich, auch den Ländercode als Parameter zur Gewichtung.
Veraltete Koordinaten. Straßen erhalten neue Hausnummern, Stadtteile neue Namen, neue Gebäude entstehen. Ein Geocode, den Sie vor zwei Jahren gespeichert haben, zeigt unter Umständen nicht mehr auf dasselbe Gebäude. Geocoden Sie Datensätze, bei denen Aktualität zählt (Zustellung, Disposition, regulierte Branchen), regelmäßig neu und vergleichen Sie das Ergebnis mit der gespeicherten Koordinate.
Geschönte Präzision. Eine naive Oberfläche zeigt „✓ Adresse gefunden“ an, auch wenn die Präzision nur locality ist. Der Nutzer sieht ein grünes Häkchen und hält die Adresse für bestätigt, dabei hat die API nur die Stadt gefunden. Zeigen Sie die Präzisionsstufe bei kritischen Abläufen wie Checkout oder KYC immer in der Oberfläche an.
Kontingente und Ratenlimits. Geocoding-APIs rechnen pro Anfrage ab und begrenzen die Zahl der Anfragen pro Sekunde. Massenverarbeitung braucht Stapel, die Adressvervollständigung für Nutzer braucht Debouncing im Client.
Datenschutz. Eine Koordinate mit Zeitstempel ist ein personenbezogenes Datum. Behandeln Sie Geocodes wie alle anderen personenbezogenen Daten: Sichern Sie die Speicherung ab, protokollieren Sie Zugriffe und halten Sie die DSGVO-Vorgaben für Ihre Region ein.
Geocoding in MapAtlas
Die MapAtlas Geocoding API übernimmt Forward und Reverse Geocoding. Sie gibt die oben genannten Standardfelder zurück (formatierte Adresse, Orts-ID, Präzision, Konfidenz, Bounding Box, Adressbestandteile) und unterstützt Batch-Geocoding für Import-Pipelines, die Millionen Zeilen verarbeiten. Parameter zur Gewichtung nach Land und Sprache halten die Ergebnisse für europäische und weltweite Zielgruppen relevant, ohne eine eigene Anfrage pro Sprache.
Wenn Sie Geocoding mit Fahrzeitanalysen kombinieren, arbeitet die Geocoding API mit der Isochrone API und der Distance Matrix API zusammen. So führt eine einzige Adressabfrage direkt zu „Zeig mir alles im Umkreis von 15 Minuten“ oder „Sortiere diese Kandidaten nach Fahrzeit“. Wenn Sie GPS-Spuren per Reverse Geocoding beschriften, schicken Sie sie vorher durch die Map Matching API, damit jeder Punkt auf der Straße liegt, auf der er tatsächlich aufgezeichnet wurde.
Ein Geocode ist nichts Spektakuläres, nur eine Koordinate. Aber diese Koordinate macht aus einer Zeichenkette einen Ort, mit dem eine Anwendung arbeiten kann. Ob Sie dieses eine Datum richtig erfassen, entscheidet darüber, ob Ihre Standortfunktion funktioniert oder eine Markierung auf dem falschen Kontinent setzt.
Häufig gestellte Fragen
Was ist ein Geocode?
Ein Geocode ist eine Koordinate, meist ein Paar aus Breiten- und Längengrad im Bezugssystem WGS84, die einen Ort auf der Erde auf einen einzelnen Punkt festlegt. Meist ist er das Ergebnis einer Geocoding-API: Sie erhält eine Zeichenkette wie „10 Downing Street, London“ und gibt Koordinaten wie 51.5034, -0.1276 zurück, dazu Metadaten darüber, wie sicher das Ergebnis ist und welche Art von Ort sie gefunden hat.
Worin unterscheiden sich Geocode und Geocoding?
Der Geocode ist das Ergebnis (eine Koordinate), Geocoding ist der Vorgang, der es erzeugt. Forward Geocoding wandelt eine Adresse in eine Koordinate um. Reverse Geocoding geht den umgekehrten Weg: Es nimmt eine Koordinate und gibt die nächstgelegene Adresse oder den nächsten Ort zurück. Meist bietet derselbe API-Endpoint beide Richtungen an.
Was liefert eine Geocoding-API tatsächlich zurück?
Eine gute Geocoding-API liefert mehr als Breiten- und Längengrad. Erwarten Sie eine normalisierte Adresse, die Trefferpräzision (rooftop, street, postcode, city), eine Orts-ID zum Speichern, Land und Verwaltungseinheiten, die Bounding Box des gefundenen Objekts und einen Konfidenzwert. Anhand von Präzision und Konfidenz entscheiden Sie im Betrieb, ob Sie dem Ergebnis trauen oder den Nutzer um Bestätigung bitten.
Was liefert eine Reverse-Geocoding-API zurück?
Eine Reverse-Geocoding-API nimmt Breiten- und Längengrad entgegen und gibt den nächstgelegenen sinnvollen Ort als strukturiertes Objekt zurück: eine formatierte Adresse für die Anzeige, eine stabile Orts-ID, die Adressbestandteile (Straße, Hausnummer, Stadt, Region, Postleitzahl, Land), einen ISO-Ländercode, die Art des gefundenen Objekts (Gebäude, Straße, Ort, Park, Gewässer) und die Entfernung vom Abfragepunkt zu diesem Objekt. Art und Entfernung zeigen Ihnen, ob Sie mit dem Ergebnis weiterarbeiten können.
Wie wandle ich Koordinaten in eine Adresse um?
Schicken Sie Breiten- und Längengrad an eine Reverse-Geocoding-API, oder fügen Sie die Werte in ein Koordinaten-Tool ein, das die Abfrage für Sie übernimmt. Prüfen Sie vorher die Eingabe: Die meisten Oberflächen erwarten den Breitengrad zuerst, Grad, Minuten und Sekunden müssen Sie in Dezimalgrad umrechnen, und erst fünf Nachkommastellen (etwa ein Meter) unterscheiden Nachbarhäuser. In den OpenStreetMap-Daten für den Amsterdamer Grachtengürtel liegt die nächste Hausnummer im Median 5 Meter entfernt. Eine auf vier Nachkommastellen gekürzte Koordinate kann dort 6 bis 13 Meter danebenliegen und benennt deshalb kein einzelnes Haus zuverlässig.
Warum werden Geocodes als Breiten- und Längengrad statt als Adresse zurückgegeben?
Koordinaten sind eindeutig, unabhängig von der Sprache und für Maschinen leicht zu verarbeiten. Adressen sind unordentlich: Schreibweisen weichen ab, Formate unterscheiden sich von Land zu Land, und ein Gebäude kann mehrere gültige Adressen haben. Eine Koordinate legt einen Punkt auf der Erde auf wenige Zentimeter genau fest und lässt sich problemlos zwischen Systemen, Datenbanken und APIs austauschen. Die meisten Plattformen behandeln die Koordinate als maßgebliche Quelle und erzeugen die Anzeigeadresse bei Bedarf neu per Reverse Geocoding.

