Address Validation (beta)

AddressValidation class

google.maps.addressValidation.AddressValidation classe

Classe statica per accedere alle API Address Validation.

Accesso chiamando il numero const {AddressValidation} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
fetchAddressValidation
fetchAddressValidation(request)
Parametri: 
Valore restituito:  Promise<AddressValidation>
Convalida un indirizzo. Consulta la pagina https://developers.google.com/maps/documentation/javascript/address-validation/validate-address.
address
Tipo:  Address optional
Informazioni sull'indirizzo stesso anziché sul geocodice.
geocode
Tipo:  Geocode optional
Informazioni sulla posizione e sul luogo a cui è stato geocodificato l'indirizzo.
metadata
Tipo:  AddressMetadata optional
Altre informazioni pertinenti per la recapitabilità. Non è garantito che metadata venga compilato completamente per ogni indirizzo inviato all'API Address Validation.
responseId
Tipo:  string optional
L'UUID che identifica questa risposta. Se l'indirizzo deve essere nuovamente convalidato, questo UUID deve accompagnare la nuova richiesta.
uspsData
Tipo:  USPSData optional
Flag di recapitabilità aggiuntivi forniti da USPS. Fornito solo nelle regioni US e PR.
verdict
Tipo:  Verdict optional
Flag relativi all'esito complessivo
toJSON
toJSON()
Parametri: nessuno
Valore restituito:  Object
Converte la classe AddressValidation in un oggetto JSON con le stesse proprietà.

Interfaccia AddressValidationRequest

google.maps.addressValidation.AddressValidationRequest interfaccia

Richiedi l'interfaccia per AddressValidation.fetchAddressValidation.
address
L'indirizzo in fase di convalida. Gli indirizzi non formattati devono essere inviati tramite PostalAddress.addressLines.
placeAutocompleteElement optional
Tipo:  PlaceAutocompleteElement optional
Se utilizzi un elemento PlaceAutocompleteElement, includilo qui per collegare le chiamate all'API Address Validation con il token di sessione di completamento automatico.
previousResponseId optional
Tipo:  string optional
Questo campo non deve essere impostato 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 nuovamente convalidate), ogni richiesta di follow-up deve compilare questo campo con il valore AddressValidation.responseId della prima risposta nella sequenza di convalida.
sessionToken optional
Tipo:  AutocompleteSessionToken optional
Un token che identifica una sessione Autocomplete ai fini della fatturazione.
uspsCASSEnabled optional
Tipo:  boolean optional
Attiva la modalità compatibile con USPS CASS. Questo influisce solo sul campo AddressValidation.uspsData di AddressValidation. Nota: per le richieste abilitate USPS CASS per indirizzi a Portorico, è necessario fornire un PostalAddress.regionCode del address come "PR" oppure un PostalAddress.administrativeArea del address come "Puerto Rico" (senza distinzione tra maiuscole e minuscole) o "PR".

Address class

google.maps.addressValidation.Address classe

Dettagli dell'indirizzo post-elaborato. Il post-processing include la correzione delle parti errate dell'indirizzo, la sostituzione delle parti errate e l'inferenza delle parti mancanti.

Accesso chiamando il numero const {Address} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
components
I singoli componenti dell'indirizzo formattato e corretto, insieme alle informazioni di convalida. Fornisce informazioni sullo stato di convalida dei singoli componenti.
formattedAddress
Tipo:  string optional
L'indirizzo post-elaborato, formattato come indirizzo su una sola riga seguendo le regole di formattazione dell'indirizzo della regione in cui si trova.
missingComponentTypes
Tipo:  Array<string>
I tipi di componenti che si prevedeva fossero presenti in un indirizzo postale formattato correttamente, ma che non sono stati trovati nell'input E non è stato possibile dedurli. I componenti di questo tipo non sono presenti in formatted_address, postal_address o address_components. Un esempio potrebbe essere ['street_number', 'route'] per un input come "Boulder, Colorado, 80301, USA". L'elenco dei tipi possibili è disponibile qui.
postalAddress
Tipo:  PostalAddress optional
L'indirizzo post-elaborato rappresentato come indirizzo postale.
unconfirmedComponentTypes
Tipo:  Array<string>
I tipi di componenti presenti in address_components, ma per i quali non è stato possibile confermare la correttezza. Questo campo viene fornito per comodità: il suo contenuto equivale a scorrere address_components per trovare i tipi di tutti i componenti in cui AddressComponent.confirmationLevel non è ConfirmationLevel.CONFIRMED o il flag AddressComponent.inferred non è impostato su true. L'elenco dei tipi possibili è disponibile qui.
unresolvedTokens
Tipo:  Array<string>
Eventuali token nell'input che non è stato possibile risolvere. Potrebbe trattarsi di un input non 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 ["123235253253"], in quanto non sembra un numero civico valido.

Classe AddressComponent

google.maps.addressValidation.AddressComponent classe

Rappresenta un singolo componente di un indirizzo (ad es. nome della via, città).

Accesso chiamando il numero const {AddressComponent} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
componentName
Tipo:  string optional
Il testo del nome del componente. Ad esempio, "5th Avenue" per il nome di una via o "1253" per un numero civico.
componentNameLanguageCode
Tipo:  string optional
Il codice lingua BCP-47. Questo elemento non sarà presente se il nome del componente non è associato a una lingua, ad esempio un numero civico.
componentType
Tipo:  string optional
Il tipo di componente dell'indirizzo. Consulta la tabella 2: tipi aggiuntivi restituiti dal servizio Places per un elenco dei tipi possibili.
confirmationLevel
Tipo:  ConfirmationLevel optional
Indica il livello di certezza che il componente sia corretto.
inferred
Tipo:  boolean
Se è true, questo componente non faceva parte dell'input, ma è stato dedotto per la posizione dell'indirizzo. L'inclusione di questo componente è consigliata per un indirizzo completo.
replaced
Tipo:  boolean
Indica che il nome del componente è stato sostituito con uno completamente diverso. Ad esempio, sostituendo un codice postale errato con uno corretto per l'indirizzo. Non si tratta di una modifica estetica, il componente di input è stato sostituito con un altro.
spellCorrected
Tipo:  boolean
Indica una correzione di un errore ortografico nel nome del componente. L'API non sempre segnala le modifiche da una variante ortografica all'altra, ad esempio da "centre" a "center".
unexpected
Tipo:  boolean
Se impostato su vero, questo componente non deve essere presente in un indirizzo postale per la regione specificata. È stato conservato solo perché faceva parte dell'input.

AddressMetadata class

google.maps.addressValidation.AddressMetadata classe

I metadati dell'indirizzo. Non è garantito che AddressMetadata venga compilato completamente per ogni indirizzo inviato all'API Address Validation.

Accesso chiamando il numero const {AddressMetadata} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
business
Tipo:  boolean
poBox
Tipo:  boolean
residential
Tipo:  boolean

Costanti ConfirmationLevel

google.maps.addressValidation.ConfirmationLevel costanti

I diversi valori possibili che indicano il livello di certezza che il componente sia corretto.

Accesso chiamando il numero const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
CONFIRMED
UNCONFIRMED_AND_SUSPICIOUS
UNCONFIRMED_BUT_PLAUSIBLE

Classe Geocode

google.maps.addressValidation.Geocode classe

Contiene informazioni sul luogo a cui è stato geocodificato l'input.

Accesso chiamando il numero const {Geocode} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
bounds
Tipo:  LatLngBounds optional
I limiti del luogo geocodificato.
featureSizeMeters
Tipo:  number optional
Le dimensioni del luogo geocodificato, in metri. Si tratta di un'altra misura della grossolanità della posizione geocodificata, ma in termini di dimensioni fisiche anziché di significato semantico.
location
Tipo:  LatLngAltitude optional
La posizione geocodificata dell'input.
placeId
Tipo:  string optional
L'ID luogo del luogo geocodificato. L'utilizzo di Place è preferibile rispetto a indirizzi, coordinate di latitudine/longitudine o plus code. L'utilizzo delle coordinate per il calcolo del percorso o delle indicazioni stradali comporterà sempre l'allineamento del punto alla strada più vicina a quelle coordinate. Potrebbe non essere una strada che conduce rapidamente o in sicurezza alla destinazione e potrebbe non trovarsi vicino a un punto di accesso alla proprietà. Inoltre, quando una località viene sottoposta a geocodifica inversa, non è garantito che l'indirizzo restituito corrisponda a quello originale.
placeTypes
Tipo:  Array<string>
Il tipo o i tipi di luogo a cui è stato geocodificato l'input. Ad esempio, ['locality', 'political']. L'elenco completo dei tipi è disponibile nella documentazione dell'API Geocoding.
plusCode
Tipo:  PlusCode optional
Il Plus Code corrispondente a location.
fetchPlace
fetchPlace()
Parametri: nessuno
Valore restituito:nessuno
Restituisce una rappresentazione di questo Geocode. Per ottenere i dettagli completi del luogo, è necessario effettuare una chiamata a place.fetchFields().

Costanti di granularità

google.maps.addressValidation.Granularity costanti

Le varie granularità che possono avere un indirizzo o un geocodice. Se utilizzati per indicare la granularità di un indirizzo, questi valori indicano con quale granularità l'indirizzo identifica una destinazione di spedizione. Ad esempio, un indirizzo come "123 Main Street, Redwood City, CA, 94061" identifica un PREMISE, mentre un indirizzo come "Redwood City, CA, 94061" identifica una LOCALITY. Tuttavia, se non riusciamo a trovare un geocodice per "123 Main Street" a Redwood City, il geocodice restituito potrebbe avere una granularità di LOCALITY anche se l'indirizzo è più granulare.

Accesso chiamando il numero const {Granularity} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
BLOCK L'indirizzo o il geocodice indica un isolato. Utilizzato solo nelle regioni con indirizzamento a livello di blocco, ad esempio il Giappone.
OTHER Tutte le altre granularità, raggruppate insieme perché non sono pubblicabili.
PREMISE Risultato a livello di edificio.
PREMISE_PROXIMITY Un geocodice che approssima la posizione a livello di edificio dell'indirizzo.
ROUTE Il geocodice o l'indirizzo è granulare per il percorso, ad esempio una via, una strada o un'autostrada.
SUB_PREMISE Risultato a livello inferiore dell'edificio, ad esempio un appartamento.

Costanti PossibleNextAction

google.maps.addressValidation.PossibleNextAction costanti

Offre un riepilogo interpretativo della risposta dell'API, con lo scopo di aiutare a determinare una potenziale azione successiva da intraprendere. Questo campo deriva da altri campi nella risposta dell'API e non deve essere considerato una garanzia di accuratezza o recapitabilità dell'indirizzo.

Accesso chiamando il numero const {PossibleNextAction} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
ACCEPT La risposta API non contiene indicatori che giustifichino uno degli altri valori di PossibleNextAction. Potresti prendere in considerazione l'utilizzo dell'indirizzo post-elaborato senza ulteriori richieste al cliente, anche se ciò non garantisce la validità dell'indirizzo, che potrebbe comunque contenere correzioni. È tua responsabilità determinare se e come richiedere al cliente di eseguire la verifica, a seconda della tua valutazione del rischio.
CONFIRM Uno o più campi della risposta dell'API indicano potenziali problemi minori con l'indirizzo post-elaborato, ad esempio il componente dell'indirizzo postal_code era replaced. Chiedere al cliente di rivedere l'indirizzo potrebbe contribuire a migliorarne la qualità.
CONFIRM_ADD_SUBPREMISES La risposta dell'API indica che l'indirizzo post-elaborato potrebbe non includere un'unità secondaria. Se chiedi al cliente di rivedere l'indirizzo e di valutare l'aggiunta di un numero di unità, puoi contribuire a migliorare la qualità dell'indirizzo. L'indirizzo post-elaborato potrebbe presentare anche altri problemi minori. Nota: questo valore enum può essere restituito solo per gli indirizzi statunitensi.
FIX Uno o più campi della risposta dell'API indicano un potenziale problema con l'indirizzo post-elaborato, ad esempio verdict.validation_granularity è OTHER. Chiedere al cliente di modificare l'indirizzo potrebbe contribuire a migliorarne la qualità.

USPSAddress class

google.maps.addressValidation.USPSAddress classe

Rappresentazione di un indirizzo statunitense da parte del servizio postale statunitense.

Accesso chiamando il numero const {USPSAddress} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
city
Tipo:  string optional
Il nome della città.
cityStateZipAddressLine
Tipo:  string optional
La riga dell'indirizzo contenente la città, lo stato e il codice postale.
firm
Tipo:  string optional
Il nome dello studio.
firstAddressLine
Tipo:  string optional
La prima riga dell'indirizzo.
secondAddressLine
Tipo:  string optional
La seconda riga dell'indirizzo.
state
Tipo:  string optional
Il codice stato di due lettere.
urbanization
Tipo:  string optional
Il nome dell'urbanizzazione portoricana.
zipCode
Tipo:  string optional
Il codice postale, ad es. "10009".
zipCodeExtension
Tipo:  string optional
L'estensione del codice postale di 4 cifre, ad es. "5023".

USPSData class

google.maps.addressValidation.USPSData classe

I dati USPS per l'indirizzo. Non è garantito che USPSData venga compilato completamente per ogni indirizzo di Stati Uniti o Porto Rico inviato all'API Address Validation. Se utilizzi uspsData come parte principale della risposta, ti consigliamo di integrare i campi dell'indirizzo di backup nella risposta.

Accesso chiamando il numero const {USPSData} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
abbreviatedCity
Tipo:  string optional
Città abbreviata.
addressRecordType
Tipo:  string optional
Tipo di record di indirizzo che corrisponde all'indirizzo inserito.
carrierRoute
Tipo:  string optional
Il codice itinerario del corriere. Un codice di quattro caratteri composto da un prefisso di una lettera e un identificatore di percorso di tre cifre.
carrierRouteIndicator
Tipo:  string optional
Indicatore di ordinamento della tariffa dell'itinerario del corriere.
cassProcessed
Tipo:  boolean
Indicatore che la richiesta è stata elaborata da CASS.
county
Tipo:  string optional
Nome della contea.
deliveryPointCheckDigit
Tipo:  string optional
La cifra di controllo del punto di consegna. Questo numero viene aggiunto alla fine del codice a barre del punto di consegna per la posta scansionata meccanicamente. La somma di tutte le cifre di delivery_point_barcode, delivery_point_check_digit, postal code e ZIP+4 deve dare un numero divisibile per 10.
deliveryPointCode
Tipo:  string optional
Il codice punto di consegna di 2 cifre.
dpvCMRA
Tipo:  string optional
Indica se l'indirizzo è un CMRA (Commercial Mail Receiving Agency), ovvero un'attività privata che riceve posta per i clienti. Restituisce un singolo carattere.
dpvConfirmation
Tipo:  string optional
I valori possibili per la conferma del DPV. Restituisce un singolo carattere o nessun valore.
dpvDoorNotAccessible
Tipo:  string optional
Il flag indica gli indirizzi in cui il servizio postale statunitense non può bussare alla porta per consegnare la posta. Restituisce un singolo carattere.
dpvDrop
Tipo:  string optional
Il flag indica che la posta viene consegnata in un unico contenitore presso un sito. Restituisce un singolo carattere.
dpvEnhancedDeliveryCode
Tipo:  string optional
Indica che per l'indirizzo è valido più di un codice di ritorno DPV. Restituisce un singolo carattere.
dpvFootnote
Tipo:  string optional
Le note a piè di pagina della convalida del punto di consegna. Più note a piè di pagina possono essere unite nella stessa stringa.
dpvNonDeliveryDays
Tipo:  string optional
Il flag indica che la consegna della posta non viene eseguita tutti i giorni della settimana. Restituisce un singolo carattere.
dpvNonDeliveryDaysValues
Tipo:  number optional
Numero intero che identifica i giorni di mancata pubblicazione. Può essere interrogato utilizzando i flag di bit: 0x40 – La domenica non è un giorno di consegna 0x20 – Il lunedì non è un giorno di consegna 0x10 – Il martedì non è un giorno di consegna 0x08 – Il mercoledì non è un giorno di consegna 0x04 – Il giovedì non è un giorno di consegna 0x02 – Il venerdì non è un giorno di consegna 0x01 – Il sabato non è un giorno di consegna
dpvNoSecureLocation
Tipo:  string optional
La bandiera indica che la porta è accessibile, ma il pacco non verrà lasciato a causa di problemi di sicurezza. Restituisce un singolo carattere.
dpvNoStat
Tipo:  string optional
Indica se l'indirizzo è un indirizzo senza statistiche o un indirizzo attivo. Gli indirizzi non statistici sono quelli non occupati in modo continuativo o quelli non serviti dal servizio postale statunitense. Restituisce un singolo carattere.
dpvNoStatReasonCode
Tipo:  number optional
Indica il tipo di NoStat. Restituisce un codice motivo come numero intero.
dpvPBSA
Tipo:  string optional
Indica che l'indirizzo corrisponde al record PBSA. Restituisce un singolo carattere.
dpvThrowback
Tipo:  string optional
Indica che la posta non viene consegnata all'indirizzo. Restituisce un singolo carattere.
dpvVacant
Tipo:  string optional
Indica se l'indirizzo è mancante. Restituisce un singolo carattere.
elotFlag
Tipo:  string optional
Flag eLOT crescente/decrescente (A/D).
elotNumber
Tipo:  string optional
Numero Enhanced Line of Travel (eLOT).
errorMessage
Tipo:  string optional
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.
fipsCountyCode
Tipo:  string optional
Codice FIPS della contea.
hasDefaultAddress
Tipo:  boolean
Indicatore che è stato trovato un indirizzo predefinito, ma esistono indirizzi più specifici.
hasNoEWSMatch
Tipo:  boolean
L'indirizzo di consegna è abbinabile, ma il file EWS indica che a breve sarà disponibile una corrispondenza esatta.
lacsLinkIndicator
Tipo:  string optional
Indicatore LACSLink.
lacsLinkReturnCode
Tipo:  string optional
Codice di reso LACSLink.
pmbDesignator
Tipo:  string optional
Indicatore di unità PMB (Private Mail Box).
pmbNumber
Tipo:  string optional
Numero PMB (Private Mail Box).
poBoxOnlyPostalCode
Tipo:  boolean
Codice postale solo per casella postale.
postOfficeCity
Tipo:  string optional
Città dell'ufficio postale principale.
postOfficeState
Tipo:  string optional
Stato dell'ufficio postale principale.
standardizedAddress
Tipo:  USPSAddress optional
Indirizzo standardizzato USPS.
suiteLinkFootnote
Tipo:  string optional
Note a piè di pagina derivanti dalla corrispondenza di un record di una strada o di un grattacielo con le informazioni sulla suite. Se viene trovata una corrispondenza con il nome dell'attività, viene restituito il numero secondario.

Verdict class

google.maps.addressValidation.Verdict classe

Rappresenta l'indirizzo post-elaborato per l'indirizzo fornito.

Accesso chiamando il numero const {Verdict} = await google.maps.importLibrary("addressValidation").
Consulta Librerie nell'API Maps JavaScript.
addressComplete
Tipo:  boolean
L'indirizzo è considerato completo se non sono presenti token irrisolti e se non mancano componenti dell'indirizzo imprevisti. Se non è impostato, indica che il valore è false. Per maggiori dettagli, consulta i campi Address.missingComponentTypes, Address.unresolvedTokens o AddressComponent.unexpected.
geocodeGranularity
Tipo:  Granularity optional
Informazioni sulla granularità di Geocode. Può essere inteso come il significato semantico della precisione della posizione geocodificata.
hasInferredComponents
Tipo:  boolean
È stato dedotto (ovvero aggiunto) almeno un componente dell'indirizzo che non era presente nell'input. Per maggiori dettagli, consulta AddressComponent.
hasReplacedComponents
Tipo:  boolean optional
Almeno un componente dell'indirizzo è stato sostituito. Per maggiori dettagli, vedi AddressComponent.
hasUnconfirmedComponents
Tipo:  boolean
Almeno un componente dell'indirizzo non può essere classificato o convalidato. Per maggiori dettagli, consulta AddressComponent.
inputGranularity
Tipo:  Granularity optional
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 validationGranularity.
possibleNextAction
Tipo:  PossibleNextAction optional
Una possibile azione successiva da intraprendere in base ad altri campi nella risposta dell'API. Per ulteriori dettagli, consulta PossibleNextAction.
validationGranularity
Tipo:  Granularity optional
Il livello di granularità a cui l'API può convalidare completamente l'indirizzo. Ad esempio, un validationGranularity di PREMISE indica che tutti i componenti dell'indirizzo a livello di PREMISE e superiori possono essere convalidati.