Was ist ein Geocode? Wie aus einer Adresse eine Koordinate wird

Ein Geocode ist eine Koordinate, die eine Adresse einem Punkt auf der Erde zuordnet. Er ist die Brücke zwischen menschlichen Ortsbezeichnungen ("10 Downing Street, London") und maschinenlesbarer Geometrie (51.5034, -0.1276). Hinter jedem Map-Pin, den Sie je angeklickt haben, hinter jedem "Hierhin liefern"-Button und hinter jeder "In der Nähe anzeigen"-Abfrage steckt irgendwo im Stack ein Geocode.

Dieser Leitfaden erklärt, was ein Geocode genau ist, was eine produktionsreife Geocoding API neben der Koordinate zurückliefert, wie du Trefferpräzision und Confidence liest und wo die typischen Stolpersteine lauern.

Was ein Geocode wirklich ist

Im strengen Sinn ist ein Geocode ein einzelner Punkt auf der Erdoberfläche, ausgedrückt als Latitude/Longitude-Paar auf einem bekannten Datum (fast immer WGS84, dasselbe Datum, das auch das GPS Ihres Smartphones nutzt). Latitude reicht von -90 (Südpol) bis +90 (Nordpol). Longitude reicht von -180 bis +180, mit 0 auf dem Greenwich-Meridian.

Außerhalb dieser engen Definition wird "Geocode" oft locker für "das Ergebnis einer Geocoding API" verwendet. Dieses Ergebnis enthält neben der Koordinate üblicherweise ein Bündel zusätzlicher Metadaten: die normalisierte Adresse, eine Place-ID, eine Präzisionsstufe, einen Confidence-Score und eine Bounding Box. Im produktiven Code ist es dieses reichere Objekt, das tatsächlich gespeichert und ausgewertet wird.

Eine Koordinate allein sagt Ihnen, wo. Die Metadaten sagen Ihnen, wie sicher Sie sich sein können, dass dieses Wo auch stimmt.

Forward vs. Reverse Geocoding

Es gibt zwei Richtungen, und derselbe API-Endpunkt deckt meist beide ab.

Forward Geocoding verwandelt Text in Koordinaten. Eingabe: "Eiffel Tower, Paris". Ausgabe: 48.8584, 2.2945, dazu der gefundene Place-Type (in diesem Fall ein Landmark), eine administrative Aufschlüsselung (Paris, Île-de-France, Frankreich) und eine Bounding Box des Features.

Reverse Geocoding verwandelt Koordinaten in Text. Eingabe: 48.8584, 2.2945. Ausgabe: eine strukturierte Adresse (Avenue Gustave Eiffel, 75007 Paris, Frankreich), der Place-Type und meist eine Liste nahegelegener Points of Interest.

Forward Geocoding treibt Checkout-Autocomplete, Store Locators und CSV-zu-Map-Pipelines an. Reverse Geocoding steht hinter "Abholung in der Nähe"-Buttons, Geotagging von Fotos und allen Features, in denen der Nutzer einen Pin auf der Karte setzt und die App einen Namen für diesen Pin braucht. Die nächsten Abschnitte behandeln die Forward-Antwort; Reverse Geocoding hat weiter unten einen eigenen Abschnitt.

Was eine Geocoding API zurückliefert

Eine Koordinate für sich genommen reicht nicht aus, um ein Feature auszuliefern. Eine ernstzunehmende Geocoding API liefert ein strukturiertes Objekt zurück, mit dem im Code Entscheidungen getroffen werden können. Die wichtigen Felder:

• latitude / longitude in WGS84
• formatted_address: der kanonische, normalisierte Adress-String für die Anzeige
• place_id: ein stabiler Identifier, der sich speichern und später erneut auflösen lässt
• precision (manchmal match_type oder accuracy): rooftop, street, neighbourhood, postcode, locality oder country. Dieses Feld ist mit Abstand das wichtigste, um fachliche Entscheidungen zu treffen
• confidence: ein numerischer Score (oft 0 bis 1), der angibt, wie sicher die API ist
• bbox: die Bounding Box des gefundenen Features, nützlich, um die Karte auf das Ergebnis zu zoomen
• address_components: die Adresse zerlegt in strukturierte Bestandteile (Straße, Hausnummer, Stadt, Region, Land, Postleitzahl)
• country_code im Format ISO 3166-1 alpha-2

Zwei reale Datensätze haben sehr unterschiedliche Präzisionen. Ein Rooftop-Match für eine Wohnadresse ist genau das, was Sie brauchen, bevor eine Lieferung disponiert wird. Ein Match auf Postleitzahlen-Ebene reicht für "zeige mir die nächste Filiale". Ein Locality-Match heißt, dass nur die Stadt bekannt ist, was selten genügt, um ohne Bestätigung zu handeln.

Wo Geocodes zum Einsatz kommen

Geocodes laufen unauffällig unter den meisten standortbezogenen Produktfeatures.

• Address Autocomplete: jeder Tastendruck in einem Checkout-Formular löst ein Forward Geocoding aus, das gerankte Kandidaten zurückliefert
• Store- und Venue-Locator: die aktuelle Position des Nutzers (ein Geocode) wird gegen eine Liste gespeicherter Standorte (ebenfalls Geocodes) abgeglichen, sortiert nach Haversine-Distanz
• Lieferung und Disposition: ein Forward Geocoding der Kundenadresse liefert der Fahrer-App eine präzise Koordinate für das Routing
• Listings und Inventar: Plattformen für Immobilien, Ferienunterkünfte und Hotels geocoden jedes Listing einmalig beim Ingest, speichern die Koordinate und nutzen sie für die "In dieser Region"-Suche
• Analytics und Dashboards: eingehende Datensätze (Bestellungen, Support-Tickets, IoT-Events) werden geocodet, um nach Region aggregiert oder auf einer Karte visualisiert zu werden
• AI Agents und Assistenten: wenn ein LLM aufgefordert wird, "ein Restaurant in meiner Nähe" zu finden, verwandelt ein Geocoding-Schritt die Position des Nutzers und die Kandidaten in Koordinaten, damit das Modell mit Distanzen argumentieren kann

In all diesen Fällen ist der Geocode der Join-Key. Er sorgt dafür, dass zwei Datensätze über denselben Ort auf derselben Karte zusammenfinden, selbst wenn ihre Adress-Strings sich nicht einig sind, ob "Street" oder "St." geschrieben wird.

Reverse Geocoding im Detail

Reverse Geocoding nimmt eine WGS84-Koordinate und liefert den nächstgelegenen sinnvollen Ort. Die eigentliche Arbeit steckt im Wort "sinnvoll". Ein Punkt mitten auf einem Parkplatz hat keine eigene Adresse. Ein GPS-Fix zehn Meter vor der Küste liegt gar nicht an Land. Der Reverse Geocoder muss entscheiden, welches Feature der Nutzer mit großer Wahrscheinlichkeit gemeint hat: das Gebäude vor ihm, die Straße, auf der er gefahren ist, oder den Park, den er gerade betreten hat.

Diese Entscheidung steckt in zwei Feldern, die vor allen anderen gelesen werden sollten:

• Place-Type (manchmal layer oder match_type): Gebäude oder Adresse, Straße, Stadtteil, Ortschaft, Park, Gewässer. Er sagt, worauf der Punkt aufgelöst wurde.
• Distanz: wie weit das gefundene Feature vom Abfragepunkt entfernt ist. Ein Adress-Match in drei Metern Entfernung ist solide. Ein Straßen-Match in siebzig Metern bedeutet meist, dass der Pin auf einem Feld gelandet ist.

Der Rest der Antwort entspricht dem Forward Geocoding: eine formatierte Adresse in der angefragten Sprache, eine Place-ID, Adressbestandteile und ein ISO-Ländercode.

Wo Reverse Geocoding zum Einsatz kommt

In allen Fällen erzeugt das Gerät oder der Nutzer zuerst einen Punkt, und die Adresse wird daraus abgeleitet:

• Checkout mit Pin: Der Nutzer schiebt einen Pin genau auf seine Haustür, und die App bestätigt ihm die Adresse
• Geotagging von Fotos: Aus einer EXIF-Koordinate wird "Paris, Frankreich" statt zweier Zahlen, auch beim nachträglichen Batch-Verarbeiten alter Bibliotheken
• "In der Nähe"-Buttons: Die Geräteposition wird auf eine Ortschaft aufgelöst, die eine Suche startet
• Flotten- und IoT-Telemetrie: Fahrtbeginn, Stopps und Sensor-Events kommen als Koordinaten an und werden einmal beim Ingest beschriftet, sodass Dashboards Straßennamen zeigen

Weil hier die Koordinate die Source of Truth ist, wird sie gespeichert, und die aufgelöste Adresse gilt als Anzeigewert, der sich aktualisieren lässt.

Stolpersteine beim Reverse Geocoding

Punkte an der Küste und im Wasser. GPS-Rauschen setzt Pins regelmäßig in einen Fluss oder ein paar Meter aufs Meer. Manche APIs liefern dann nichts, andere springen zur nächsten Straße, wieder andere liefern das Gewässer. Vorab festlegen, wie die UI mit einem Wasser-Match umgeht, statt jede Antwort als Straßenadresse zu behandeln.

Matches nur auf 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. Deshalb den Place-Type prüfen, bevor das Ergebnis als verifizierte Adresse erscheint.

Sprache. Ein Punkt in Tokio kann je nach angefragter Sprache in Kanji, Romaji oder Englisch zurückkommen. Nutzern lokalisierte Namen zeigen und interne Logs in einer einheitlichen Sprache führen.

Punkte innerhalb großer Anlagen. Parks, Campus-Gelände und Einkaufszentren sind Polygone. Ein Pin irgendwo darin sollte auf die Anlage aufgelöst werden, nicht nur auf die nächste Straße. Deshalb mit Punkten abseits des Mittelpunkts testen.

Verrauschte GPS-Tracks. Bei Fahrzeugdaten den Track zuerst per Map Matching auf das Straßennetz legen und dann die angepassten Punkte reverse geocoden. 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 vorliegen, gibt es drei Wege.

Eine Koordinate, von Hand. Latitude und Longitude in das Koordinaten-Tool einfügen, und es zeigt die nächstgelegene Adresse auf der Karte. Alternativ auf die Karte klicken oder den Pin verschieben.

Viele Koordinaten, im Code. Einen Reverse-Geocoding-Endpunkt mit dem Punkt aufrufen und genau ein Ergebnis anfordern:

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 zuerst zählen, 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, 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.

Die Eingabe prüfen, bevor etwas aufgerufen wird. Die meisten Koordinatenfehler entstehen vor der Abfrage:

• Reihenfolge. Karten-Apps und die meisten Formulare schreiben Latitude zuerst (52.3905, 4.829). GeoJSON und viele APIs schreiben Longitude zuerst. Werden die Werte vertauscht, 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. Vor dem Senden in Dezimalgrad umrechnen (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. Vor dem Aufruf also Komma durch Punkt ersetzen.

Wie genau die Koordinate sein muss

Ein Reverse Geocoder liefert die Adresse, 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, und das mit der Bodengröße jeder Nachkommastelle verglichen:

Daraus folgen drei Schlüsse:

• Vier Nachkommastellen reichen nicht für ein Haus. Runden auf vier Nachkommastellen verschiebt einen Punkt in Amsterdam um bis zu 6,5 m, einfaches Abschneiden der Stellen statt Runden um bis zu 13 m. Das sind ein oder zwei Grachtenhäuser oder der nächste Hauseingang in Madrid. Für alles auf Adressebene fünf oder sechs Nachkommastellen verwenden.
• Ein Smartphone-Fix 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, und zwischen hohen Gebäuden ungenauer. In Kreuzberg landet das meist auf der richtigen Hausnummer. Im Grachtengürtel kann es beim Nachbarn landen. Bei einer Lieferadresse das Ergebnis anzeigen und den Nutzer bestätigen oder den Pin verschieben lassen.
• Ein Punkt kann viele Adressen tragen. Amsterdams 9.227 Adresspunkte teilen sich 4.113 Hausnummern, weil jede Wohnung eine eigene Adresse hat (Keizersgracht 123-1, 123-2 und so weiter), fast an derselben Position. Keine Koordinate kann zwischen ihnen wählen, deshalb nach der Wohnung fragen.

Methode und Rohdaten stehen 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; Bodengrößen und Rundungsfehler stammen aus what-is-geojson.mjs im selben Ordner. Adressdaten © OpenStreetMap contributors (ODbL), abgefragt am 30. September 2026.

Stolpersteine im produktiven Einsatz

Geocoding gehört zu jenen Problemen, die am ersten Tag einfach aussehen und mit jeder Woche schwieriger werden.

Adress-Mehrdeutigkeit. Der U.S. Geological Survey zählt in den USA 93 bewohnte Orte namens Springfield. Ohne Land-, Regions- oder Postleitzahl-Kontext ist Forward Geocoding ein Münzwurf. Übergeben Sie immer so viel Kontext wie möglich, einschließlich des Country Codes als Bias-Parameter.

Veraltete Koordinaten. Straßen werden umnummeriert, Stadtteile umbenannt, neue Gebäude entstehen. Ein Geocode, den Sie vor zwei Jahren gespeichert haben, zeigt unter Umständen nicht mehr auf dasselbe Gebäude. Bei Datensätzen, in denen Aktualität zählt (Lieferung, Disposition, regulierte Branchen), sollte regelmäßig neu geocodet und gegen die gespeicherte Koordinate abgeglichen werden.

Precision Laundering. Eine naive UI zeigt das Geocoding-Ergebnis als "✓ Adresse gefunden" an, selbst wenn die Präzision locality ist. Der Nutzer sieht ein grünes Häkchen und glaubt, die Adresse sei verifiziert, dabei hat die API nur die Stadt gematcht. In sicherheitskritischen Flows wie Checkout oder KYC sollte die Präzisionsstufe stets in der UI sichtbar sein.

Quotas und Rate Limits. Geocoding APIs werden pro Request abgerechnet und sind pro Sekunde rate-limited. Bulk-Operationen brauchen Batching, nutzerseitiges Autocomplete braucht clientseitiges Debouncing.

Datenschutz. Eine Koordinate plus Zeitstempel ist personenbezogenes Datum. Behandeln Sie Geocodes wie jede andere PII: Speicherung absichern, Zugriffe loggen und die GDPR-Vorgaben für die jeweilige Region einhalten.

Geocoding in MapAtlas

Die MapAtlas Geocoding API deckt Forward und Reverse Geocoding über einen einzigen Endpunkt ab. Sie liefert die oben genannten Standardfelder zurück (formatted address, Place-ID, Präzision, Confidence, Bounding Box, Address Components) und unterstützt Batch-Geocoding für Ingest-Pipelines, die Millionen von Zeilen verarbeiten müssen. Bias-Parameter für Land und Sprache halten die Ergebnisse für europäische und globale Zielgruppen relevant, ohne dass pro Locale ein separater Request nötig wäre.

Für Workloads, die Geocoding mit Reisezeitanalyse kombinieren, lässt sich die Geocoding API mit der Isochrone API und der Distance Matrix API verbinden, sodass ein einzelnes Adress-Lookup direkt in "zeige mir alles innerhalb von 15 Minuten" oder "sortiere diese Kandidaten nach Fahrzeit" überführt werden kann.

Ein Geocode ist nichts Glamouröses. Er ist nur eine Koordinate. Aber es ist die Koordinate, die einen String in einen Ort verwandelt, mit dem eine Anwendung tatsächlich arbeiten kann, und genau dieses eine Datum richtig hinzubekommen, trennt ein echtes standortbezogenes Feature von einem Pin auf dem falschen Kontinent.