Adresse akzeptieren - Beispiele

In diesem Dokument werden eine Reihe von Beispielen aus der Praxis beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein Akzeptieren durch Ihr System rechtfertigen. Weitere Informationen finden Sie unter Workflow-Übersicht in Validierungsantwort verwenden.

Häufiges Beispiel: Akzeptieren

In diesem Szenario wird eine Adresse veranschaulicht, bei der Ihr System eine vom Kunden eingegebene Adresse akzeptieren würde.

Eingegebene Adresse Region
76 Buckingham Palace Road, London SW1W 9TQ Vereinigtes Königreich

Ergebnis für eine akzeptable Adresse

Im folgenden Beispiel werden die wichtigen Signale hervorgehoben.

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

Außerdem gibt verdict Folgendes an:

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

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

Beispiele für Grenzfälle: Akzeptieren

In den folgenden Beispielen werden Situationen behandelt, in denen die verdict auf Probleme mit der Adressqualität hinweist, die eine weitere Untersuchung rechtfertigen. Diese Beispiele veranschaulichen auch, wie Ihre Logik vom Ergebnis zu den Adresskomponenten wechseln kann, um ein umfassenderes Bild zu erhalten und so Ihre Systemlogik zu verbessern.

Nicht bestätigte Hausnummer außerhalb der USA

In diesem Beispiel wird die Eingabe einer italienischen Adresse mit allen Adresskomponenten sowie ohne abgeleitete oder ersetzte Komponenten veranschaulicht. Die validationGranularity ist ROUTE.

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

Ergebnis für eine nicht bestätigte Hausnummer

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

Eine weitere Untersuchung der Adresskomponenten ergibt, dass der Bestätigungsgrad für die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE ist.

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

Nicht bestätigte Hausnummer in den USA

In diesem Beispiel wird die Eingabe einer US-Adresse mit allen Adresskomponenten sowie ohne abgeleitete oder ersetzte Komponenten veranschaulicht. Die validationGranularity ist PREMISE_PROXIMITY.

Eingegebene Adresse 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 Adresskomponenten bestätigt, ohne abgeleitete oder ersetzte Komponenten und einer validationGranularity von PREMISE veranschaulicht. Die 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

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