Package google.type

Indeks

LatLng

Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.

Kolom
latitude

double

Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0].
longitude

double

Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0].

PostalAddress

Merepresentasikan 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 input pengguna atau dengan mengimpor data yang ada, bergantung pada jenis prosesnya.

Saran tentang pengisian/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. Nilai apa pun selain 0 akan menyebabkan API menampilkan error INVALID_ARGUMENT.
region_code

string

Opsional. Kode wilayah CLDR negara/wilayah alamat. Lihat https://cldr.unicode.org/ dan https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html untuk mengetahui detailnya. Contoh: "CH" untuk Swiss. Jika tidak disediakan, kode wilayah akan disimpulkan dari alamat. Untuk performa terbaik, sebaiknya sertakan kode wilayah jika Anda mengetahuinya. Memiliki wilayah yang tidak konsisten atau berulang dapat menyebabkan performa yang buruk. Misalnya, jika address_lines sudah menyertakan wilayah tersebut, jangan berikan kode wilayah lagi di kolom ini. Wilayah yang didukung dapat ditemukan di FAQ.
language_code

string

Kode bahasa di alamat input dicadangkan untuk penggunaan di masa mendatang dan diabaikan saat ini. API menampilkan alamat dalam bahasa yang sesuai untuk lokasi alamat tersebut.
postal_code

string

Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos, tetapi jika kode pos digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat lainnya (misalnya, validasi negara bagian/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 adalah string seperti "CEDEX", yang secara opsional diikuti dengan angka (misalnya, "CEDEX 7"), atau hanya angka saja, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (misalnya, Côte d'Ivoire).
administrative_area

string

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 (mis. "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Mis. di Swiss 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 lokalitas kosong dan gunakan address_lines.
sublocality

string

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

string

Wajib. 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 berupa "urutan amplop" untuk negara/wilayah alamat.

Representasi struktural minimum yang diizinkan dari alamat terdiri dari semua informasi yang ditempatkan di address_lines. Jika region_code tidak diberikan, region akan diambil dari baris alamat.

Membuat alamat yang hanya berisi address_lines, 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).
recipients[]

string

Jangan menetapkan kolom ini. Address Validation API saat ini tidak menggunakannya. Meskipun saat ini API tidak akan menolak permintaan dengan menyetel kolom ini, informasi akan dibuang dan tidak akan dikembalikan dalam respons.
organization

string

Jangan menetapkan kolom ini. Address Validation API saat ini tidak menggunakannya. Meskipun saat ini API tidak akan menolak permintaan dengan kolom ini ditetapkan, informasi akan dihapus dan tidak akan ditampilkan dalam respons.