Adresse akzeptieren - Beispiele

In diesem Dokument wird eine Reihe von realen Szenarien beschrieben, in denen die Address Validation API Antwortsignale bereitstellt, die eine Akzeptanz des Systems erfordern. Informationen zum Kontext finden Sie unter Validierungsantwort verwenden unter Workflowübersicht.

Gängiges Beispiel: Annehmen

Dieses Szenario veranschaulicht eine Adresse, in der Ihr System eine von einem Kunden eingegebene Adresse akzeptiert.

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

Ergebnis zu einer zulässigen Adresse

Im Beispiel unten sehen Sie die wichtigsten Signale.

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

Außerdem enthält die Antwort Folgendes:

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

Zusammen ergeben diese Signale eine qualitativ hochwertige Adresse.

Grenzfallbeispiele: Annehmen

Die folgenden Beispiele beziehen sich auf Situationen, in denen das verdict auf Probleme mit der Qualität hindeutet, die eine weitere Prüfung erfordern. Diese Beispiele veranschaulichen auch, wie sich die Logik vom Ergebnis zu den Adresskomponenten bewegen kann, um ein umfassenderes Bild zu erhalten und die Systemlogik zu verbessern.

Nicht bestätigte Hausnummer

In diesem Beispiel wird die Eingabe einer italienischen Adresse veranschaulicht, bei der alle Adresskomponenten und keine abgeleiteten oder ersetzten Komponenten vorhanden sind. Das validationGranularity ist jedoch ROUTE.

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

Ergebnis zu einer unbestätigten Hausnummer

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

Eine weitere Untersuchung der Adresskomponenten hat ergeben, dass die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE lautet.

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

Unbestätigte Hausnummer in den USA

Dieses Beispiel veranschaulicht die Eingabe einer US-Adresse, in der alle Adresskomponenten vorhanden sind und keine abgeleiteten oder ersetzten Komponenten enthalten. Das 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",
}

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

In diesem Beispiel wird die Eingabe einer US-Adresse veranschaulicht, bei der alle Adresskomponenten bestätigt sind, ohne abgeleitete oder ersetzte Komponenten und für validationGranularity der Wert PREMISE. 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 USA

Ergebnis zu einer bestätigten 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"
}