Package google.type

Indeks

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau dianggap tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Kolom
year

int32

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

int32

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

int32

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

DayOfWeek

Merepresentasikan hari dalam seminggu.

Enum
DAY_OF_WEEK_UNSPECIFIED Hari dalam seminggu tidak ditentukan.
MONDAY Senin
TUESDAY Selasa
WEDNESDAY Rabu
THURSDAY Kamis
FRIDAY Jumat
SATURDAY Sabtu
SUNDAY Minggu

PostalAddress

Mewakili alamat pos (misalnya, untuk pengiriman pos atau alamat pembayaran). Seperti alamat pos, layanan pos dapat mengirimkan item ke tempat, kotak pos, 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 atau pengeditan alamat: - Gunakan widget alamat yang siap untuk internasionalisasi 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.

Kolom
revision

int32

Revisi skema PostalAddress. Ini harus ditetapkan ke 0, yang merupakan revisi terbaru.

Semua revisi baru harus kompatibel dengan revisi lama.
region_code

string

Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan bergantung pada pengguna untuk memastikan nilainya benar. Lihat https://cldr.unicode.org/ dan https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss.
language_code

string

Opsional. Kode bahasa BCP-47 konten alamat ini (jika diketahui). Ini biasanya merupakan bahasa UI formulir masukan atau diharapkan cocok dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau padanan transliterasinya. 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 tidak diketahui, maka harus dihilangkan (dibanding menentukan kemungkinan default yang salah).

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

string

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 (misalnya, validasi negara bagian atau kode pos di Amerika Serikat).
sorting_code

string

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

string

Opsional. Subdivisi administrasi tertinggi yang digunakan untuk alamat pos negara atau wilayah. Misalnya, ini dapat berupa negara bagian, provinsi, oblast, atau prefektur. Untuk Spanyol, ini adalah provinsi dan bukan komunitas otonom (misalnya, "Barcelona" dan bukan "Catalonia"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan kosong.
locality

string

Opsional. Secara umum merujuk 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 locality kosong dan gunakan address_lines.
sublocality

string

Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa lingkungan, borough, atau distrik.
address_lines[]

string

Baris alamat tidak terstruktur yang menggambarkan level alamat yang lebih rendah.

Karena nilai dalam address_lines 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 atau wilayah alamat. Di tempat baris alamat ini 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 region_code dengan semua informasi yang tersisa yang ditempatkan di address_lines. 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 region_code dan address_lines, lalu melakukan geocoding adalah cara yang direkomendasikan untuk menangani alamat yang sepenuhnya tidak terstruktur (alih-alih menebak bagian alamat yang harus berupa lokalitas atau wilayah administratif).
recipients[]

string

Opsional. Penerima di alamat. Kolom ini dapat, dalam keadaan tertentu, berisi informasi multibaris. Misalnya, ini bisa berisi informasi "alamat lainnya".
organization

string

Opsional. Nama organisasi di alamat.

TimeOfDay

Merepresentasikan waktu. Tanggal dan zona waktu tidak signifikan atau ditentukan di tempat lain. API dapat memilih untuk mengizinkan detik kabisat. Jenis terkait adalah google.type.Date dan google.protobuf.Timestamp.

Kolom
hours

int32

Jam dalam format 24 jam. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

int32

Menit dalam satu jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59.
seconds

int32

Detik dalam satu menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

int32

Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999.

TimeZone

Mewakili zona waktu dari Database Zona Waktu IANA.

Kolom
id

string

Zona waktu IANA Time Zone Database. Misalnya, "America/New_York".
version

string

Opsional. Nomor versi Database Zona Waktu IANA. Misalnya, "2019a".