Deutschland (DEU)
Dieser Abschnitt definiert die unterstützten Geocoding-Datasets, Vorgänge sowie Eingabe- und Ausgabefeldinformationen für Deutschland.
Unterstützte Geocoding-Datasets
Die folgende Tabelle führt die unterstützten Geocoding-Datasets mit den verfügbaren Geocoding-Ebenen für Deutschland auf.
| Geocoding-Dataset | Ortsmittelpunkt | Vorort-/Dorfmittelpunkt | PLZ-Mittelpunkt | Straßenmittelpunkt | Interpolierte Straßenanschrift | Adresse auf Punktebene | Point of Interest |
|---|---|---|---|---|---|---|---|
| TomTom Deutsch | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
Unterstützte Vorgänge
- Geocoding: Dabei werden eine oder mehrere Adressen als Eingabe genutzt und es werden Breitengrad/Längengrad-Koordinaten sowie weitere Informationen zurückgegeben.
- Reverse Geocoding: Dabei werden eine oder mehrere Breitengrad/Längengrad-Koordinaten als Eingabe genutzt und es wird die Adresse des Standorts zurückgegeben.
- Interactive Geocoding: Gibt potenzielle Kandidaten mit Übereinstimmung zurück, wenn die Adresse eingegeben wird.
- Globale Schlüsselsuche: Gibt Geocode-Kandidaten zurück, wenn ein eindeutiger Schlüssel als Eingabe angegeben wird. Nur „USA MLD“- und „AUS GNAF“-Daten.
Eingabefelder
Die Eingabeadresse kann einige oder alle der folgenden Adresselemente enthalten. Weitere Informationen über Adressen in Deutschland finden Sie auf der Website der deutschen Post: www.deutschepost.de.
| Parameter | Typ | Beschreibung |
|---|---|---|
| placeName | Zeichenfolge | Gibt den Gebäudenamen, den Ortsnamen, den Point of Interest (POI), den Unternehmens- oder Firmennamen an, der mit der Eingabeadresse verknüpft ist. Optional: |
| mainAddress | Zeichenfolge | Einzeilige Eingabe: Wenn kein weiteres Adressfeld ausgefüllt wird, wird der Eintrag mainAddress als einzeilige Eingabe verarbeitet. Eine einzeilige Eingabe kann aus mehreren Eingabeadressfeldern bestehen. Diese müssen in der typischen Adressreihenfolge des Landes eingegeben werden. Weitere Informationen finden Sie im unteren Abschnitt „Einzeilige Eingabe“. Straßenanschrift: Wenn die Komponenten der Postanschrift (City, PostalCode usw.) separat oder im Feld „lastLine“ angegeben werden, wird der Inhalt von mainAddress als Teil der Straßenanschrift verarbeitet und kann den Namen eines Unternehmens, die Hausnummer, Gebäudenamen und Straßennamen enthalten. Optional: Straßenkreuzungseingabe: Um eine Kreuzung einzugeben, geben Sie die beiden Straßennamen ein, und trennen Sie sie anhand eines doppelten kaufmännischen Und-Zeichens (&&). |
| lastLine | Zeichenfolge | Die letzte Zeile der Adresse. Optional: Beispiel: Mulder 2 |
| areaName1 | Zeichenfolge | Gibt das Bundesland an. Optional: |
| areaName2 | Zeichenfolge | Gibt den Kreis an. Optional: |
| areaName3 | Zeichenfolge | Gibt den Ort oder die Stadt an. Optional: |
| areaName4 | Zeichenfolge | Nicht verwendet. |
| postalCode | Zeichenfolge | Gibt die fünfstellige Postleitzahl an. Die erste Ziffer gibt das Gebiet an, in dem die Adresse zu finden ist. Die zweite Ziffer gibt eine kleinere Region in diesem Gebiet an. Die dritte Ziffer gibt einen Ort, einen Ortsteil oder eine Gemeinde an. Die letzten beiden Ziffern geben den Zustelltyp oder die Gruppe der Zustellorte an. Optional: |
| country | Zeichenfolge | Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für Deutschland lautet DEU. Für Forward Geocoding erforderlich. |
Einzeilige Eingabe
Anstatt jede Adresskomponente in separate Felder einzugeben, können Sie die gesamte Adresse in das Eingabefeld mainAddress eingeben, wobei die Reihenfolge der Adresselemente folgendermaßen aussieht:
[street_info][address_number][postal_code][area]
- [street_info] besteht aus dem Straßennamen, dem Straßentyp und allen Informationen zu voran- und nachgestellten Richtungsangaben (z. B. Osten, Westen usw.). Optional:
- [address_number] ist optional.
- [postal_code] ist die Postleitzahl.
- [area] ist nur der Ort oder der Ort mit ergänzenden Informationen, wie z. B. Bundesland, Kanton, Lokalität.
- Es ist entweder [area] oder [postal_code] erforderlich.
Geben Sie ein Komma zwischen den Straßeninformationen und den Daten der letzten Adresszeile ein, um optimale Ergebnisse zu erzielen.
Benutzerdefinierte Optionen
Die folgende Tabelle führt die für Deutschland spezifischen Optionen auf. Diese benutzerdefinierten Felder sind optionale Eingabeparameter. Wenn nicht anders angegeben, sind sie sowohl für Forward Geocoding als auch Reverse Geocoding verfügbar. Informationen zu den für alle Länder verfügbaren Standardoptionen und ihren Definitionen finden Sie in den Kapiteln über den Geocode-Dienst und den Reverse-Geocode-Dienst.
| Optionsname | Beschreibung |
|---|---|
| USE_ADDRESS_POINT_INTERPOLATION | Bei einer Einstellung auf true wird die Adresspunktinterpolation aktiviert. Standardeinstellung = false. Nur beim Forward Geocoding unterstützt. Anmerkung: Bei der Adresspunktinterpolation muss ein Geocoding-Dataset auf Punktebene installiert sein.
|
Ausgabefelder für
Die folgende Tabelle führt die Adressfelder auf, die für einen in Deutschland befindlichen Kandidaten zurückgegeben werden.
| Feldname | Beschreibung |
|---|---|
| mainAddressLine | Die Straßenanschrift, die den Unternehmensnamen, die Hausnummer, Gebäudenamen und Straßennamen enthält. |
| addressLastLine | Die letzte Zeile der Adresse. |
| placeName | Der Gebäudename, Ortsname, Point of Interest (POI), Unternehmens- oder Firmenname, der mit der Adresse verknüpft ist. |
| areaName1 | Das Bundesland. |
| areaName2 | Der Kreis. |
| areaName3 | Der Ort oder die Stadt. |
| areaName4 | Nicht verwendet. |
| postCode1 | Die fünfstellige Postleitzahl. |
| postCode2 | Nicht verwendet. |
| country | Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für Deutschland lautet DEU. |
| addressNumber | Die Adressnummer. |
| streetName | Der Straßen- oder Wegname. |
| unitType | Der Einheitstyp wie APT, STE usw. |
| unitValue | Der Wert/die Nummer der Einheit, z. B. „3B“. |
| customFields | Es gibt keine benutzerdefinierten Ausgabefelder für Deutschland. |