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

In diesem Dokument werden verschiedene reale Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein Untergebäude hinzufügen-Verhalten Ihres Systems rechtfertigen. Diese Signale sind nur für US-Adressen verfügbar. Weitere Informationen finden Sie unter Beispiel-Workflows im Abschnitt Validierungslogik erstellen.

Häufiges Beispiel: Untergebäude hinzufügen

In diesem Szenario wird eine Adresse dargestellt, bei der Ihr System einen Kunden auffordern könnte, der Adresse eine Wohnungsnummer hinzuzufügen.

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

Urteil für eine Adresse ohne Untergebäude

Im Beispiel unten 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

Das folgende Beispiel zeigt eine Situation, in der die verdict auf Probleme mit der Adressqualität hinweist, die weiter untersucht werden sollten. Dieses Beispiel zeigt auch, wie Sie von der Bewertung zu den Adresskomponenten gelangen, um ein vollständigeres Bild zu erhalten und Ihre Systemlogik zu verbessern.

Fehlende Untergebäude und abgeleitete und ersetzte Komponenten

In diesem Beispiel wird eine US-Adresse mit fehlendem Ort und falscher Postleitzahl eingegeben.

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

Urteil für fehlende Untergebäude und abgeleitete und ersetzte Komponenten

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

Eine genauere Untersuchung der Adresskomponenten zeigt, 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
}