W tym dokumencie opisano kilka rzeczywistych sytuacji, w których Interfejs Address Validation API dostarcza sygnały wymagające odpowiedzi, które wymagają zaakceptowania z Twojego systemu. Zobacz Omówienie przepływu pracy w Użyj odpowiedzi weryfikacyjnej, aby uzyskać kontekst.
Typowy przykład: akceptacja
Ten scenariusz ilustruje adres, w którym system akceptowałby adres podany przez klienta.
Wpisano adres | Region |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ, Wielka Brytania | Wielka Brytania |
Ocena akceptowanego adresu
W przykładzie poniżej pokazujemy najważniejsze sygnały.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Dodatkowo odpowiedź zawiera te informacje:
hasUnconfirmedComponents
pozostajefalse
hasInferredComponents
pozostajefalse
hasReplacedComponents
pozostajefalse
Połączenie tych sygnałów wskazuje na wysoką jakość adresu.
Przykłady skrajnych przypadków: akceptuj
Poniższe przykłady opisują sytuacje, w których verdict
wskazuje adres
problemy z jakością, które wymagają dalszego zbadania. Również w tych przykładach
zilustruj, jak logika może przejść od wyniku do składowych adresu
aby uzyskać pełniejszy obraz i ulepszyć logikę systemu.
Niepotwierdzony numer budynku (poza USA)
Ten przykład ilustruje wprowadzanie adresu we Włoszech ze wszystkimi składnikami adresu
i nie zawiera żadnych wykrytych ani zastąpionych komponentów. Jednak
Obecny stan „validationGranularity
”: ROUTE
.
Wpisano adres | Region |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 vaso CH, Włochy | IT |
Ocena niepotwierdzonego numeru budynku
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Dalsze badanie składników adresu wykazało, że ulica
numer to UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Niepotwierdzony numer budynku w USA
Ten przykład ilustruje wprowadzanie adresu w Stanach Zjednoczonych ze wszystkimi składnikami adresu
bez elementów wywnioskowanych ani zastąpionych. Jednak
Obecny stan „validationGranularity
”: PREMISE_PROXIMITY
.
Wpisano adres | Region |
---|---|
975 Carson Dr, Sunnyvale, CA 94086, USA | Stany Zjednoczone |
Dane USPS dotyczące niepotwierdzonego numeru budynku
{
"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",
}
Niekompletne dane USPS dotyczące potwierdzonego adresu
Ten przykład ilustruje wprowadzanie adresu w Stanach Zjednoczonych ze wszystkimi składnikami adresu
potwierdzono bez żadnych domniemanych ani zastąpionych komponentów, oraz
validationGranularity
z PREMISE
. uspsData
nie jest jednak w pełni kompletny
jest wypełnione i nie zawiera wartości dpvConfirmation
.
Wpisano adres | Region |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | Stany Zjednoczone |
Ocena potwierdzonego adresu z niepełnymi danymi USPS
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
dane USPS dotyczące potwierdzonego adresu z niepełnymi danymi USPS;
{
"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"
}