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.
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=DDiese 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 | 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 |
| pois | Findet auch POIs wie Bahnhöfe und Flughäfen | nein | true | true |
| 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 |
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 | 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 |
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 |