POST-Anforderung an Geocode

Pitney Bowes
4750 Walnut St.
Boulder, CO 80301

4750 Walnut St., Boulder CO, 80301

Straßenanschrift: Wenn die Adressfelder (placeName, lastLine, postalCode usw.) separat eingegeben werden, wird der Inhalt dieses Feldes als der Teil für die Straßenanschrift verwendet und kann den Unternehmensnamen, die Hausnummer, Gebäudenamen und Straßennamen beinhalten. 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 (&&).

True

Alle verfügbaren Informationen für jeden Kandidaten zurückgeben.

False

Alle verfügbaren Informationen für jeden Kandidaten nicht zurückgeben. Standardeinstellung.

True

Geografischen Mittelpunkt zurückgeben, wenn kein Mittelpunkt auf Adressebene bestimmt werden kann. Standardeinstellung.

False

Geografischen Mittelpunkt nicht zurückgeben, wenn kein Mittelpunkt auf Adressebene bestimmt werden kann.

True

Postleitzahlmittelpunkt zurückgeben, wenn kein Mittelpunkt auf Adressebene bestimmt werden kann. Standardeinstellung.

False

Postleitzahlmittelpunkt nicht zurückgeben, wenn kein Mittelpunkt auf Adressebene bestimmt werden kann.

True

Den World Geocoder (XWG) für den Vergleich verwenden, wenn kein Land-Geocoder installiert ist oder ein Land-Geocoder ohne ein Geocoding-Dataset installiert ist.

False

Den World Geocoder (XWG) nicht für den Vergleich verwenden, wenn kein Land-Geocoder installiert ist oder ein Land-Geocoder ohne ein Geocoding-Dataset installiert ist. Standardeinstellung.

Der Versatzabstand dient beim Geocoding auf Straßenebene zur Vermeidung der Positionierung des Geocodes in der Mitte der Straße. Er gleicht den Umstand aus, dass beim Geocoding auf Straßenebene ein Punkt für den Breitengrad und den Längengrad in der Mitte der Straße, an der sich die Adresse befindet, zurückgegeben wird. Da sich das Gebäude, das durch eine Adresse bezeichnet wird, nicht auf der Straße selbst befindet, sollte der Geocode für eine Adresse kein Punkt auf der Straße sein. Stattdessen soll der Geocode den Standort des Gebäudes darstellen, das sich neben der Straße befindet. Ein Versatz von 50 Fuß bedeutet beispielsweise, dass der Geocode einen Punkt darstellt, der 50 Fuß von der Mitte der Straße entfernt ist. Die Entfernung wird senkrecht zum Teil des Straßensegments der Adresse berechnet. Mithilfe des Versatzes wird auch verhindert, dass einander gegenüberliegende Adressen denselben Punkt erhalten. Im folgenden Diagramm wird ein Versatzpunkt im Vergleich zum ursprünglichen Punkt dargestellt.

• Feet
• Meters - Default

Im folgenden Diagramm werden die Endpunkte einer Straße mit Versatzendpunkten verglichen.

• Feet
• Meters - Default

Exact

Für diesen Modus ist eine sehr genaue Übereinstimmung erforderlich. Dieser stark eingeschränkte Modus generiert die geringste Anzahl an Kandidaten, wodurch die Verarbeitungszeit und die Anzahl der Übereinstimmungen reduziert werden. Wenn Sie diesen Modus verwenden, müssen Sie sicherstellen, dass Ihre Eingabe qualitativ hochwertig sowie frei von Tippfehlern und unvollständigen Angaben ist.

Standard

Für diesen Modus ist eine weitgehende Übereinstimmung erforderlich, und es wird eine kleinere Anzahl von Kandidaten generiert. Standardeinstellung.

Relaxed

In diesem Modus ist eine geringere Übereinstimmung zugelassen, und es wird die größte Anzahl an Kandidaten generiert. Dies führt zu längeren Verarbeitungszeiten und mehr Mehrfachübereinstimmungen. Verwenden Sie diesen Modus, wenn Sie nicht sicher sind, dass Ihre Eingabe qualitativ hochwertig sowie frei von Tippfehlern und unvollständigen Angaben ist.

Custom

Ermöglicht es, die Vergleichskriterien zu definieren, indem die Felder MustMatch eingestellt werden. Sie können die Felder MustMatch allerdings nur mithilfe einer POST-Anforderung einstellen. Bei einer GET-Anforderung werden die MustMatch-Standardwerte verwendet. Weitere Informationen zu den MustMatch-Feldern erhalten Sie unter mustMatchFields.

Interactive (USA only)

Nur bei einzeiligem Adressabgleich verfügbar. In diesem Modus können die spezifischen Herausforderungen des interaktiven Abgleichs besser bewältigt werden. Im interaktiven Modus können flexiblere Übereinstimmungsmuster verwendet werden, was in einigen Fällen zusätzliche Kandidaten im Vergleich zum gelockerten Modus generiert.

CASS (USA only)

Schreibt zusätzliche Regeln vor, um Compliance mit den USPS CASS-Vorschriften zu gewährleisten. Dieser Vergleichsmodus dient dazu, postversandfähige Adressen für USPS-Postrabatte zu generieren. Verwenden Sie diesen Modus, um Ihre Eingabe für den Postversand zu generieren. Der Modus generiert eine große Anzahl von Kandidaten.

Geben Sie das referenzierte Koordinatensystem im Format codespace:code an.

• Eine landesspezifische Außerkraftsetzung von einem oder mehreren Elementen in den Objekten preferences, mustMatchFields oder returnFieldsDescriptor.
• Eine benutzerdefinierte landesspezifische Eingabeoption.

<customPreferences>
 <entry>
  <key>USA.maxReturnedCandidates</key>
  <value>3</value>
 </entry>
</customPreferences>

• ../UsingAPIs/../Countries/Australia/AUS.html#country_AUS
• ../UsingAPIs/../Countries/Canada/CAN.html#country_CAN
• Frankreich (FRA)
• Deutschland (DEU)
• Großbritannien (GBR)
• ../UsingAPIs/../Countries/NewZealand/NZL.html#country_NZL
• Portugal (PRT)
• Singapur (SGP)
• Schweden (SWE)
• Vereinigte Staaten (USA)

Für Länder, die sowohl benutzerdefinierte Benutzerwörterbücher als auch standardmäßige Geocoding-Datasets unterstützen, können Sie eine benutzerdefinierte Einstellung mit dem Schlüssel KEY_CUSTOM_DICTIONARY_USAGE festlegen, der die Such- und Vergleichseinstellungen definiert, wenn in der Geocoding-Engine sowohl benutzerdefinierte Benutzerwörterbücher als auch standardmäßige Geocoding-Datasets verfügbar sind. Diese Option ist nur beim Forward Geocoding verfügbar. Weitere Informationen finden Sie unter Festlegen von Such- und Vergleichseinstellungen bei Verwendung von Standard- und Benutzerwörterbüchern. Informationen dazu, ob Ihr Land benutzerdefinierte Benutzerwörterbücher unterstützt, erhalten Sie im Abschnitt „Unterstützte Geocoding-Datasets“ im Kapitel des jeweiligen Landes.

Wenn der World Geocoder (XWG) installiert ist, können Sie eine benutzerdefinierte Einstellung namens FALLBACK_TO_WORLD festlegen. Diese Einstellung gibt an, ob der XWG zum Ermitteln eines Geocodes verwendet werden soll, wenn kein Land-Geocoder installiert ist oder ein Land-Geocoder ohne ein Geocoding-Dataset installiert ist. XWG gibt entweder einen postalischen oder einen geografischen Geocode entsprechend dem Unterstützungsgrad im XWG-Geocoding-Dataset zurück. Optional:

True

Den World Geocoder (XWG) für den Vergleich verwenden, wenn kein Land-Geocoder installiert ist oder ein Land-Geocoder ohne ein Geocoding-Dataset installiert ist.

False

Den World Geocoder (XWG) nicht für den Vergleich verwenden, wenn kein Land-Geocoder installiert ist oder ein Land-Geocoder ohne ein Geocoding-Dataset installiert ist. Standardeinstellung.

True

Es muss eine Übereinstimmung mit der eingegebenen Adressnummer gefunden werden.

False

Eine Übereinstimmung mit der eingegebenen Adressnummer muss nicht gefunden werden. Standardeinstellung.

True

Es muss eine Übereinstimmung mit dem Eingabefeld PostCode1 gefunden werden.

False

Eine Übereinstimmung mit dem Eingabefeld PostCode1 muss nicht gefunden werden. Standardeinstellung.

True

Es muss eine Übereinstimmung mit dem Eingabefeld AreaName1 gefunden werden.

False

Eine Übereinstimmung mit dem Eingabefeld AreaName1 muss nicht gefunden werden. Standardeinstellung.

True

Es muss eine Übereinstimmung mit dem Eingabefeld AreaName2 gefunden werden.

False

Eine Übereinstimmung mit dem Eingabefeld AreaName2 muss nicht gefunden werden. Standardeinstellung.

True

Es muss eine Übereinstimmung mit dem Eingabefeld AreaName3 gefunden werden.

False

Eine Übereinstimmung mit dem Eingabefeld AreaName3 muss nicht gefunden werden. Standardeinstellung.

True

Es muss eine Übereinstimmung mit dem Eingabefeld AreaName4 gefunden werden.

False

Eine Übereinstimmung mit dem Eingabefeld AreaName4 muss nicht gefunden werden. Standardeinstellung.

True

Eine Übereinstimmung mit den Eingabefeldern für den Straßennamen, den Straßentyp und die Richtung muss gefunden werden.

False

Eine Übereinstimmung mit den Eingabefeldern für den Straßennamen, den Straßentyp und die Richtung muss nicht gefunden werden. Standardeinstellung.

True

Alle benutzerdefinierten Felder für den Kandidaten zurückgeben.

False

Nur die Standardgruppe der Felder für den Kandidaten zurückgeben. Standardeinstellung.

True

Das Deskriptorobjekt der Übereinstimmung zurückgeben. Dieses gibt die Teile des Kandidaten an, die mit der eingegebenen Adresse übereinstimmten.

False

Das Deskriptorobjekt der Übereinstimmung nicht zurückgeben. Standardeinstellung.

True

Alle einzelnen Straßenfelder, aus denen das Feld formattedStreetAddress zusammengesetzt ist, folgendermaßen einzeln zurückgeben:

• MAIN_ADDRESS: Der Basisteil eines Straßennamens. Beispiel: „River“ in „13 River Ave“
• THOROUGHFARE_TYPE: Der Landstraßentyp, der vor oder nach dem Straßennamen angegeben wird, z. B. Ave, Via, Str., Rd usw.
• ADDRESS_ID: Die eindeutige Kennung für die Adresse in den Quelldaten.
• PRE_ADDRESS: Der Wert kann Artikel usw. enthalten, die vor dem Hauptstraßennamen angegeben werden. Beispiel: „de la“ in „Calle de la mesa“
• POST_ADDRESS: Der Wert kann Wörter usw. enthalten, die nach dem Hauptstraßennamen angegeben werden. Beispiel: „de la tiedra“ in „Calle Ramon Perez de la tiedra“
• PRE_DIRECTIONAL: Der Wert enthält eine Richtungsangabe, die vor dem Hauptstraßennamen angegeben wird. Beispiel: „South“ in „123 South Main St“
• POST_DIRECTIONAL: Der Wert enthält eine Richtungsangabe, die nach dem Hauptstraßennamen angegeben wird. Beispiel: „SW“ in „123 River St SW“

False

Einzelne Straßenfelder nicht einzeln zurückgeben. Diese Werte im Feld formattedStreetAddress zurückgeben. Standardeinstellung.