Method: validateAddress

Convalida un indirizzo.

Richiesta HTTP

POST https://addressvalidation.googleapis.com/v1:validateAddress

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "address": {
    object (PostalAddress)
  },
  "previousResponseId": string,
  "enableUspsCass": boolean,
  "languageOptions": {
    object (LanguageOptions)
  },
  "sessionToken": string
}
Campi
address

object (PostalAddress)

Obbligatorio. L'indirizzo in fase di convalida. Gli indirizzi non formattati devono essere inviati tramite addressLines.

La lunghezza totale dei campi in questo input non deve superare i 280 caratteri.

Le regioni supportate sono disponibili qui.

Il valore languageCode nell'indirizzo di input è riservato per usi futuri e al momento viene ignorato. Il risultato dell'indirizzo convalidato verrà compilato in base alla lingua preferita per l'indirizzo specificato, come identificato dal sistema.

L'API Address Validation ignora i valori in recipients e organization. Eventuali valori in questi campi verranno ignorati e non restituiti. Non impostarle.
previousResponseId

string

Questo campo deve essere vuoto per la prima richiesta di convalida dell'indirizzo. Se sono necessarie altre richieste per convalidare completamente un singolo indirizzo (ad esempio se le modifiche apportate dall'utente dopo la convalida iniziale devono essere convalidate di nuovo), ogni richiesta di follow-up deve compilare questo campo con il valore responseId della prima risposta nella sequenza di convalida.
enableUspsCass

boolean

Attiva la modalità compatibile con USPS CASS. Questo riguarda solo il campo google.maps.addressvalidation.v1.ValidationResult.usps_data di google.maps.addressvalidation.v1.ValidationResult. Nota: per le richieste con attivazione CASS USPS per gli indirizzi a Portorico, è necessario fornire un google.type.PostalAddress.region_code del address come "PR" oppure un google.type.PostalAddress.administrative_area del address come "Puerto Rico" (senza distinzione tra maiuscole e minuscole) o "PR".

Ti consigliamo di utilizzare un address componentizzato oppure, in alternativa, di specificare almeno due address in cui la prima riga contenga il numero civico e il nome della via e la seconda riga contenga la città, lo stato e il codice postale.google.type.PostalAddress.address_lines
languageOptions

object (LanguageOptions)

Facoltativo. Anteprima: questa funzionalità è in anteprima (pre-release). 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 specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Consente all'API di convalida degli indirizzi di includere ulteriori informazioni nella risposta.
sessionToken

string

Facoltativo. Una stringa che identifica una sessione Autocomplete a fini di fatturazione. Deve essere una stringa base64 sicura per URL e nomi file con una lunghezza massima di 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT.

La sessione inizia quando l'utente effettua una query di completamento automatico e termina 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 di dettagli sui luoghi o di convalida dell'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 nuovo token per ogni sessione. Se il parametro sessionToken viene omesso o se riutilizzi un token sessione, la sessione viene addebitata come se non fosse stato fornito alcun token sessione (ogni richiesta viene fatturata separatamente).

Nota: Address Validation può essere utilizzata solo nelle sessioni con l'API Autocomplete (nuova), non con l'API Autocomplete. Per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/session-pricing.

Corpo della risposta

La risposta a una richiesta di convalida dell'indirizzo.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "result": {
    object (ValidationResult)
  },
  "responseId": string
}
Campi
result

object (ValidationResult)

Il risultato della convalida dell'indirizzo.
responseId

string

L'UUID che identifica questa risposta. Se l'indirizzo deve essere convalidato di nuovo, questo UUID deve accompagnare la nuova richiesta.

PostalAddress

Rappresenta un indirizzo postale (ad esempio per la consegna postale o gli indirizzi di pagamento). Dato un indirizzo postale, un servizio postale può consegnare gli articoli in un immobile, in una casella postale o in un indirizzo simile. Non è destinato a modellare località geografiche (strade, città, montagne).

In un utilizzo tipico, un indirizzo viene creato dall'input dell'utente o dall'importazione di dati esistenti, a seconda del tipo di processo.

Suggerimenti per l'inserimento o la modifica dell'indirizzo: - Utilizza un widget di indirizzo pronto per l'internazionalizzazione, ad esempio https://github.com/google/libaddressinput. - Agli utenti non devono essere mostrati elementi dell'interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui vengono utilizzati.

Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina https://support.google.com/business/answer/6397478.

Rappresentazione JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Campi
revision

integer

La revisione dello schema di PostalAddress. Qualsiasi valore diverso da 0 causerà l'errore INVALID_ARGUMENT dell'API.
regionCode

string

Facoltativo. Codice regione CLDR del paese/della regione dell'indirizzo. Per maggiori dettagli, visita le pagine https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. Se il codice regione non viene fornito, verrà dedotto dall'indirizzo. Per ottenere il massimo rendimento, ti consigliamo di includere il codice regione, se lo conosci. La presenza di regioni incoerenti o ripetute può comportare un rendimento scadente. Ad esempio, se addressLines include già la regione, non fornire di nuovo il codice regione in questo campo. Le regioni supportate sono riportate nelle Domande frequenti.
languageCode

string

Il codice lingua nell'indirizzo di input è riservato per usi futuri e al momento viene ignorato. L'API restituisce l'indirizzo nella lingua appropriata per la località in cui si trova.
postalCode

string

Facoltativo. Il codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma dove vengono utilizzati, possono attivare una convalida aggiuntiva con altre parti dell'indirizzo (ad esempio, la convalida dello stato o del codice postale negli Stati Uniti).
sortingCode

string

Facoltativo. Codice di ordinamento aggiuntivo specifico per paese. Questo formato non viene utilizzato nella maggior parte delle regioni. Se viene utilizzato, il valore è una stringa come "CEDEX", eventualmente seguita da un numero (ad esempio "CEDEX 7") o solo un numero, che rappresenta il "codice settore" (Giamaica), l'"indicatore dell'area di consegna" (Malawi) o l'"indicatore dell'ufficio postale" (Costa d'Avorio).
administrativeArea

string

Facoltativo. Suddivisione amministrativa di grado più alto usata per l'indirizzo postale di un paese o di un'area geografica. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. Per la Spagna, si tratta della provincia e non della comunità autonoma (ad esempio, "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad esempio, in Svizzera, questo campo deve essere lasciato vuoto.
locality

string

Facoltativo. Solitamente si riferisce alla porzione di città dell'indirizzo. Esempi: "city" per gli Stati Uniti, "comune" in Italia, "post town" nel Regno Unito. Lì dove le località non sono ben definite o non rientrano nella struttura, lascia locality vuoto e usa addressLines.
sublocality

string

Facoltativo. Quartiere dell'indirizzo. Ad esempio, può trattarsi di un quartiere, un comune o un distretto.
addressLines[]

string

Obbligatorio. Righe dell'indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo.

Poiché i valori in addressLines non hanno informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad es. "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe dell'indirizzo deve essere "ordine busta" per il paese o la regione dell'indirizzo.

La rappresentazione strutturale minima consentita di un indirizzo è costituita da tutte le informazioni inserite in addressLines. Se non viene fornito un valore regionCode, la regione viene dedotta dalle righe dell'indirizzo.

La creazione di un indirizzo contenente solo addressLines e il relativo geocodificamento sono il modo consigliato per gestire gli indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative).
recipients[]

string

Evita di impostare questo campo. Al momento l'API Address Validation non la utilizza. Anche se al momento l'API non rifiuta le richieste con questo campo impostato, le informazioni verranno ignorate e non verranno restituite nella risposta.
organization

string

Evita di impostare questo campo. Al momento l'API Address Validation non la utilizza. Anche se al momento l'API non rifiuta le richieste con questo campo impostato, le informazioni verranno ignorate e non verranno restituite nella risposta.

LanguageOptions

Anteprima: questa funzionalità è in anteprima (pre-release). 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 specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Consente all'API di convalida degli indirizzi di includere ulteriori informazioni nella risposta.

Rappresentazione JSON 
{
  "returnEnglishLatinAddress": boolean
}
Campi
returnEnglishLatinAddress

boolean

Anteprima: restituisci un google.maps.addressvalidation.v1.Address in inglese. Per maggiori dettagli, visita la pagina google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

ValidationResult

Il risultato della convalida di un indirizzo.

Rappresentazione JSON 
{
  "verdict": {
    object (Verdict)
  },
  "address": {
    object (Address)
  },
  "geocode": {
    object (Geocode)
  },
  "metadata": {
    object (AddressMetadata)
  },
  "uspsData": {
    object (UspsData)
  },
  "englishLatinAddress": {
    object (Address)
  }
}
Campi
verdict

object (Verdict)

Flag relativi all'esito complessivo
address

object (Address)

Informazioni sull'indirizzo stesso, al contrario del codice geografico.
geocode

object (Geocode)

Informazioni sulla posizione e sul luogo a cui è stato geocodificato l'indirizzo.
metadata

object (AddressMetadata)

Altre informazioni pertinenti alla recapitabilità. Non è garantito che metadata sia completamente compilato per ogni indirizzo inviato all'API Address Validation.
uspsData

object (UspsData)

Flag di recapito aggiuntivi forniti da USPS. Fornito solo nelle regioni US e PR.
englishLatinAddress

object (Address)

Anteprima: questa funzionalità è in anteprima (pre-release). 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 specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

L'indirizzo 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 negare la convalida dell'indirizzo fornito in origine.

Se parte dell'indirizzo non ha una traduzione in inglese, il servizio la restituisce in una lingua alternativa che utilizza uno script latino. Fai clic qui per una spiegazione di come viene selezionata la lingua alternativa. Se parte dell'indirizzo non ha traduzioni o traslitterazioni in una lingua che utilizza caratteri latini, il servizio restituisce quella parte nella lingua locale associata all'indirizzo.

Attiva questo output utilizzando il flag google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Nota: i campi google.maps.addressvalidation.v1.Address.unconfirmed_component_types in englishLatinAddress e google.maps.addressvalidation.v1.AddressComponent.confirmation_level in englishLatinAddress.address_components non sono compilati.

Verdetto

Panoramica generale del risultato della convalida dell'indirizzo e del codice geografico.

Rappresentazione JSON 
{
  "inputGranularity": enum (Granularity),
  "validationGranularity": enum (Granularity),
  "geocodeGranularity": enum (Granularity),
  "addressComplete": boolean,
  "hasUnconfirmedComponents": boolean,
  "hasInferredComponents": boolean,
  "hasReplacedComponents": boolean
}
Campi
inputGranularity

enum (Granularity)

La granularità dell'indirizzo di input. Questo è il risultato dell'analisi dell'indirizzo inserito e non fornisce alcun indicatore di convalida. Per gli indicatori di convalida, consulta validationGranularity di seguito.

Ad esempio, se l'indirizzo inserito include un numero di appartamento specifico, inputGranularity qui sarà SUB_PREMISE. Se non riusciamo a trovare una corrispondenza per il numero dell'appartamento nei database o se il numero non è valido, è probabile che il valore di validationGranularity sia PREMISE o peggiore.
validationGranularity

enum (Granularity)

Il livello di granularità fino al quale l'API può convalidare l'indirizzo. Ad esempio, un valore validationGranularity pari a PREMISE indica che tutti i componenti dell'indirizzo a livello di PREMISE o più approssimativo possono essere convalidati.

Il risultato della convalida dei componenti dell'indirizzo è disponibile in google.maps.addressvalidation.v1.Address.address_components.
geocodeGranularity

enum (Granularity)

Informazioni sulla granularità del geocode. Questo può essere inteso come il significato semantico della granularità della posizione geocodificata.

A volte può essere diverso dal validationGranularity riportato sopra. Ad esempio, il nostro database potrebbe registrare l'esistenza di un numero di appartamento, ma non avere una posizione precisa dell'appartamento all'interno di un grande complesso residenziale. In questo caso, validationGranularity sarà SUB_PREMISE, ma geocodeGranularity sarà PREMISE.
addressComplete

boolean

L'indirizzo è considerato completo se non sono presenti token non risolti e non sono presenti componenti dell'indirizzo inaspettati o mancanti. Se non impostato, indica che il valore è false. Per maggiori dettagli, consulta i campi missingComponentTypes, unresolvedTokens o unexpected.
hasUnconfirmedComponents

boolean

Almeno un componente dell'indirizzo non può essere classificato o convalidato. Per maggiori dettagli, consulta google.maps.addressvalidation.v1.Address.address_components.
hasInferredComponents

boolean

È stato dedotto (aggiunto) almeno un componente dell'indirizzo che non era presente nell'input. Per maggiori dettagli, consulta google.maps.addressvalidation.v1.Address.address_components.
hasReplacedComponents

boolean

È stato sostituito almeno un componente dell'indirizzo. Per maggiori dettagli, vedi google.maps.addressvalidation.v1.Address.address_components.

Granularità

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

Enum
GRANULARITY_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
SUB_PREMISE Risultato al di sotto del livello dell'edificio, ad esempio un appartamento.
PREMISE Risultato a livello di edificio.
PREMISE_PROXIMITY Un codice geografico che approssima la posizione dell'indirizzo a livello di edificio.
BLOCK L'indirizzo o il codice geografico indica un blocco. Utilizzato solo nelle regioni con indirizzi a livello di blocco, come il Giappone.
ROUTE Il codice geografico o l'indirizzo è granulare per percorso, ad esempio una strada, una via o un'autostrada.
OTHER Tutte le altre granularità, raggruppate insieme perché non possono essere pubblicate.

Indirizzo

Dettagli dell'indirizzo sottoposto a post-elaborazione. Il post-processing include la correzione delle parti dell'indirizzo con errori ortografici, la sostituzione delle parti errate e l'inferenza delle parti mancanti.

Rappresentazione JSON 
{
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "missingComponentTypes": [
    string
  ],
  "unconfirmedComponentTypes": [
    string
  ],
  "unresolvedTokens": [
    string
  ]
}
Campi
formattedAddress

string

L'indirizzo post-elaborato, formattato come indirizzo di una sola riga in base alle regole di formattazione degli indirizzi della regione in cui si trova.

Nota: il formato di questo indirizzo potrebbe non corrispondere a quello dell'indirizzo nel campo postalAddress. Ad esempio, postalAddress rappresenta sempre il paese come regionCode di due lettere, ad esempio "US" o "NZ". Al contrario, questo campo utilizza una forma più lunga del nome del paese, ad esempio "Stati Uniti" o "Nuova Zelanda".
postalAddress

object (PostalAddress)

L'indirizzo post-elaborato rappresentato come indirizzo postale.
addressComponents[]

object (AddressComponent)

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 determinato modo. Non fare supposizioni sull'ordine dei componenti dell'indirizzo nell'elenco.
missingComponentTypes[]

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 che non è stato possibile dedurre. Un esempio potrebbe essere ['street_number', 'route'] per un input come "Boulder, Colorado, 80301, USA". L'elenco dei possibili tipi è disponibile qui.

Nota: potresti visualizzare un tipo di componente mancante quando ritieni di averlo già fornito. Ad esempio, questo può accadere quando l'indirizzo inserito contiene il nome dell'edificio, ma non il numero civico. Nell'indirizzo "渋谷区渋谷３丁目　Shibuya Stream", il nome dell'edificio "Shibuya Stream" ha il tipo di componente premise, ma manca il numero della struttura, pertanto missingComponentTypes conterrà premise.
unconfirmedComponentTypes[]

string

I tipi di componenti presenti in addressComponents, ma di cui non è stato possibile confermare la correttezza. Questo campo viene fornito per praticità: i relativi contenuti sono equivalenti all'iterazione di addressComponents per trovare i tipi di tutti i componenti in cui confirmationLevel non è CONFIRMED o il flag inferred non è impostato su true. L'elenco dei possibili tipi è disponibile qui.
unresolvedTokens[]

string

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, per un input come "Lotto 0000123123 e 0000456456 Str # Guthrie Center IA 50115 US", i token non risolti potrebbero avere il seguente aspetto: ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

Rappresenta un componente dell'indirizzo, ad esempio una strada, una città o uno stato.

Rappresentazione JSON 
{
  "componentName": {
    object (ComponentName)
  },
  "componentType": string,
  "confirmationLevel": enum (ConfirmationLevel),
  "inferred": boolean,
  "spellCorrected": boolean,
  "replaced": boolean,
  "unexpected": boolean
}
Campi
componentName

object (ComponentName)

Il nome di questo componente.
componentType

string

Il tipo di componente dell'indirizzo. Consulta la Tabella 2: tipi aggiuntivi restituiti dal servizio Luoghi per un elenco dei possibili tipi.
confirmationLevel

enum (ConfirmationLevel)

Indica il livello di certezza che abbiamo sulla correttezza del componente.
inferred

boolean

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.
spellCorrected

boolean

Indica la correzione di un errore ortografico nel nome del componente. L'API non segnala sempre le modifiche da una variante ortografica all'altra, ad esempio quando si passa da "centre" a "center". Inoltre, non segnala sempre gli errori ortografici comuni, ad esempio quando si modifica "Amphitheater Pkwy" in "Amphitheatre Pkwy".
replaced

boolean

Indica che il nome del componente è stato sostituito con uno completamente diverso, ad esempio un codice postale errato sostituito con quello corretto per l'indirizzo. Non si tratta di una modifica estetica, il componente di input è stato sostituito con un altro.
unexpected

boolean

Indica un componente dell'indirizzo che non dovrebbe essere presente in un indirizzo postale per la regione specificata. L'abbiamo mantenuto solo perché faceva parte dell'input.

ComponentName

Un wrapper per il nome del componente.

Rappresentazione JSON 
{
  "text": string,
  "languageCode": string
}
Campi
text

string

Il testo del nome. Ad esempio, "5th Avenue" per il nome di una via o "1253" per il numero civico.
languageCode

string

Il codice lingua BCP-47. Questo valore non sarà presente se il nome del componente non è associato a una lingua, ad esempio un numero civico.

ConfirmationLevel

I diversi valori possibili per i livelli di conferma.

Enum
CONFIRMATION_LEVEL_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
CONFIRMED Siamo riusciti a verificare che questo componente esiste e ha 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 di numeri validi noto in una strada 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.

Geocodice

Contiene informazioni sul luogo a cui è stato eseguito il geocodifica dell'input.

Rappresentazione JSON 
{
  "location": {
    object (LatLng)
  },
  "plusCode": {
    object (PlusCode)
  },
  "bounds": {
    object (Viewport)
  },
  "featureSizeMeters": number,
  "placeId": string,
  "placeTypes": [
    string
  ]
}
Campi
location

object (LatLng)

La posizione geocodificata dell'input.

L'utilizzo degli ID luogo è preferibile all'utilizzo di indirizzi, coordinate di latitudine/longitudine o plus code. L'utilizzo delle coordinate durante la creazione di percorsi o il calcolo delle indicazioni stradali comporterà sempre l'aggancio del punto alla strada più vicina a queste coordinate. Potrebbe non essere una strada che porta alla destinazione in modo rapido o sicuro e potrebbe non trovarsi nelle vicinanze di un punto di accesso alla proprietà. Inoltre, quando una posizione viene geocodificata in modo inverso, non è garantito che l'indirizzo restituito corrisponda all'originale.
plusCode

object (PlusCode)

Il Plus Code corrispondente a location.
bounds

object (Viewport)

I limiti del luogo geocodificato.
featureSizeMeters

number

Le dimensioni del luogo geocodificato, in metri. Si tratta di un'altra misura della approssimazione della posizione geocodificata, ma in termini di dimensioni fisiche anziché di significato semantico.
placeId

string

Il PlaceID del luogo a cui viene eseguito il geocoding di questo input.

Per ulteriori informazioni sugli ID luogo, fai clic qui.
placeTypes[]

string

I tipi di luoghi a cui è stato geocodificato l'input. Ad esempio, ['locality', 'political']. L'elenco completo dei tipi è disponibile qui.

LatLng

Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore è espresso come una coppia di numeri doppi per rappresentare i gradi di latitudine e di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare negli intervalli normalizzati.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].
longitude

number

La longitudine in gradi. Deve essere compreso nell'intervallo [-180,0; +180,0].

PlusCode

Il Plus Code (http://plus.codes) è un riferimento di posizione con due formati: il codice globale che definisce un rettangolo di 14 m x 14 m (1/8000 di grado) o più piccolo e il codice composto, che sostituisce il prefisso con una posizione di riferimento.

Rappresentazione JSON 
{
  "globalCode": string,
  "compoundCode": string
}
Campi
globalCode

string

Il codice globale (completo) del luogo, ad esempio "9FWM33GV+HQ ", che rappresenta un'area di 1/8000 gradi per 1/8000 gradi (~14 per 14 metri).
compoundCode

string

Il 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.

Area visibile

Un'area visibile di latitudine e longitudine, rappresentata da due punti low e high diagonalmente opposti. Un viewport è considerato una regione chiusa, ovvero include il suo confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi e i limiti di longitudine tra -180 e 180 gradi inclusi. Vari casi includono:

  • Se low = high, l'area visibile è costituita da quel singolo punto.

  • Se low.longitude > high.longitude, l'intervallo di longitudine è invertito (l'area visibile attraversa la linea di longitudine di 180 gradi).

  • Se low.longitude = -180 gradi e high.longitude = 180 gradi, l'area visibile include tutte le longitudini.

  • Se low.longitude = 180 gradi e high.longitude = -180 gradi, l'intervallo di longitudine è vuoto.

  • Se low.latitude > high.latitude, l'intervallo di latitudine è vuoto.

Sia low che high devono essere compilati e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un viewport vuoto comporterà un errore.

Ad esempio, questa visualizzazione inclusa racchiude completamente New York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Rappresentazione JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campi
low

object (LatLng)

Obbligatorio. Il punto più basso dell'area visibile.
high

object (LatLng)

Obbligatorio. Il punto più alto dell'area visibile.

AddressMetadata

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

Rappresentazione JSON 
{
  "business": boolean,
  "poBox": boolean,
  "residential": boolean
}
Campi
business

boolean

Indica che si tratta dell'indirizzo di un'attività. Se non impostato, indica che il valore è sconosciuto.
poBox

boolean

Indica l'indirizzo di una casella postale. Se non impostato, indica che il valore è sconosciuto.
residential

boolean

Indica che si tratta dell'indirizzo di una residenza. Se non impostato, indica che il valore è sconosciuto.

UspsData

I dati USPS per l'indirizzo. Non è garantito che uspsData sia completamente compilato per ogni indirizzo degli Stati Uniti o di Portorico inviato all'API Address Validation. Ti consigliamo di integrare i campi dell'indirizzo di riserva nella risposta se utilizzi uspsData come parte principale della risposta.

Rappresentazione JSON 
{
  "standardizedAddress": {
    object (UspsAddress)
  },
  "deliveryPointCode": string,
  "deliveryPointCheckDigit": string,
  "dpvConfirmation": string,
  "dpvFootnote": string,
  "dpvCmra": string,
  "dpvVacant": string,
  "dpvNoStat": string,
  "dpvNoStatReasonCode": integer,
  "dpvDrop": string,
  "dpvThrowback": string,
  "dpvNonDeliveryDays": string,
  "dpvNonDeliveryDaysValues": integer,
  "dpvNoSecureLocation": string,
  "dpvPbsa": string,
  "dpvDoorNotAccessible": string,
  "dpvEnhancedDeliveryCode": string,
  "carrierRoute": string,
  "carrierRouteIndicator": string,
  "ewsNoMatch": boolean,
  "postOfficeCity": string,
  "postOfficeState": string,
  "abbreviatedCity": string,
  "fipsCountyCode": string,
  "county": string,
  "elotNumber": string,
  "elotFlag": string,
  "lacsLinkReturnCode": string,
  "lacsLinkIndicator": string,
  "poBoxOnlyPostalCode": boolean,
  "suitelinkFootnote": string,
  "pmbDesignator": string,
  "pmbNumber": string,
  "addressRecordType": string,
  "defaultAddress": boolean,
  "errorMessage": string,
  "cassProcessed": boolean
}
Campi
standardizedAddress

object (UspsAddress)

Indirizzo standardizzato USPS.
deliveryPointCode

string

Codice del punto di consegna di 2 cifre
deliveryPointCheckDigit

string

La cifra di controllo del punto di consegna. Questo numero viene aggiunto alla fine del codice a barre delivery_point per la posta sottoposta a scansione meccanica. L'aggiunta di tutte le cifre di delivery_point_barcode, deliveryPointCheckDigit, codice postale e ZIP+4 deve produrre un numero divisibile per 10.
dpvConfirmation

string

I valori possibili per la conferma del DPV. Restituisce un singolo carattere o nessun valore.

  • N: non è stato possibile confermare il numero principale e eventuali numeri secondari tramite DPV.
  • D: l'indirizzo è stato confermato dal DPV solo per il numero principale e mancano le informazioni sul numero secondario.
  • S: l'indirizzo è stato confermato tramite DPV solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non confermate.
  • Y: l'indirizzo è stato confermato dal DPV per il numero principale e per eventuali numeri secondari.
  • Vuoto: se la risposta non contiene un valore dpvConfirmation, l'indirizzo non è stato inviato per la conferma del DPV.
dpvFootnote

string

Le note a piè di pagina della convalida del punto di consegna. È possibile concatenare più note a piè di pagina nella stessa stringa.

  • AA: indirizzo inserito corrispondente al file ZIP+4
  • A1: l'indirizzo inserito non corrisponde al file ZIP+4
  • BB: corrispondenza con il DPV (tutti i componenti)
  • CC: numero secondario senza corrispondenza e non obbligatorio
  • C1: Numero secondario non corrispondente, ma obbligatorio
  • N1: nell'indirizzo di un grattacielo manca il numero secondario
  • M1: numero principale mancante
  • M3: numero principale non valido
  • P1: numero della cassetta postale PO, RR o HC mancante nell'indirizzo inserito
  • P3: numero di casella postale PO, RR o HC dell'indirizzo di input non valido
  • F1: l'indirizzo inserito corrisponde a un indirizzo militare
  • G1: l'indirizzo inserito corrisponde a un indirizzo di consegna generale
  • U1: indirizzo inserito associato a un codice postale univoco
  • PB: indirizzo inserito corrispondente al record PBSA
  • RR: indirizzo confermato dal DPV con informazioni PMB
  • R1: indirizzo confermato dal DPV senza informazioni sul PMB
  • R7: record Percorso corriere R777 o R779
  • IA: indirizzo informato identificato
  • TA: Numero principale trovato eliminando una lettera finale
dpvCmra

string

Indica se l'indirizzo è una CMRA (Commercial Mail Receiving Agency), ovvero un'azienda privata che riceve posta per i clienti. Restituisce un singolo carattere.

  • Y: l'indirizzo è un CMRA
  • N: l'indirizzo non è un CMRA
dpvVacant

string

Questo posto è libero? Restituisce un singolo carattere.

  • Y: l'indirizzo è vuoto
  • N: l'indirizzo non è vuoto
dpvNoStat

string

Si tratta di un indirizzo senza statistiche o di un indirizzo attivo? Gli indirizzi senza statistiche sono quelli non occupati in modo continuativo o quelli non serviti dall'USPS. Restituisce un singolo carattere.

  • Y: l'indirizzo non è attivo
  • N: l'indirizzo è attivo
dpvNoStatReasonCode

integer

Indica il tipo NoStat. Restituisce un codice motivo come int.

  • 1: IDA (Internal Drop Address, indirizzo di consegna interno): indirizzi che non ricevono posta direttamente dall'USPS, ma vengono consegnati a un indirizzo di consegna che li serve.
  • 2: CDS: indirizzi che non sono ancora stati recapitati. Ad esempio, una nuova suddivisione in cui sono stati determinati lotti e numeri principali, ma non esiste ancora una struttura per l'occupazione.
  • 3: Collisione: indirizzi che non confermano effettivamente il DPV.
  • 4: CMZ (College, Military and Other Types) - ZIP + 4 records USPS has incorporated into the data.
  • 5: normale: indica gli indirizzi che non ricevono la consegna e che non vengono conteggiati come possibili consegne.
  • 6: obbligatorio secondario: l'indirizzo richiede informazioni secondarie.
dpvDrop

string

L'indicatore indica che la posta viene recapitata in un unico contenitore in un sito. Restituisce un singolo carattere.

  • Y: la posta viene consegnata in un unico contenitore in un sito.
  • N: la posta non viene consegnata in un'unica cassetta postale in un sito.
dpvThrowback

string

Indica che la posta non viene consegnata all'indirizzo. Restituisce un singolo carattere.

  • Y: la posta non viene consegnata all'indirizzo.
  • N: la posta viene consegnata all'indirizzo.
dpvNonDeliveryDays

string

Indica che la consegna della posta non viene eseguita ogni giorno della settimana. Restituisce un singolo carattere.

  • Y: la consegna della posta non viene effettuata tutti i giorni della settimana.
  • N: nessuna indicazione che la consegna della posta non venga effettuata tutti i giorni della settimana.
dpvNonDeliveryDaysValues

integer

Numero intero che identifica i giorni di mancata pubblicazione. Può essere interrogato utilizzando 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 - Sabato è un giorno di mancata consegna
dpvNoSecureLocation

string

L'indicatore indica che la porta è accessibile, ma il pacco non verrà lasciato per motivi di sicurezza. Restituisce un singolo carattere.

  • Y: il pacchetto non verrà lasciato a causa di problemi di sicurezza.
  • N: nessuna indicazione che il pacco non verrà lasciato per motivi di sicurezza.
dpvPbsa

string

Indica che l'indirizzo è stato associato al record PBSA. Restituisce un singolo carattere.

  • Y: l'indirizzo è stato associato al record PBSA.
  • N: non è stata trovata una corrispondenza dell'indirizzo con il record PBSA.
dpvDoorNotAccessible

string

Indica gli indirizzi in cui l'USPS non può bussare alla porta per consegnare la posta. Restituisce un singolo carattere.

  • Y: la porta non è accessibile.
  • N: nessuna indicazione che la porta non è accessibile.
dpvEnhancedDeliveryCode

string

Indica che per l'indirizzo è valido più di un codice di reso DPV. Restituisce un singolo carattere.

  • Y: l'indirizzo è stato confermato dal DPV per il numero principale e per eventuali numeri secondari.
  • N: non è stato possibile confermare i numeri principali e secondari tramite DPV.
  • S: l'indirizzo è stato confermato tramite DPV solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non confermate oppure è stato omesso un singolo carattere alfa finale in un numero principale per ottenere una corrispondenza DPV e sono necessarie informazioni secondarie.
  • D: l'indirizzo è stato confermato dal DPV solo per il numero principale e mancano le informazioni sul numero secondario.
  • R: indirizzo confermato, ma assegnato al percorso fantasma R777 e R779 e la consegna tramite USPS non è prevista.
carrierRoute

string

Il codice percorso dell'operatore. Un codice di quattro caratteri costituito da un prefisso di una lettera e da un indicatore di percorso di tre cifre.

Prefissi:

  • C: percorso dell'operatore (o percorso della città)
  • R: percorso extraurbano
  • H: Percorso del contratto per l'autostrada
  • B: sezione cassetta postale
  • G: unità di consegna generale
carrierRouteIndicator

string

Indicatore di ordinamento della tariffa del percorso del corriere.
ewsNoMatch

boolean

L'indirizzo di consegna è associabile, ma il file EWS indica che a breve sarà disponibile una corrispondenza esatta.
postOfficeCity

string

Città dell'ufficio postale principale.
postOfficeState

string

Stato dell'ufficio postale principale.
abbreviatedCity

string

Città abbreviata.
fipsCountyCode

string

Codice FIPS della contea.
county

string

Nome della contea.
elotNumber

string

Numero della linea di viaggio avanzata (eLOT).
elotFlag

string

Flag A/D (crescente/decrescente) per gli elenchi di offerte.
poBoxOnlyPostalCode

boolean

Solo codice postale per caselle postali.
pmbDesignator

string

Designatore dell'unità PMB (Private Mail Box).
pmbNumber

string

Numero PMB (Private Mail Box);
addressRecordType

string

Tipo di record indirizzo corrispondente all'indirizzo inserito.

  • F: FIRM. Si tratta di una corrispondenza con un record dell'azienda, che è il livello più alto di corrispondenza disponibile per un indirizzo.
  • G: CONSEGNA GENERALE. Corrispondenza a un record di recapito generale.
  • H: EDIFICIO / APPARTAMENTO. Corrispondenza con un record di un edificio o di un appartamento.
  • P: CASELLA POSTALE. Corrisponde a una cassetta postale.
  • R: RURAL ROUTE o HIGHWAY CONTRACT: corrisponde a un record di Rural Route o Highway Contract, entrambi con intervalli di numeri civici associati.
  • S: RECORD VIA: corrisponde a un record Via contenente un intervallo di numeri principali valido.
defaultAddress

boolean

Indica che è stato trovato un indirizzo predefinito, ma esistono indirizzi più specifici.
errorMessage

string

Messaggio di errore per il recupero dei dati USPS. Viene compilato quando l'elaborazione USPS è sospesa a causa del rilevamento di indirizzi creati artificialmente.

I campi dei dati USPS potrebbero non essere compilati quando è presente questo errore.
cassProcessed

boolean

Indica che la richiesta è stata elaborata in base al sistema CASS.

UspsAddress

Rappresentazione USPS di un indirizzo statunitense.

Rappresentazione JSON 
{
  "firstAddressLine": string,
  "firm": string,
  "secondAddressLine": string,
  "urbanization": string,
  "cityStateZipAddressLine": string,
  "city": string,
  "state": string,
  "zipCode": string,
  "zipCodeExtension": string
}
Campi
firstAddressLine

string

Prima riga dell'indirizzo.
firm

string

Ragione sociale.
secondAddressLine

string

Seconda riga dell'indirizzo.
urbanization

string

Nome dell'urbanizzazione portoricana.
cityStateZipAddressLine

string

Città + stato + codice postale.
city

string

Nome della città.
state

string

Codice stato di 2 lettere.
zipCode

string

Codice postale, ad esempio 10009.
zipCodeExtension

string

Estensione del codice postale a 4 cifre, ad esempio 5023.