PostalAddress

Rappresenta un indirizzo postale, ad esempio per la consegna postale o gli indirizzi di pagamento. Con un indirizzo postale, un servizio postale può consegnare articoli a un edificio, una casella postale o simili. Un indirizzo postale non è destinato a modellare posizioni geografiche come strade, città o montagne.

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

Consigli per l'inserimento o la modifica dell'indirizzo:

  • Utilizza un widget per gli indirizzi pronto per l'internazionalizzazione, ad esempio https://github.com/google/libaddressinput.
  • Agli utenti non devono essere presentati elementi UI per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato il campo.

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. Questo valore deve essere impostato su 0, ovvero l'ultima revisione.

Tutte le nuove revisioni devono essere compatibili con le versioni precedenti.
regionCode

string

Obbligatorio. Codice CLDR del paese/dell'area geografica dell'indirizzo. Questo valore non viene mai dedotto e spetta all'utente assicurarsi che sia corretto. 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.
languageCode

string

Facoltativo. Codice lingua BCP-47 dei contenuti dell'indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di immissione o si prevede che corrisponda a una delle lingue utilizzate nel paese o nella regione dell'indirizzo o ai relativi equivalenti traslitterati. Ciò può influire sulla formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai sulla convalida o su altre operazioni non correlate alla formattazione.

Se questo valore non è noto, deve essere omesso (anziché specificare un valore predefinito potenzialmente errato).

Esempi: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Facoltativo. Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono i 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 campo non viene utilizzato nella maggior parte delle regioni. Se utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad esempio "CEDEX 7"), o solo un numero, che rappresenta il "codice di 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. Esempio: "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 il campo locality vuoto e usa addressLines.
sublocality

string

Facoltativo. Quartiere dell'indirizzo. Ad esempio, può essere un quartiere, un rione o un distretto.
addressLines[]

string

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

Poiché i valori in addressLines non contengono informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad esempio "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe dell'indirizzo deve essere l'"ordine della busta" per il paese o la regione dell'indirizzo. Nei luoghi in cui questo può variare (ad esempio, il Giappone), viene utilizzato address_language per renderlo esplicito (ad esempio, "ja" per l'ordinamento dal più grande al più piccolo e "ja-Latn" o "en" per l'ordinamento dal più piccolo al più grande). In questo modo, è possibile selezionare la riga più specifica di un indirizzo in base alla lingua.

La rappresentazione strutturale minima consentita di un indirizzo è costituita da un regionCode con tutte le informazioni rimanenti inserite in addressLines. Senza la geocodifica, sarebbe possibile formattare un indirizzo di questo tipo in modo molto approssimativo, ma non sarebbe possibile fare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo finché non viene risolto almeno parzialmente.

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

string

Facoltativo. Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere informazioni "presso".
organization

string

Facoltativo. Il nome dell'organizzazione all'indirizzo.