Adresse akzeptieren - Beispiele

In diesem Dokument werden eine Reihe von realen Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein accept-Verhalten Ihres Systems rechtfertigen. Beispielworkflows im Abschnitt Validierungslogik erstellen

Häufiges Beispiel: „accept“

In diesem Szenario wird eine Adresse veranschaulicht, die von Ihrem System akzeptiert würde, wenn sie von einem Kunden eingegeben wird.

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

Entscheidung für eine akzeptable Adresse

Im folgenden Beispiel werden die wichtigen Signale hervorgehoben.

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

Außerdem wird in der Antwort Folgendes angegeben:

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

In Kombination deuten diese Signale auf eine Adresse von hoher Qualität hin.

Beispiele für Grenzfälle: Akzeptieren

Die folgenden Beispiele beschreiben Situationen, in denen verdict auf Probleme mit der Adressqualität hinweist, die weitere Untersuchungen erfordern. Diese Beispiele veranschaulichen auch, wie Sie Ihre Logik vom Ergebnis zu den Adresskomponenten übertragen können, 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 veranschaulicht. Es werden keine Komponenten abgeleitet oder ersetzt. validationGranularity ist jedoch ROUTE.

Adresse eingegeben Region
Via Fonte Grugnale, 14 Unit 2, 66054 Vasto CH, Italien IT

Entscheidung für eine nicht bestätigte Hausnummer

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

Bei der weiteren Untersuchung der Adresskomponenten wird festgestellt, dass die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE ist.

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

Nicht bestätigte US-Hausnummer

In diesem Beispiel wird eine US-Adresse mit allen Adresskomponenten eingegeben, ohne dass Komponenten abgeleitet oder ersetzt werden. validationGranularity ist jedoch PREMISE_PROXIMITY.

Adresse eingegeben Region
975 Carson Dr, Sunnyvale, CA 94086 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 mit einem validationGranularity von PREMISE veranschaulicht. Die uspsData ist jedoch nicht vollständig ausgefüllt und enthält keinen dpvConfirmation-Wert.

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

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