World Geocoder (XWG)
In diesem Abschnitt werden die unterstützten Geocoding-Datasets, Vorgänge sowie Eingabe- und Ausgabefeldinformationen für den World Geocoder definiert.
Unterstützte Datasets
In der folgenden Tabelle werden die unterstützten Geocoding-Datasets mit den verfügbaren Geocoding-Stufen für den World Geocoder aufgeführt.
Dataset | Ortsmittelpunkt | Vorort-/Dorfmittelpunkt | PLZ-Mittelpunkt | Straßenmittelpunkt | Interpolierte Straßenanschrift | Adresse auf Punktebene | Point of Interest |
---|---|---|---|---|---|---|---|
World-Daten von TomTom, GeoNames, Pitney Bowes | Ja | Ja | Ja | Nein | Nein | Nein | Nein |
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.
Postalisches Geocoding
- Ihre Eingabeadresse besteht aus einer gültigen Postleitzahl.
- Die Datenquelle enthält Postleitzahldaten für das Land. Nicht jedes Land verfügt über Postleitzahldaten.
Geografisches Geocoding
- Ihre Eingabeadressen enthalten genaue geografische Informationen ohne gültigen Inhalt in Bezug auf die Postleitzahl der Adresse in der Eingabe. Wenn die betreffende Adresse eine gültige Postleitzahleneingabe enthält, versucht der World Geocoder, ein postalisches Geocoding durchzuführen.
- Die Datenquelle enthält Informationen auf geografischer Ebene für das Land. Geografische Informationen können aus einer beliebigen Datenquelle stammen (TomTom, GeoNames oder Pitney Bowes).
Länderabdeckung
Der World Geocoder deckt fast alle Länder der Welt ab. Die Genauigkeit und der Umfang der Abdeckung variiert je nach Qualität der verfügbaren Datenquelle. Bei einigen Ländern werden auch Postleitzahlendaten eingeschlossen, während bei anderen Ländern nur eine geografische Abdeckung gegeben ist. In der folgenden Tabelle finden Sie eine vollständige Liste der geografischen Abdeckung nach Land. Eine vollständige Liste der geografischen Abdeckung nach Land finden Sie unter Abdeckung geografischer Länderdaten. Informationen zur postalischen Abdeckung nach Land finden Sie unter Abdeckung postalischer Daten von Ländern
Eingabefelder
Die Eingabeadresse kann einige oder alle der folgenden Adresselemente enthalten.
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: Anmerkung: In diesem Feld bereitgestellte Informationen werden vom World Geocoder ignoriert.
|
mainAddress | Zeichenfolge | Einzeilige Eingabe: Wenn kein weiteres Adressfeld ausgefüllt wird, wird der mainAddress-Eintrag als einzeilige Eingabe behandelt. 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 Postanschriftskomponenten (City, PostalCode usw.) separat oder im Feld „lastLine“ bereitgestellt werden, wird der Inhalt von mainAddress als Teil der Straßenanschrift behandelt 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 (&&). Anmerkung: In diesem Feld bereitgestellte Informationen werden vom World Geocoder ignoriert.
|
lastLine | Zeichenfolge | Die letzte Zeile der Adresse. Optional: Beispiel: 2 Manchester Rd |
areaName1 | Zeichenfolge |
Der Name einer der folgenden Optionen in Abhängigkeit vom Land:
|
areaName2 | Zeichenfolge |
Der Name einer der folgenden Optionen in Abhängigkeit vom Land:
|
areaName3 | Zeichenfolge | Gibt den Orts- oder Stadtnamen an. Ihre Eingabeadresse muss den offiziellen Ortsnamen enthalten. Dadurch werden die besten Geocoding-Ergebnisse erzielt. Für Thailand enthält dieses Feld den Unterbezirk (tambon). |
areaName4 | Zeichenfolge |
Der Name einer der folgenden Optionen in Abhängigkeit vom Land:
|
postalCode | Zeichenfolge | Die Postleitzahl im entsprechenden Format des Landes. |
country | Zeichenfolge | Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für den World Geocoder lautet XWG. Für Forward Geocoding erforderlich. |
Adressenrichtlinien für den World Geocoder
Folgen Sie diesen Vorschlägen, damit Ihre Straßeneingabedaten das bestmögliche Format für optimale Vergleichs- und Geocoding-Vorgänge aufweisen.
- Adressaliasse: Einige Länder verfügen über alternative administrative Namen. Beispielsweise kann es für eine Stadt oder einen Ort einen offiziellen Namen geben, es kann allerdings für dieselbe Stadt bzw. denselben Ort auch einen gängigen, aber inoffiziellen alternativen Namen geben. Wenn in den Quelldaten Aliasinformationen verfügbar sind, schließt World diesen Alias in die Datenbank ein. Dadurch kann World das Geocoding erfolgreich durchführen, wenn in Eingabeadressen alternative Namen verwendet werden.
- Sprachaliasse: Einige Länder verfügen über mehrere offizielle Sprachen oder Hauptsprachen. Eine Stadt kann beispielsweise unter ihrem deutschen und italienischen Namen allgemein bekannt sein. Wenn in den Quelldaten Sprachaliasinformationen verfügbar sind, verwendet World diese in der Datenbank. Dadurch kann World das Geocoding erfolgreich durchführen, wenn in Eingabeadressen alternative Sprachbezeichnungen verwendet werden.
- Abkürzungen von Bundesländern oder Kantonen: In einigen Ländern ist das Bundesland bzw. das Kanton ein wichtiger Bestandteil der Adresse und dieses Adresselement wird häufig abgekürzt. Bei ausgewählten Ländern werden diese Abkürzungen von Bundesländern/Kantonen von World erkannt. In den Vereinigten Staaten beispielsweise besitzt jeder Bundesstaat eine aus zwei Buchstaben bestehende Abkürzung (z. B. CA für California). Ebenso werden Abkürzungen für die Bundesländer/Provinzen in den Niederlanden erkannt (z. B. GLD für Gelderland).
Der World Geocoder akzeptiert Abkürzungen von Bundesländern/Kantonen für die folgenden Länder:
- Australien (AUS)
- Kanada (CAN)
- Italien (ITA)
- Mexiko (MEX)
- Niederlande (NLD)
- Vereinigte Staaten (USA)
Einzeilige Eingabe
Anstatt jede Adresskomponente in einem eigenen Feld einzugeben, können Sie die gesamte Adresse in das Eingabefeld mainAddress eingeben, wobei die Adresselemente die für das Land typische Reihenfolge aufweisen. Einige Beispiele für eine gängige Sortierung von Adresselementen sehen wie folgt aus:
[address_number][street_info][postal_code][area]
[address_number][street_info][area][postal_code]
[street_info][address_number][area][postal_code]
[street_info][address_number][postal_code][area]
[street_info][address_number][area]
[address_number][street_info][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.
- [area] ist nur der Ort oder der Ort mit ergänzenden Informationen, wie z. B. Bundesland, Kanton, Lokalität.
- [postal_code] ist die Postleitzahl.
- Es ist entweder [area] oder [postal_code] erforderlich.
Benutzerdefinierte Optionen
Für den XWG-Geocoder gibt es keine benutzerdefinierten Optionen.
Ausgabefelder für
In der folgenden Tabelle werden die Adressfelder aufgeführt, die für einen vom World Geocoder lokalisierten 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 |
Die Bedeutung variiert je nach Land:
|
areaName2 |
Dieses Feld enthält eine Region, die kleiner als ein Bundesstaat/-land bzw. eine Provinz ist, aber größer als eine Stadt. Die Region variiert je nach Land.
|
areaName3 | Der Ort oder die Stadt. |
areaName4 | Die Bedeutung variiert je nach Land:
|
postCode1 | Die Postleitzahl zu der Adresse. Das Format der Postleitzahl variiert je nach Land. |
postCode2 | Die Erweiterung der Postleitzahl, sofern dies für das Land zutrifft. |
country | Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für den World Geocoder lautet XWG. |
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 | Im folgenden Abschnitt werden die benutzerdefinierten World Geocoder-Ausgabefelder aufgeführt. |
Benutzerdefinierte Ausgabefelder
In der folgenden Tabelle werden die Ausgabefelder aufgeführt, die ausschließlich für den XWG-Geocoder gelten.
Name | Beschreibung |
---|---|
CITYRANK | Diese Option gibt den Ortsrang zwischen 1 (am höchsten) und 10 (am niedrigsten) zurück. Null (0) bedeutet, dass kein Rang verfügbar war. |