PostalAddress

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

integer

Revisi skema PostalAddress. Nilai ini harus disetel ke 0, yang merupakan revisi terbaru.

Semua revisi baru harus kompatibel dengan revisi lama.

string

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

string

Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini sering kali merupakan bahasa UI formulir input atau diharapkan cocok dengan salah satu bahasa yang digunakan di alamat negara/wilayah, atau padanannya dalam transliterasi. Hal 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 nilai ini tidak diketahui, sebaiknya dihilangkan (bukan menentukan default yang mungkin salah).

Contoh: "zh-Hant", "ja", "ja-Latn", "en".

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan 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).

string

Opsional. Kode pengurutan tambahan khusus negara. Kode ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya dapat berupa string seperti "CEDEX", secara opsional diikuti dengan angka (mis. "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi) atau "indikator kantor pos" (mis. Côte d'Ivoire).

string

Opsional. Subdivisi administratif tertinggi yang digunakan untuk alamat pos suatu 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 dalam alamat pos. Mis. di Swiss kolom ini harus dibiarkan tidak terisi.

string

Opsional. Secara umum mengacu pada bagian kota dari alamat tersebut. Contoh: US city, IT comune, UK post town. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines.

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa kawasan, kota besar, distrik.

string

Baris alamat tidak terstruktur yang menggambarkan tingkat 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 haruslah jelas. Urutan baris alamat harus "urutan amplop" untuk negara/wilayah alamat. Di tempat yang dapat bervariasi (misalnya, 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, lalu melakukan geocoding adalah cara yang direkomendasikan untuk menangani alamat yang sepenuhnya tidak terstruktur (sebagai kebalikan dari menebak bagian alamat yang harus berupa lokalitas atau wilayah administratif).

string

Opsional. Penerima di alamat. Kolom ini dapat, dalam keadaan tertentu, berisi informasi multibaris. Misalnya, mungkin ada kata "care of" tidak akurat atau tidak sesuai.

string

Opsional. Nama organisasi di alamat.