Rappresenta un indirizzo postale, ad esempio per gli indirizzi di consegna postale o di pagamento. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, una P.O. Box o simile. Non è progettato per creare modelli di località geografiche (strade, città, montagne).
Nell'utilizzo tipico, un indirizzo verrebbe creato tramite l'input dell'utente o importando dati esistenti, a seconda del tipo di processo.
Consigli sull'inserimento / modifica di indirizzi: - Usa un widget degli indirizzi pronto per l'internazionalizzazione, come https://github.com/google/libaddressinput. - Agli utenti non dovrebbero essere mostrati elementi di interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato quel 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 |
La revisione dello schema di Tutte le nuove revisioni devono essere compatibili con le versioni precedenti. |
regionCode |
Obbligatorio. Codice regione CLDR del paese o della regione dell'indirizzo. Ciò non viene mai dedotto e spetta all'utente assicurarsi che il valore sia corretto. Per informazioni dettagliate, 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 |
(Facoltativo) Codice lingua BCP-47 dei contenuti di questo indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di input o dovrebbe corrispondere a una delle lingue utilizzate nell'indirizzo. paese/regione o i loro equivalenti traslitterati. Questo può influenzare la formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai su convalida o altre operazioni correlate alla formattazione. Se questo valore non è noto, dovrebbe essere omesso (anziché specificare un valore predefinito potenzialmente errato). Esempi: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
(Facoltativo) Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/codice postale negli Stati Uniti). |
sortingCode |
(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Dove viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice di settore" (Giamaica), "indicatore zona di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrativeArea |
(Facoltativo) Suddivisione amministrativa di livello più elevato utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. In particolare, per la Spagna si tratta della provincia e non della comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad es. in Svizzera, deve essere lasciato vuoto. |
locality |
(Facoltativo) In genere si riferisce alla porzione di città dell'indirizzo. Esempi: città USA, comune in Italia, città postale nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia il campo della località vuoto e utilizza addressLines. |
sublocality |
(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, quartieri e distretti. |
addressLines[] |
Righe di 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. Nei luoghi dove questo valore può variare (ad es. in Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per ordinamenti di grandi dimensioni e "ja-Latn" o "en" per valori di piccole dimensioni). In questo modo, è possibile selezionare la riga più specifica di un indirizzo in base alla lingua. La rappresentazione strutturale minima consentita di un indirizzo è composta da un regionalCode con tutte le informazioni rimanenti inserite in addressLines. Sarebbe possibile formattare un indirizzo del genere in modo molto approssimativo senza geocodifica, ma non è stato possibile effettuare alcun ragionamento semantico su nessuno dei componenti dell'indirizzo fino a quando non è stato almeno parzialmente risolto. Creare un indirizzo che contenga solo countryCode e addressLines e poi la geocodifica è il metodo consigliato per gestire indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative). |
recipients[] |
(Facoltativo) Il destinatario all'indirizzo. In determinate circostanze, questo campo può contenere informazioni su più righe. Ad esempio, potrebbe contenere "cura di" informazioni. |
organization |
(Facoltativo) Il nome dell'organizzazione all'indirizzo. |