Geocoder Simple

Geocoding

Beim Geocoding wird einer Adresse eine Koordinate zugeordnet. Die Eingabe kann dabei sowohl strukturiert (Straße, Hausnummer, Postleitzahl und Ort werden in separaten Feldern angegeben) als auch unstrukturiert erfolgen.

Mit strukturierter Eingabe

Wenn die einzelnen Bestandteile der Adresse bekannt sind können sie über die Parameter str, hnr, ort und plz übergeben werden:

simple?MULTI=1&enc=UTF-8&vnr=0&pnr=0&str=Riemenschneiderstr.&hnr=11&ort=Bonn&lnd=D

Mit einzeiliger Eingabe

Diese Variante kann genutzt werden wenn die Struktur der Adressinformation nicht bekannt ist:

simple?MULTI=1&enc=UTF-8&vnr=0&pnr=0&add=Riemenschneiderstr.+11+Bonn&lnd=D

Parameter

Parameter Beschreibung erforderlich? Standardwert Beispiel
add Adresse entweder add, ort oder plz Riemenschneiderstr. 11, 53175 Bonn
str Straße nein Riemenschneiderstr.
hnr Hausnummer nein 11
plz Postleitzahl entweder add, ort oder plz 53175
ort Ortsname entweder add, ort oder plz Bonn
lnd Land (s. Liste) nein D D
additional Zusatzinformationen nein Kreis,Gemeinde
multi 0 für Einzel- und 1 für Multitreffer nein 0
limit maximale Trefferzahl nein 100
enc Encoding, z.B. UTF-8 oder ISO-8859-1 nein ISO-8859-1
outputformat Ausgabeformat: XML oder JSON nein XML
vnr Zugangcode der aufrufenden Anwendung ja
pnr Zugangcode der aufrufenden Anwendung ja

Reverse-Geocoding

Beim Reverse Geocoding wird für eine gegebene Koordinate die nächstgelegene Adresse (oder eine Liste von Adressen) bestimmt. Die maximale Anzahl kann entweder absolut angegeben werden (z.B. modus=0&option=10 für 10 Treffer) oder durch die Entfernung in Metern begrenzt werden (z.B. modus=1&option=200 für alle Koordinaten in 200 Meter Radius).

Parameter

Parameter Beschreibung erforderlich? Standardwert Beispiel
x x-Koordinate ja 7.1415119
y y-Koordinate ja 50.7013606
prj Koordinaten-Projektion ja wgs84
lnd Land (s. Liste) nein EU D
additional Zusatzinformationen nein Kreis,Gemeinde
modus 0: Anzahl der Adressen, 1: Entfernung nein 0
option Modus 0: Anzahl der Treffer, Modus 1: Max. Entfernung in Metern nein 1
enc Encoding, z.B. UTF-8 oder ISO-8859-1 nein ISO-8859-1
outputformat Ausgabeformat: XML oder JSON nein XML
vnr Zugangcode der aufrufenden Anwendung ja
pnr Zugangcode der aufrufenden Anwendung ja

Über den Parameter prj können folgende Projektionen verwendet werden:

Parameter Projektion SRID Beispiel (x, y)
wgs84 WGS 84 Dezimalgrad EPSG:4326 7.14151, 50.70155
web_mercator Web Mercator EPSG:3857 794913, 6568670
lcc_europe LCC Europe 280978, 189633

Antwort-Format

Die Adressen werden beim Geocoding und beim Reverse Geocoding im gleichen Format zurückgegeben. Die Felder haben im Einzelnen folgende Bedeutung:

Feld Beschreibung Beispiel
error Beschreibung des aufgetretenen Fehlers. Bleibt leer, wenn die Aktion ordnungsgemäß ausgeführt wurde. missing city or zipcode
hits Anzahl der Treffer 1
addresses Enthält die gefundene(n) Adresse(n)
address Enthält eine gefundene Adresse
district Bezirk der gefundenen Adresse (einige Teilorte werden zu einem Bezirk zusammengefasst), wenn vorhanden
zipcode Postleitzahl der gefundenen Adresse 53175
city Ort / Stadt der gefundenen Adresse Bonn
part Orts- / Stadtteil der gefundenen Adresse Hochkreuz
street Straßenname der gefundenen Adresse Riemenschneiderstr
housenumber Hausnummer der gefundenen Adresse 11
gkz Gemeindekennzeichen (für Deutschland der Kreis-Gemeinde-Schlüssel) 05314000
x wgs84 position Länge in Dezimalgrad nach WGS84 der Position der gefundenen Adresse 7.14088790
y wgs84 position Breite in Dezimalgrad nach WGS84 der Position der gefundenen Adresse 50.70150837
x-lcc_europe position x Wert der Position der gefundenen Adresse (Projection LCC_EUROPE*) 280982
y lcc_europe position y-Wert der Position der gefundenen Adresse (Projection LCC_EUROPE*) 189630
x mercator position x-Wert der Position der gefundenen Adresse (Mercator-Projektion) 794936
y mercator position y-Wert der Position der gefundenen Adresse (Mercator-Projektion) 6568658
x lcc_tao position x-Wert der Position der gefundenen Adresse (Projection LCC_TAO) 236313
y lcc_tao position y-Wert der Position der gefundenen Adresse (Projection LCC_TAO) 27625
land Name des Landes Deutschland
landcode (nur bei Reverse) Länderkürzel D
iso3361 Länderkürzel nach ISO 3166-1 alpha-3 DEU
quality Qualität der gefundenen Adresse, s. Qualitätsmerkmale AAAA
matchcode Genauigkeit der gefundenen Adresse, s. Qualitätsmerkmale 1
probability Qualität der gefundenen Adresse (in Prozent), s. Qualitätsmerkmale 100