Untergeordneten Standort zur Adresse hinzufügen – Beispiele (nur USA)

In diesem Dokument werden eine Reihe von realen Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein add subpremises-Verhalten Ihres Systems rechtfertigen. Diese Signale sind nur für US-Adressen verfügbar. Beispielworkflows im Abschnitt Validierungslogik erstellen

Häufiges Beispiel: Unteradressen hinzufügen

In diesem Szenario wird eine Adresse veranschaulicht, bei der Ihr System einen Kunden möglicherweise auffordert, der Adresse eine Einheitsnummer hinzuzufügen.

Entscheidung für eine Adresse ohne untergeordnete Räumlichkeiten

Im folgenden Beispiel wird das wichtige Signal hervorgehoben.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Beispiel für einen Grenzfall: Untergeordnete Räumlichkeiten hinzufügen

Im folgenden Beispiel wird eine Situation beschrieben, in der verdict auf Probleme mit der Adressqualität hinweist, die weitere Untersuchungen erfordern. Dieses Beispiel veranschaulicht auch, wie Sie Ihre Logik vom Ergebnis zu den Adresskomponenten übertragen können, um ein umfassenderes Bild zu erhalten und Ihre Systemlogik zu verbessern.

Fehlende untergeordnete Prämissen und abgeleitete und ersetzte Komponenten

In diesem Beispiel wird die Eingabe einer US-Adresse mit einem fehlenden Ort und einer falschen Postleitzahl veranschaulicht.

Ergebnis für eine fehlende untergeordnete Prämisse und abgeleitete und ersetzte Komponenten

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Bei einer genaueren Untersuchung der Adresskomponenten wird deutlich, dass der Ort abgeleitet und die Postleitzahl ersetzt wurde.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}