Adresse akzeptieren - Beispiele

In diesem Dokument werden einige reale Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein Akzeptieren durch Ihr System rechtfertigen. Weitere Informationen finden Sie unter Workflow-Übersicht im Hilfeartikel Bestätigungsantwort verwenden.

Gängiges Beispiel: akzeptieren

In diesem Szenario wird eine Adresse dargestellt, bei der Ihr System eine von einem Kunden eingegebene Adresse akzeptiert.

Eingegebene Adresse Region
76 Buckingham Palace Road, London SW1W 9TQ UK

Entscheidung für eine akzeptable Adresse

Im folgenden Beispiel sind die wichtigsten Signale hervorgehoben.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Außerdem enthält die Antwort Folgendes:

  • hasUnconfirmedComponents bleibt false
  • hasInferredComponents bleibt false
  • hasReplacedComponents bleibt false

In Kombination weisen diese Signale auf eine Adresse mit hoher Qualität hin.

Beispiele für Grenzfälle: akzeptieren

Die folgenden Beispiele umfassen Situationen, in denen der Wert verdict auf Probleme mit der Qualität der Adresse hinweist, die einer weiteren Prüfung bedürfen. Diese Beispiele veranschaulichen auch, wie Ihre Logik vom Urteil zu den Adresskomponenten gelangen kann, um ein umfassenderes Bild zu erhalten und Ihre Systemlogik zu verbessern.

Nicht bestätigte Hausnummer außerhalb der USA

In diesem Beispiel wird die Eingabe einer italienischen Adresse mit allen Adresskomponenten dargestellt, ohne abgeleitete oder ersetzte Komponenten. validationGranularity ist jedoch ROUTE.

Eingegebene Adresse Region
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia IT

Entscheidung für eine nicht bestätigte Hausnummer

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Eine weitere Überprüfung der Adresskomponenten ergibt, dass die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE lautet.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Nicht bestätigte US-Hausnummer

In diesem Beispiel wird die Eingabe einer US-Adresse mit allen Adresskomponenten dargestellt, ohne abgeleitete oder ersetzte Komponenten. validationGranularity ist jedoch PREMISE_PROXIMITY.

Eingegebene Adresse Region
975 Carson Dr, Sunnyvale, CA 94086, USA USA

USPS-Daten für eine nicht bestätigte Hausnummer

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Unvollständige USPS-Daten für eine bestätigte Adresse

In diesem Beispiel wird die Eingabe einer US-Adresse mit allen bestätigten Adresskomponenten, ohne abgeleitete oder ersetzte Komponenten und einer validationGranularity von PREMISE dargestellt. uspsData ist jedoch nicht vollständig ausgefüllt und enthält keinen dpvConfirmation-Wert.

Eingegebene Adresse Region
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 USA

Entscheidung für eine bestätigte Adresse mit unvollständigen USPS-Daten

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
}

USPS-Daten für eine bestätigte Adresse mit unvollständigen USPS-Daten

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}