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 das Verhalten add subpremises 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.

Adresse eingegeben Region
1450 Brickell Avenue, Miami, FL 33131-4065, USA USA

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 Gebäude 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 Ihre Logik vom Ergebnis zu den Adresskomponenten übergehen kann, um ein umfassenderes Bild zu erhalten und Ihre Systemlogik zu verbessern.

Fehlende untergeordnete Räume und abgeleitete und ersetzte Komponenten

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

Adresse eingegeben Region
1450 Brickell Avenue, FL 33132-4065 USA

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