Indice
AddressValidation
(interfaccia)Address
(messaggio)AddressComponent
(messaggio)AddressComponent.ConfirmationLevel
(enum)AddressMetadata
(messaggio)ComponentName
(messaggio)Geocode
(messaggio)LanguageOptions
(messaggio)PlusCode
(messaggio)ProvideValidationFeedbackRequest
(messaggio)ProvideValidationFeedbackRequest.ValidationConclusion
(enum)ProvideValidationFeedbackResponse
(messaggio)UspsAddress
(messaggio)UspsData
(messaggio)ValidateAddressRequest
(messaggio)ValidateAddressResponse
(messaggio)ValidationResult
(messaggio)Verdict
(messaggio)Verdict.Granularity
(enum)
AddressValidation
Il servizio per la convalida degli indirizzi.
ProvideValidationFeedback |
---|
Feedback sul risultato della sequenza di tentativi di convalida. Deve essere l'ultima chiamata effettuata dopo una sequenza di chiamate di convalida per lo stesso indirizzo e deve essere richiamata al termine della transazione. Deve essere inviato solo una volta per la sequenza di |
ValidateAddress |
---|
Convalida un indirizzo. |
Indirizzo
Dettagli dell'indirizzo post-elaborato. La post-elaborazione include la correzione delle parti dell'indirizzo con errori ortografici, la sostituzione di parti errate e la deduzione delle parti mancanti.
Campi | |
---|---|
formatted_address |
L'indirizzo post-elaborato, formattato come indirizzo di una sola riga che segue le regole di formattazione dell'indirizzo della regione in cui si trova l'indirizzo. |
postal_address |
L'indirizzo post-elaborato rappresentato come indirizzo postale. |
address_components[] |
Elenco non ordinato. I singoli componenti dell'indirizzo formattato e corretto, insieme alle informazioni di convalida. Fornisce informazioni sullo stato di convalida dei singoli componenti. I componenti dell'indirizzo non sono ordinati in un modo particolare. Non fare ipotesi sull'ordine dei componenti dell'indirizzo nell'elenco. |
missing_component_types[] |
I tipi di componenti che dovevano essere presenti in un indirizzo postale formattato correttamente, ma che non sono stati trovati nell'input E non è stato possibile dedurre. I componenti di questo tipo non sono presenti in |
unconfirmed_component_types[] |
I tipi di componenti presenti in |
unresolved_tokens[] |
Eventuali token nell'input che non è stato possibile risolvere. Potrebbe trattarsi di un input che non è stato riconosciuto come parte valida di un indirizzo (ad esempio, in un input come "123235253253 Main St, San Francisco, CA, 94105", i token non risolti potrebbero essere simili a |
AddressComponent
Rappresenta un componente dell'indirizzo, come una strada, una città o una provincia.
Campi | |
---|---|
component_name |
Il nome di questo componente. |
component_type |
Il tipo di componente dell'indirizzo. Consulta la Tabella 2: tipi aggiuntivi restituiti dal servizio Places per un elenco dei tipi possibili. |
confirmation_level |
Indica il livello di certezza che il componente è corretto. |
inferred |
Indica che il componente non faceva parte dell'input, ma lo abbiamo dedotto per la posizione dell'indirizzo e riteniamo che debba essere fornito per un indirizzo completo. |
spell_corrected |
Indica una correzione a un errore di ortografia nel nome del componente. L'API non segnala sempre le modifiche da una variante ortografica a un'altra, ad esempio quando si cambia "center" in "center". Inoltre, non segnala sempre errori di ortografia comuni, come la modifica di "Amphitheater Pkwy" in "Amphitheatre Pkwy". |
replaced |
Indica che il nome del componente è stato sostituito con uno completamente diverso, ad esempio un codice postale errato che è stato sostituito con uno corretto per l'indirizzo. Non si tratta di una modifica formale, il componente di input è stato sostituito con uno diverso. |
unexpected |
Indica un componente dell'indirizzo che non dovrebbe essere presente in un indirizzo postale per la regione specificata. Le abbiamo conservate solo perché facevano parte dell'input. |
ConfirmationLevel
I diversi valori possibili per i livelli di conferma.
Enum | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
CONFIRMED |
Abbiamo potuto verificare che questo componente esista e abbia senso nel contesto del resto dell'indirizzo. |
UNCONFIRMED_BUT_PLAUSIBLE |
Non è stato possibile confermare questo componente, ma è plausibile che esista. Ad esempio, un numero civico compreso in un intervallo valido noto di una via in cui non sono noti numeri civici specifici. |
UNCONFIRMED_AND_SUSPICIOUS |
Questo componente non è stato confermato ed è probabile che sia errato. Ad esempio, un quartiere che non corrisponde al resto dell'indirizzo. |
AddressMetadata
I metadati dell'indirizzo. Non è garantito che metadata
venga compilato completamente per ogni indirizzo inviato all'API Address Validation.
Campi | |
---|---|
business |
Indica che questo è l'indirizzo di un'attività commerciale. Se non viene configurato, indica che il valore è sconosciuto. |
po_box |
Indica l'indirizzo di una casella postale. Se non viene configurato, indica che il valore è sconosciuto. |
residential |
Indica che questo è l'indirizzo di una residenza. Se non viene configurato, indica che il valore è sconosciuto. |
ComponentName
Un wrapper per il nome del componente.
Campi | |
---|---|
text |
Il testo del nome. Ad esempio, "5th Avenue" per il nome di una via o "1253" per un numero civico. |
language_code |
Il codice lingua BCP-47. Non sarà presente se il nome del componente non è associato a una lingua, come un numero civico. |
Geocodifica
Contiene informazioni sul luogo in cui è stato geocodificato l'input.
Campi | |
---|---|
location |
La posizione geocodificata dell'input. È preferibile utilizzare gli ID luogo rispetto a indirizzi, coordinate di latitudine/longitudine o plus code. L'utilizzo delle coordinate per il calcolo degli itinerari o delle indicazioni stradali comporta sempre l'agganciamento del punto alla strada più vicina a queste coordinate. Potrebbe non essere una strada che condurrà rapidamente o in sicurezza alla destinazione e potrebbe non essere vicina a un punto di accesso alla proprietà. Inoltre, se una località viene geocodificata in modo inverso, non vi è alcuna garanzia che l'indirizzo restituito corrisponda all'originale. |
plus_code |
Il plus code corrispondente a |
bounds |
I confini del luogo geocodificato. |
feature_size_meters |
Le dimensioni del luogo geocodificato in metri. Si tratta di un'altra misura della ruvidità della posizione geocodificata, ma in termini di dimensioni fisiche anziché di significato semantico. |
place_id |
Il PlaceID del luogo in cui viene geocodificato questo input. Per ulteriori informazioni sugli ID luogo, visita questa pagina. |
place_types[] |
Il tipo o i tipi di luogo in cui è stato geocodificato l'input. Ad esempio, |
LanguageOptions
Anteprima: questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.
Consente all'API Address Validation di includere informazioni aggiuntive nella risposta.
Campi | |
---|---|
return_english_latin_address |
Anteprima: restituisci un |
PlusCode
Il Plus Code (http://plus.codes) è un riferimento di località con due formati: codice globale che definisce un rettangolo di 14 x 14 m (1/8000 di grado) e un codice composto, che sostituisce il prefisso con una posizione di riferimento.
Campi | |
---|---|
global_code |
Il codice globale (completo) del luogo, ad esempio "9FWM33GV+HQ ", che rappresenta un'area di 1/8000 di 1/8000 gradi (~14 x 14 metri). |
compound_code |
Codice composto del luogo, ad esempio "33GV+HQ, Ramberg, Norvegia ", contenente il suffisso del codice globale e sostituendo il prefisso con il nome formattato di un'entità di riferimento. |
ProvideValidationFeedbackRequest
La richiesta per inviare il feedback sulla convalida.
Campi | |
---|---|
conclusion |
obbligatorio. Il risultato della sequenza di tentativi di convalida. Se questo campo viene impostato su |
response_id |
obbligatorio. L'ID della risposta a cui è destinato questo feedback. Deve essere l'ID [response_id][google.maps.addressvalidation.v1.ConvalidaAddressRequest.response_id] della prima risposta di una serie di tentativi di convalida dell'indirizzo. |
ValidationConclusion
I possibili risultati finali della sequenza di richieste di convalida degli indirizzi necessarie per convalidare un indirizzo.
Enum | |
---|---|
VALIDATION_CONCLUSION_UNSPECIFIED |
Questo valore non è utilizzato. Se il campo ProvideValidationFeedbackRequest.conclusion è impostato su VALIDATION_CONCLUSION_UNSPECIFIED , verrà restituito un errore INVALID_ARGUMENT . |
VALIDATED_VERSION_USED |
Per la transazione è stata utilizzata la versione dell'indirizzo restituito dall'API Address Validation. |
USER_VERSION_USED |
La versione dell'indirizzo fornito dall'utente è stata utilizzata per la transazione |
UNVALIDATED_VERSION_USED |
Per la transazione è stata utilizzata una versione dell'indirizzo inserita dopo l'ultimo tentativo di convalida, ma non riconvalidato. |
UNUSED |
La transazione è stata abbandonata e l'indirizzo non è stato utilizzato. |
ProvideValidationFeedbackResponse
Questo tipo non contiene campi.
La risposta per il feedback sulla convalida.
Se il feedback viene inviato correttamente, la risposta è vuota.
UspsAddress
Rappresentazione USPS di un indirizzo negli Stati Uniti.
Campi | |
---|---|
first_address_line |
Prima riga dell'indirizzo. |
firm |
Nome dell'azienda. |
second_address_line |
Seconda riga indirizzo. |
urbanization |
Nome dell'urbanizzazione portoricana. |
city_state_zip_address_line |
Città + stato + codice postale. |
city |
Nome della città. |
state |
Codice di stato di 2 lettere. |
zip_code |
Codice postale, ad esempio 10009. |
zip_code_extension |
Estensione codice postale a 4 cifre, ad esempio 5023. |
UspsData
I dati USPS per l'indirizzo. Non è garantito che uspsData
venga compilato completamente per ogni indirizzo statunitense o PR inviato all'API Address Validation. Ti consigliamo di integrare i campi dell'indirizzo di backup nella risposta se utilizzi uspsData come parte principale della risposta.
Campi | |
---|---|
standardized_address |
Indirizzo standardizzato USPS. |
delivery_point_code |
Codice punto di consegna a 2 cifre |
delivery_point_check_digit |
La cifra di controllo del punto di consegna. Questo numero viene aggiunto alla fine del delivery_point_barcode per la posta scansionata meccanicamente. Sommando tutte le cifre di delivery_point_barcode, delivery_point_check_digit, codice postale e ZIP+4 si dovrebbe ottenere un numero divisibile per 10. |
dpv_confirmation |
I valori possibili per la conferma DPV. Restituisce un singolo carattere o non restituisce alcun valore.
|
dpv_footnote |
Le note a piè di pagina della convalida del punto di consegna. Più note a piè di pagina possono essere unite nella stessa stringa.
|
dpv_cmra |
Indica se l'indirizzo è una CMRA (Commercial Mail Receipt Agency), un'azienda privata che riceve posta per i clienti. Restituisce un singolo carattere.
|
dpv_vacant |
Questo luogo non è disponibile? Restituisce un singolo carattere.
|
dpv_no_stat |
È un indirizzo senza statistica o è attivo? Non si tratta di indirizzi per le statistiche che non sono continuamente occupati o che non vengono serviti dall'USPS. Restituisce un singolo carattere.
|
dpv_no_stat_reason_code |
Indica il tipo NoStat. Restituisce un codice motivo come int.
|
dpv_drop |
Il contrassegno indica che la posta viene recapitata a un singolo destinatario in un sito. Restituisce un singolo carattere.
|
dpv_throwback |
Indica che la posta non viene recapitata alla via. Restituisce un singolo carattere.
|
dpv_non_delivery_days |
Il flag indica che il recapito della posta non viene eseguito tutti i giorni della settimana. Restituisce un singolo carattere.
|
dpv_non_delivery_days_values |
Numero intero che identifica i giorni di mancata consegna. Può essere interrogato usando i bit flag: 0x40 – Domenica è un giorno di mancata consegna 0x20 – Lunedì è un giorno di mancata consegna 0x10 – Martedì è un giorno di mancata consegna 0x08 – Mercoledì è un giorno di mancata consegna 0x04 – Giovedì è un giorno di mancata consegna 0x02 – Venerdì è un giorno di mancata consegna 0x01 – |
dpv_no_secure_location |
Il flag indica che la porta è accessibile, ma il pacco non verrà lasciato per problemi di sicurezza. Restituisce un singolo carattere.
|
dpv_pbsa |
Indica che l'indirizzo è stato abbinato al record PBSA. Restituisce un singolo carattere.
|
dpv_door_not_accessible |
La bandierina indica gli indirizzi a cui USPS non può bussare alla porta per recapitare la posta. Restituisce un singolo carattere.
|
dpv_enhanced_delivery_code |
Indica che più di un codice restituito DPV è valido per l'indirizzo. Restituisce un singolo carattere.
|
carrier_route |
Il codice di percorso dell'operatore. Un codice a quattro caratteri composto da un prefisso di una lettera e un identificatore di percorso a tre cifre. Prefissi:
|
carrier_route_indicator |
Indicatore di ordinamento della tariffa di percorso del corriere. |
ews_no_match |
L'indirizzo di consegna può corrispondere, ma il file EWS indica che sarà disponibile a breve una corrispondenza esatta. |
post_office_city |
Città dell'ufficio postale principale. |
post_office_state |
Stato dell'ufficio postale principale. |
abbreviated_city |
Città abbreviata. |
fips_county_code |
Codice contea FIPS. |
county |
Nome della contea. |
elot_number |
Numero eLOT (Enhanced Line of Travel). |
elot_flag |
Flag eLOT crescente/decrescente (A/D). |
lacs_link_return_code |
Codice di restituzione LACSLink. |
lacs_link_indicator |
Indicatore LACSLink. |
po_box_only_postal_code |
solo il codice postale della casella postale. |
suitelink_footnote |
Note a piè di pagina della corrispondenza di una strada o di un grattacielo con informazioni sull'interno. Se viene trovata una corrispondenza del nome dell'attività, viene restituito il numero secondario.
|
pmb_designator |
Designatore di unità PMB (Private Mail Box). |
pmb_number |
Numero PMB (Private Mail Box); |
address_record_type |
Tipo del record dell'indirizzo che corrisponde all'indirizzo di input.
|
default_address |
Indicatore che indica che è stato trovato un indirizzo predefinito, ma esistono indirizzi più specifici. |
error_message |
Messaggio di errore per il recupero dei dati USPS. Questo campo viene compilato quando l'elaborazione USPS viene sospesa a causa del rilevamento di indirizzi creati artificialmente. I campi dei dati USPS potrebbero non essere compilati quando è presente questo errore. |
cass_processed |
Indicatore che indica che la richiesta è stata elaborata dal CASS. |
ValidateAddressRequest
La richiesta per convalidare un indirizzo.
Campi | |
---|---|
address |
obbligatorio. L'indirizzo in fase di convalida. Gli indirizzi non formattati devono essere inviati tramite La lunghezza totale dei campi in questo input non deve superare i 280 caratteri. Le regioni supportate sono disponibili qui. Il valore L'API Address Validation ignora i valori in |
previous_response_id |
Questo campo deve essere vuoto per la prima richiesta di convalida dell'indirizzo. Se sono necessarie più richieste per convalidare completamente un singolo indirizzo (ad esempio, se le modifiche apportate dall'utente dopo la convalida iniziale devono essere riconvalidate), ogni richiesta di follow-up deve completare questo campo con il valore |
enable_usps_cass |
Attiva la modalità compatibile con USPS CASS. Questo influisce solo sul campo Si consiglia di utilizzare un oggetto |
language_options |
Campo facoltativo. Anteprima: questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. Consente all'API Address Validation di includere informazioni aggiuntive nella risposta. |
session_token |
Campo facoltativo. Una stringa che identifica una sessione di completamento automatico ai fini della fatturazione. Deve essere una stringa Base64 sicura per URL e nome file con al massimo 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT. La sessione inizia quando l'utente esegue una query di completamento automatico e si conclude quando seleziona un luogo e viene effettuata una chiamata a Place Details o Address Validation. Ogni sessione può avere più query di completamento automatico, seguite da una richiesta Dettagli luogo o Convalida indirizzo. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Al termine di una sessione, il token non è più valido; l'app deve generare un token nuovo per ogni sessione. Se il parametro Nota: Address Validation può essere utilizzata solo in sessioni con l'API Autocomplete (New) e non con l'API Autocomplete. Per maggiori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/session-pricing. |
ValidateAddressResponse
La risposta a una richiesta di convalida dell'indirizzo.
Campi | |
---|---|
result |
Il risultato della convalida dell'indirizzo. |
response_id |
L'UUID che identifica questa risposta. Se l'indirizzo deve essere riconvalidato, questo UUID deve accompagnare la nuova richiesta. |
ValidationResult
Il risultato della convalida di un indirizzo.
Campi | |
---|---|
verdict |
Flag di esito complessivo |
address |
Informazioni sull'indirizzo stesso anziché sul geocodice. |
geocode |
Informazioni sulla località e sul luogo a cui è stato geocodificato l'indirizzo. |
metadata |
Altre informazioni pertinenti per l'invio di contenuti. Non è garantito che |
usps_data |
Segnalazioni di consegna extra fornite da USPS. Fornita solo nella regione |
english_latin_address |
Anteprima: questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le Offerte pre-GA sono coperte dai Termini di servizio specifici per Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. L'indirizzo viene tradotto in inglese. Gli indirizzi tradotti non sono riutilizzabili come input dell'API. Il servizio le fornisce in modo che l'utente possa utilizzare la propria lingua madre per confermare o rifiutare la convalida dell'indirizzo fornito in origine. Se parte dell'indirizzo non include una traduzione in inglese, il servizio restituisce quella parte in una lingua alternativa che utilizza il latino. Leggi qui per una spiegazione di come viene selezionata la lingua alternativa. Se parte dell'indirizzo non contiene traduzioni o traslitterazioni in una lingua che utilizza la scrittura latina, il servizio restituisce quella parte nella lingua locale associata all'indirizzo. Abilita questo output utilizzando il flag Nota: i campi |
Esito
Panoramica generale del risultato della convalida dell'indirizzo e del geocodice.
Campi | |
---|---|
input_granularity |
La granularità dell'indirizzo di input. Questo è il risultato dell'analisi dell'indirizzo di input e non fornisce indicatori di convalida. Per gli indicatori di convalida, consulta la sezione Ad esempio, se l'indirizzo di input include un numero di appartamento specifico, |
validation_granularity |
Il livello di granularità per cui l'API può validate completamente l'indirizzo. Ad esempio, Il risultato della convalida del componente per indirizzo è disponibile in |
geocode_granularity |
Informazioni sulla granularità di Questo valore a volte può differire dai |
address_complete |
L'indirizzo è considerato completo se non sono presenti token non risolti e non sono presenti componenti imprevisti o mancanti dell'indirizzo. Se non viene configurato, indica che il valore è |
has_unconfirmed_components |
Almeno un componente dell'indirizzo non può essere classificato o convalidato. Consulta |
has_inferred_components |
È stato dedotto (aggiunto) almeno un componente dell'indirizzo che non era presente nell'input. Consulta |
has_replaced_components |
È stato sostituito almeno un componente dell'indirizzo. Consulta |
Granularità
Le varie granularità che un indirizzo o un geocodice può avere. Quando vengono utilizzati per indicare la granularità di un indirizzo, questi valori indicano il grado di granularità dell'identificazione di una destinazione di distribuzione da parte dell'indirizzo. Ad esempio, un indirizzo come "Via Roma 123, Fiumicino - RM 00194" identifica un identificativo PREMISE
, mentre un indirizzo LOCALITY
Tuttavia, se non riusciamo a trovare un codice geografico per "123 Main Street" a Redwood City, il codice geografico restituito potrebbe essere di granularità LOCALITY
anche se l'indirizzo è più granulare.
Enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
SUB_PREMISE |
Sotto il risultato al livello dell'edificio, ad esempio un appartamento. |
PREMISE |
Risultato a livello di edificio. |
PREMISE_PROXIMITY |
Un codice geografico che indica in modo approssimativo la posizione dell'indirizzo a livello dell'edificio. |
BLOCK |
L'indirizzo o il codice geografico indica un blocco. Utilizzata solo nelle regioni con indirizzi a livello di blocco, come il Giappone. |
ROUTE |
Il codice geografico o l'indirizzo è granulare per il percorso, ad esempio una strada, una strada o un'autostrada. |
OTHER |
Tutte le altre granularità, che vengono raggruppate insieme in quanto non possono essere fornite. |