Indeks
Date(pesan)LatLng(pesan)Money(pesan)PostalAddress(pesan)TimeOfDay(pesan)
Tanggal
Mewakili seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau tidak signifikan. Tanggal tersebut relatif terhadap Kalender Gregorian. Ini dapat mewakili salah satu dari hal berikut:
- Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol
- Nilai bulan dan hari, dengan tahun nol, seperti hari jadi
- Tahun saja, dengan nilai bulan dan hari nol
- Nilai tahun dan bulan, dengan nol hari, seperti tanggal habis masa berlaku kartu kredit
Jenis terkait adalah google.type.TimeOfDay dan google.protobuf.Timestamp.
| Kolom | |
|---|---|
year |
Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun. |
month |
Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari. |
day |
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. |
LatLng
Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, nilai harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.
| Kolom | |
|---|---|
latitude |
Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0]. |
longitude |
Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0]. |
Money
Menyatakan jumlah uang dengan jenis mata uangnya.
| Kolom | |
|---|---|
currency_code |
Tiga huruf kode mata uang yang ditentukan dalam ISO 4217. |
units |
Seluruh unit jumlahnya. Misalnya, jika |
nanos |
Jumlah satuan nano (10^-9) dari jumlahnya. Nilai harus antara -999.999.999 dan +999.999.999 inklusif. Jika |
PostalAddress
Mewakili alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Seperti alamat pos, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau yang serupa. Aplikasi ini tidak dimaksudkan untuk membuat model lokasi geografis (jalan, kota, gunung).
Dalam penggunaan umum, alamat akan dibuat melalui input pengguna atau dari mengimpor data yang ada, bergantung pada jenis prosesnya.
Saran tentang input / pengeditan alamat: - Gunakan widget alamat i18n-siap seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk memasukkan atau mengedit kolom selain negara tempat kolom tersebut digunakan.
Untuk panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478
| Kolom | |
|---|---|
revision |
Revisi skema Semua revisi baru harus kompatibel dengan revisi lama. |
region_code |
Wajib. Kode wilayah CLDR negara/wilayah alamat. Ini tidak pernah disimpulkan dan terserah pengguna untuk memastikan nilainya benar. Lihat http://cldr.unicode.org/ dan http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss. |
language_code |
Opsional. Kode bahasa BCP-47 dari konten alamat ini (jika diketahui). Ini sering kali berupa bahasa UI formulir input atau diharapkan cocok dengan salah satu bahasa yang digunakan di negara/wilayah alamat, atau bahasa yang setara dalam transliterasinya. Hal ini dapat memengaruhi pemformatan di negara tertentu, tetapi tidak penting bagi ketepatan data dan tidak akan memengaruhi validasi atau operasi terkait non-pemformatan lainnya. Jika nilai ini tidak diketahui, nilai ini harus dihilangkan (bukan menetapkan nilai default yang mungkin salah). Contoh: "zh-Hant", "ja", "ja-Latn", "en". |
postal_code |
Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos, tetapi jika digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat yang lain (misalnya validasi negara bagian/pos di Amerika Serikat). |
sorting_code |
Opsional. Kode pengurutan tambahan khusus negara. Atribut ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya berupa string seperti "CEDEX", secara opsional diikuti dengan angka (misalnya "CEDEX 7"), atau hanya angka, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (misalnya Côte d'Ivoire). |
administrative_area |
Opsional. Subdivisi administratif 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 (misalnya "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan tidak terisi. |
locality |
Opsional. Secara umum merujuk pada bagian kota dari alamat. 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 address_lines. |
sublocality |
Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa kawasan, kota kecil, distrik. |
address_lines[] |
Baris alamat tidak terstruktur yang menggambarkan tingkat 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 harus jelas. Urutan baris alamat harus "urutan amplop" untuk negara/wilayah alamat. Di tempat yang dapat memiliki perbedaan (mis. Jepang), address_language digunakan untuk membuatnya eksplisit (mis. "ja" untuk pengurutan besar ke kecil dan "ja-Latn" atau "en" untuk kecil ke besar). Dengan cara ini, baris alamat 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. Alamat tersebut dapat diformat kira-kira tanpa geocoding, tetapi tidak ada alasan semantik yang dapat dibuat untuk komponen alamat mana pun hingga setidaknya sebagian terselesaikan. Membuat alamat hanya berisi region_code dan address_line, dan kemudian geocoding adalah cara yang disarankan untuk menangani alamat yang benar-benar tidak terstruktur (alih-alih menebak bagian alamat mana yang harus berupa lokalitas atau wilayah administratif). |
recipients[] |
Opsional. Penerima di alamat. Dalam kondisi tertentu, kolom ini dapat berisi informasi multibaris. Misalnya, halaman ini mungkin berisi informasi "perawatan". |
organization |
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 |
Jam dalam format 24 jam. Harus antara 0 hingga 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti jam tutup bisnis. |
minutes |
Menit dalam jam. Harus antara 0 hingga 59. |
seconds |
Detik dari menit. Biasanya harus antara 0 hingga 59. API dapat mengizinkan nilai 60 jika memungkinkan kabisat-detik. |
nanos |
Pecahan detik dalam nanodetik. Harus dari 0 hingga 999.999.999. |