La risposta dell'API Address Validation contiene le seguenti proprietà di primo livello:
{
// Address details determined by the API.
"address": {},
// Validation verdict.
"verdict": {},
// The geocode generated for the input address.
"geocode": {},
// Information indicating if the address is a business, residence, etc.
"metadata": {},
// Information about the address from the US Postal Service
// ("US" and "PR" addresses only).
"uspsData": {},
// A unique identifier generated for every request to the API.
"responseId": "ID"
}
La proprietà verdict
La proprietà verdict riassume i risultati della convalida dell'indirizzo e deve essere la prima proprietà da valutare quando crei la logica di controllo dell'indirizzo.
La proprietà può restituire una varietà di campi, a seconda della qualità dell'indirizzo di output. Ad esempio, di seguito viene mostrata la proprietà verdict di un indirizzo di buona qualità, che restituisce i seguenti campi per questa richiesta specifica:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"possibleNextAction": "ACCEPT",
"addressComplete": true,
"hasUnconfirmedComponents": false,
"hasInferredComponents": true,
"hasReplacedComponents": false
}
Le sezioni seguenti riepilogano tutti i campi della proprietà verdict.
| Consulta Esito nella guida di riferimento. |
Granularità dell'indirizzo
La granularità dell'indirizzo si riferisce al livello di dettaglio utilizzato per determinare la specificità di un indirizzo o di un geocodice. La specificità dell'indirizzo nella risposta validationGranularity è un segnale chiave per indicare se un indirizzo è recapitabile o meno.
La proprietà verdict restituisce questi segnali di granularità:
inputGranularity: descrive il livello di dettaglio acquisito dall'indirizzo inviato all'API Address Validation in Maps JavaScript. Il livello di dettaglio dell'indirizzo nella richiesta influisce sul livello di dettaglio dell'indirizzo nella risposta di convalida. Ad esempio, un indirizzo con uninputGranularityinferiore al livelloPREMISEin genere non genera unvalidationGranularitya un livelloPREMISE.validationGranularity: il livello di granularità a cui l' API Maps JavaScript di Address Validation può convalidare completamente l'indirizzo. Nella maggior parte dei casi, un livello di granularitàPREMISEoSUB_PREMISEindica un indirizzo di qualità che è probabilmente recapitabile.geocodeGranularity: descrive il livello di dettaglio del geocodice associato all'indirizzo. Ad esempio, i record di Google potrebbero indicare l'esistenza di un numero di appartamento, ma non una posizione precisa per quell'appartamento specifico all'interno di un grande complesso di appartamenti. In questo caso,validationGranularityèSUB_PREMISEmageocodeGranularityèPREMISE.
| Consulta Granularità nella guida di riferimento. |
Completezza dell'indirizzo
L'esito restituisce la proprietà addressComplete come segnale per un indirizzo di alta qualità, il che significa in particolare che non ha componenti mancanti, non risolti o imprevisti:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Se l'indirizzo ha componenti mancanti, non risolti o imprevisti, il campo è impostato su false.
Consulta addressComplete in
Esito e
Indirizzo nella guida di riferimento. |
Qualità dell'indirizzo
Diversi campi possibili indicano problemi con i componenti dell'indirizzo o modifiche, come componenti dell'indirizzo dedotti o mancanti. Ad esempio, la seguente proprietà verdict indica un indirizzo con componenti non confermati e un campo addressComplete mancante:
"verdict": {
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true,
"hasInferredComponents": true
}
| Consulta Esito nella guida di riferimento. |
Possibile azione successiva
Il campo dell'esito possibleNextAction
offre un riepilogo interpretativo della risposta dell'API, progettato per
aiutarti a determinare una potenziale azione successiva da intraprendere. Questo campo viene derivato da altri campi nella risposta dell'API e non deve essere considerato una garanzia di accuratezza o recapitabilità dell'indirizzo.
Le proprietà address e addressComponent
La proprietà address fornisce la formattazione dell'indirizzo elaborato fornito nella richiesta, insieme ai riepiloghi a livello di componente dell'indirizzo, incluse le parti dell'indirizzo con errori di ortografia, le parti errate sostituite e le parti mancanti dedotte.
Consulta Address nella guida di riferimento. |
La proprietà addressComponent è un sottocomponente di address che fornisce
un elenco dettagliato degli elementi, o componenti, dell'indirizzo elaborato dall'
API Maps JavaScript di Address Validation. L'API identifica ogni campo componente fornito in base al nome, al tipo e al livello di conferma.
Consulta addressComponent nella guida di riferimento. |
La proprietà geocode
La proprietà geocode indica la località geocodificata associata all'indirizzo di input. Questa proprietà fornisce dettagli sulla località stessa, ad esempio il relativo ID luogo.
Consulta Geocode nella guida di riferimento. |
La proprietà metadata
Questa proprietà potrebbe non essere compilata per ogni indirizzo elaborato dall'API Address Validation in Maps JavaScript, ma indica se l'indirizzo è di tipo residenziale, attività o casella postale.
Consulta la copertura dell'API Address Validation e il riferimento per Address metadata.
|
La proprietà uspsData
Questa proprietà fornisce informazioni utili per gli indirizzi postali degli Stati Uniti.
Tuttavia, non è garantito che sia completamente compilata per ogni indirizzo convalidato dal servizio. Per questo motivo, non devi fare affidamento su questa proprietà come unico mezzo per convalidare gli indirizzi, ma devi controllare anche verdict e address.
Consulta Gestire gli indirizzi degli Stati Uniti e il riferimento per USPSData.
|