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 Beispiel-Workflows im Abschnitt Validierungslogik erstellen.

Typisches Beispiel: Akzeptieren

Dieses Szenario veranschaulicht eine Adresse, die Ihr System akzeptieren würde, wenn sie von einem Kunden eingegeben wird.

Urteil für eine akzeptable Adresse

Im Beispiel unten sind die wichtigen 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
• hasSpellCorrectedComponents bleibt false

In Kombination weisen diese Signale auf eine hochwertige Adresse hin.

Beispiele für Grenzfälle: Akzeptieren

Die folgenden Beispiele zeigen Situationen, in denen die verdict auf Probleme mit der Adressqualität hinweist, die weiter untersucht werden sollten. Diese Beispiele zeigen auch, wie Sie von der Bewertung zu den Adresskomponenten gelangen, um ein vollständigeres 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 gezeigt, ohne abgeleitete oder ersetzte Komponenten. Der validationGranularity ist jedoch ROUTE.

Urteil für eine unbestätigte Hausnummer

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

Eine genauere Untersuchung der Adresskomponenten ergibt, dass die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE ist.

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

Nicht bestätigte Hausnummer (USA)

In diesem Beispiel wird die Eingabe einer US-Adresse mit allen Adresskomponenten gezeigt, ohne dass Komponenten abgeleitet oder ersetzt werden. Der validationGranularity ist jedoch PREMISE_PROXIMITY.

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 mit einem validationGranularity von PREMISE veranschaulicht. uspsData ist jedoch nicht vollständig ausgefüllt und enthält keinen dpvConfirmation-Wert.

Ergebnis 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"
}