Merupakan alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Seperti alamat pos, layanan pos dapat mengirimkan item ke tempat, P.O Box, atau yang serupa. Ini tidak dimaksudkan untuk memodelkan lokasi geografis (jalan, kota, gunung).
Dalam penggunaan umum, alamat akan dibuat melalui masukan pengguna atau dengan mengimpor data yang ada, bergantung pada jenis prosesnya.
Saran tentang pengisian/pengeditan alamat: - Gunakan widget alamat i18n-ready seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk mengisi atau mengedit kolom selain negara tempat kolom tersebut digunakan.
Untuk mendapatkan panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478
| Representasi JSON | |
|---|---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
|
| Kolom | |
|---|---|
revision |
Revisi skema Semua revisi baru harus kompatibel dengan revisi lama. |
regionCode |
Wajib diisi. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan bergantung pada pengguna untuk memastikan nilainya benar. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk detailnya. Contoh: "CH" untuk Swiss. |
languageCode |
Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini sering kali merupakan bahasa UI dari formulir masukan atau diharapkan cocok dengan salah satu bahasa yang digunakan di alamat' negara/wilayah, atau yang setara dalam transliterasi. Ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak berpengaruh penting terhadap kebenaran data dan tidak akan pernah memengaruhi validasi apa pun atau operasi terkait non-pemformatan. Jika tidak diketahui, nilai ini harus dihilangkan (bukan menentukan default yang mungkin salah). Contoh: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
Opsional. Kode pos alamat. Tidak semua negara menggunakan atau memerlukan penyertaan kode pos, tetapi jika kode pos digunakan, kode pos dapat memicu validasi tambahan dengan bagian alamat lain (mis. validasi negara bagian/kode pos di AS). |
sortingCode |
Opsional. Kode pengurutan tambahan khusus negara. Kode ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya adalah string seperti "CEDEX", secara opsional diikuti dengan nomor (mis. "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi) atau "indikator kantor pos.g7.g |
administrativeArea |
Opsional. Subdivisi administrasi tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Khususnya, untuk Spanyol ini adalah provinsi dan bukan komunitas otonom (mis. "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif di alamat pos. Mis. di Swiss ini harus dibiarkan kosong. |
locality |
Opsional. Secara umum merujuk pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post city. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines. |
sublocality |
Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa lingkungan, borough, distrik. |
addressLines[] |
Baris alamat tidak terstruktur yang menggambarkan level alamat yang lebih rendah. Karena nilai dalam addressLines tidak memiliki informasi jenis dan terkadang dapat berisi beberapa nilai dalam satu kolom (misalnya "Austin, TX"), urutan baris harus jelas. Urutan baris alamat harus "urutan amplop" untuk negara/wilayah alamat. Di tempat baris alamat ini dapat bervariasi (mis. Jepang), address_language digunakan untuk membuatnya eksplisit (misalnya "ja" untuk pengurutan besar ke kecil dan "ja-Latn" atau "en" untuk kecil ke besar). Dengan cara ini, baris alamat yang paling spesifik dapat dipilih berdasarkan bahasa. Representasi struktural minimum yang diizinkan dari alamat terdiri dari regionCode dengan semua informasi yang tersisa yang ditempatkan di addressLines. Memformat alamat seperti itu dengan sangat akurat tanpa geocoding dapat dilakukan, tetapi tidak ada alasan semantik yang dapat dibuat mengenai salah satu komponen alamat hingga setidaknya sebagian diselesaikan. Membuat alamat yang hanya berisi regionCode dan addressLines, dan kemudian geocoding adalah cara yang disarankan untuk menangani alamat yang sepenuhnya tidak terstruktur (sebagai kebalikan dari menebak bagian alamat yang harus berupa lokalitas atau wilayah administratif). |
recipients[] |
Opsional. Penerima di alamat. Kolom ini dapat, dalam keadaan tertentu, berisi informasi multibaris. Misalnya, ini mungkin berisi "perhatian" informasi. |
organization |
Opsional. Nama organisasi di alamat. |