Neuseeland (NZL)

Dieser Abschnitt definiert die unterstützten Geocoding-Datasets, Vorgänge sowie Eingabe- und Ausgabefeldinformationen für Neuseeland.

Unterstützte Geocoding-Datasets

Die folgende Tabelle führt die unterstützten Geocoding-Datasets mit den verfügbaren Geocoding-Ebenen für Neuseeland auf.

Anmerkung: Benutzerwörterbücher werden unterstützt.
Geocoding-Dataset Ortsmittelpunkt Vorort-/Dorfmittelpunkt PLZ-Mittelpunkt Straßenmittelpunkt Interpolierte Straßenanschrift Adresse auf Punktebene Point of Interest
Critchlow Englisch Ja Ja Ja Ja Ja Ja Ja

Unterstützte Vorgänge

Die folgenden Vorgänge werden für Neuseeland unterstützt:
  • 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.

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:
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:

56 Namata Road
One Tree Hill
Auckland 2001
areaName1 Zeichenfolge Gibt die Region an. Eine Region ist die Verwaltungseinheit eines Landes. Optional:
areaName2 Zeichenfolge Nicht verwendet.
areaName3 Zeichenfolge Gibt den Ort oder die Stadt an. Optional:
areaName4 Zeichenfolge Gibt den Vorort an. Optional:
postalCode Zeichenfolge Die vierstellige Postleitzahl. Die erste Ziffer steht für die geografische Region. Die zweite und dritte Ziffer stehen für den Postsortierbereich. Die letzte Ziffer kennzeichnet ein bestimmtes Stadtgebiet, einen ländlichen Zustellungsort oder eine Postfachnummer. Optional:
country Zeichenfolge Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für Neuseeland lautet NZL. Für Forward Geocoding erforderlich.

Adressenrichtlinien für Neuseeland

Folgen Sie diesen Vorschlägen, damit Ihre Eingabeadressdaten das bestmögliche Format für optimale Vergleichs- und Geocoding-Vorgänge aufweisen. Weitere Informationen über Adressen in Neuseeland finden Sie auf der New Zealand Post-Website: www.nzpost.co.nz.

  • Pflichtfelder: Adressen müssen entweder einen Ort oder eine Postleitzahl enthalten.
  • Aliase für Vororte: Der Geocoder unterstützt neben den offiziell anerkannten Vorortsnamen auch lokal verwendete Vorortsnamen. Rosedale ist beispielsweise ein Alias des offiziellen Vorortsnamens Hargest.
  • Durchfahrtstypen: Durchfahrtstypen und ihre allgemeinen Abkürzungen werden erkannt und vollständig in Eingabeadressen unterstützt.
  • Gängige Wörter und Abkürzungen: Der Geocoder erkennt gängige Wörter, Richtungsangaben, Hausnummernindikatoren und Abkürzungen, die in Adressen verwendet werden, und geocodiert diese Adressen erfolgreich.
  • Nummern, numerische Entsprechungen und Ordnungszahlen: Nummerierte Straßen werden den benannten Entsprechungen zugeordnet. Ordnungszahlen werden ebenfalls in Eingabeadressen erkannt.

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:

[unit_info][address_number][street_info][areaName4][areaName3][postal_code]

Dabei gilt:
  • [unit_info] ist der Wohneinheitstyp und/oder Wert. Optional:
  • [address_number] ist optional.
  • [street_info] besteht aus dem Straßennamen, dem Straßentyp und allen Informationen zu voran- und nachgestellten Richtungsangaben (z. B. Osten, Westen usw.).
  • [areaName4] ist der Vorort.
  • [areaName3] ist der Ort.
  • [postal_code] ist die vierstellige Postleitzahl.
  • Es ist entweder [areaName3] 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 Neuseeland spezifische Option auf. Dieses benutzerdefinierte Feld gilt für den Geocoding-Vorgang und ist ein optionaler Eingabeparameter. 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
ReturnOriginalCoordinates Wird „true“ festgelegt, werden die Werte für ORIGINAL_LONGITUDE und ORIGINAL_LATITUDE in den benutzerdefinierten Ausgabefeldern des Kandidaten angezeigt.

Ausgabefelder für

Die folgende Tabelle führt die Adressfelder auf, die für einen in Neuseeland befindlichen Kandidaten zurückgegeben werden.

Anmerkung: Die Feldwerte placeName, addressNumber, unitType und unitValue werden nur zurückgegeben, wenn ein Geocoding-Dataset installiert ist, das die Interpolation von Straßenanschriften unterstützt.
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 Region.
areaName2 Nicht verwendet.
areaName3 Der Ort oder die Stadt.
areaName4 Der Vorort.
postCode1 Die vierstellige Postleitzahl.
postCode2 Nicht verwendet.
country Der aus drei Buchstaben bestehende ISO 3166-1 Alpha-3-Ländercode. Der Ländercode für Neuseeland lautet NZL.
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 Die folgende Tabelle führt die benutzerdefinierten Felder für Neuseeland auf.

Benutzerdefinierte Ausgabefelder

Die folgende Tabelle führt die für Neuseeland spezifischen Ausgabefelder auf. Sofern nicht anders angegeben, können diese Felder sowohl beim Forward Geocoding als auch beim Reverse Geocoding zurückgegeben werden.

Bezeichnung Beschreibung
ALIASED_SUBURB Neuseeland Vorort-Alias. Eine Alternative zum offiziell anerkannten Namen des Vororts.
KEY_UFI Neuseeland UFI. Die eindeutige Kennung (UFI) identifiziert das Straßensegment, zu dem die geocodierte Adresse gehört. UFIs sind aus bis zu sieben Stellen bestehende Zahlen, die von der New Zealand Post vergeben werden und jeden Postzustellort eindeutig identifizieren. Die UFI wird immer zurückgegeben, sofern verfügbar. Sie können die UFI jedoch nicht für die Eingabe verwenden.
NZL_MESHBLOCK_ID Neuseeland Meshblock-Bezeichner. Ein Meshblock ist die kleinste geografische Einheit, für die Statistics New Zealand statistische Daten sammelt. Die Größe von Meshblocks variiert von einem Teil eines Häuserblocks bis hin zu großen ländlichen Gebieten.
ORIGINAL_LATITUDE Der ursprüngliche Breitengrad-Wert.
ORIGINAL_LONGITUDE Der ursprüngliche Längengrad-Wert.