Package google.maps.addressvalidation.v1

string

Alamat pascapemrosesan, yang diformat sebagai alamat satu baris dengan mengikuti aturan pemformatan alamat di wilayah tempat alamat tersebut berada.

PostalAddress

Alamat pascapemrosesan yang diwakili sebagai alamat pos.

AddressComponent

Daftar yang tidak diurutkan. Komponen alamat individual dari alamat yang diformat dan dikoreksi, beserta informasi validasi. Ini memberikan informasi tentang status validasi setiap komponen.

Komponen alamat tidak diurutkan dengan cara tertentu. Jangan membuat asumsi apa pun mengenai urutan komponen alamat dalam daftar.

string

Jenis komponen yang diharapkan ada di alamat surat yang diformat dengan benar, tetapi tidak ditemukan dalam input DAN tidak dapat disimpulkan. Komponen jenis ini tidak ada di formatted_address, postal_address, atau address_components. Contohnya mungkin ['street_number', 'route'] untuk input seperti "Boulder, Colorado, 80301, USA". Daftar kemungkinan jenis dapat ditemukan di sini.

string

Jenis komponen yang ada di address_components, tetapi tidak dapat dikonfirmasi sebagai benar. Kolom ini disediakan demi kenyamanan: kontennya setara dengan melakukan iterasi melalui address_components untuk menemukan jenis semua komponen yang confirmation_level bukan CONFIRMED atau flag inferred tidak disetel ke true. Daftar kemungkinan jenis dapat ditemukan di sini.

string

Setiap token dalam input yang tidak dapat diselesaikan. Input ini mungkin berupa input yang tidak dikenali sebagai bagian alamat yang valid (misalnya dalam input seperti "123235253253 Main St, San Francisco, CA, 94105", token yang belum terselesaikan mungkin terlihat seperti ["123235253253"] karena tidak terlihat seperti nomor jalan yang valid.

ComponentName

Nama untuk komponen ini.

string

Jenis komponen alamat. Lihat Tabel 2: Jenis tambahan yang ditampilkan oleh layanan Places untuk daftar kemungkinan jenis.

ConfirmationLevel

Menunjukkan tingkat kepastian yang kita miliki bahwa komponen tersebut benar.

bool

Menunjukkan bahwa komponen tersebut bukan bagian dari input, tetapi kami menyimpulkannya untuk lokasi alamat dan meyakini bahwa komponen tersebut seharusnya diberikan untuk alamat lengkap.

bool

Menunjukkan koreksi terhadap kesalahan ejaan dalam nama komponen. API tidak selalu menandai perubahan dari satu varian ejaan ke varian ejaan lainnya, seperti saat mengubah "pusat" menjadi "tengah". Kesalahan ejaan yang umum juga tidak selalu ditandai, misalnya saat mengubah "Amphitheater Pkwy" menjadi "Amphitheatre Pkwy".

bool

Menunjukkan nama komponen telah diganti dengan yang sama sekali berbeda, misalnya kode pos yang salah diganti dengan kode pos yang benar untuk alamat tersebut. Ini bukanlah perubahan tampilan, komponen input telah diubah ke yang lain.

bool

Menunjukkan komponen alamat yang tidak diharapkan ada di alamat pos untuk wilayah yang ditentukan. Kita mempertahankannya hanya karena itu merupakan bagian dari input.

bool

Menunjukkan bahwa ini adalah alamat bisnis. Jika tidak disetel, nilai akan menunjukkan bahwa nilai tidak diketahui.

bool

Menunjukkan bahwa alamat PO box. Jika tidak disetel, nilai akan menunjukkan bahwa nilai tidak diketahui.

bool

Menunjukkan bahwa ini adalah alamat tempat tinggal. Jika tidak disetel, nilai akan menunjukkan bahwa nilai tidak diketahui.

string

Teks nama. Misalnya, "5th Avenue" untuk nama jalan atau "1253" untuk nomor jalan.

string

Kode bahasa BCP-47. Nama ini tidak akan ada jika nama komponen tidak dikaitkan dengan bahasa, seperti nomor jalan.

LatLng

Lokasi geocode input.

Menggunakan ID tempat lebih disukai daripada menggunakan alamat, koordinat lintang/bujur, atau kode plus. Menggunakan koordinat saat mengarahkan rute atau menghitung arah mengemudi akan selalu mengakibatkan titik terikat pada jalan yang paling dekat dengan koordinat tersebut. Jalan ini mungkin bukan jalan yang akan menuju ke tujuan dengan cepat atau aman serta mungkin tidak berada di dekat titik akses ke properti. Selain itu, jika lokasi di-geocoding terbalik, tidak ada jaminan bahwa alamat yang ditampilkan akan cocok dengan aslinya.

PlusCode

Kode plus yang sesuai dengan location.

Viewport

Batas tempat yang di-geocoding.

float

Ukuran tempat yang di-geocode, dalam meter. Ini adalah ukuran lain dari kekasaran lokasi yang di-geocode, namun dalam ukuran fisik, bukan dalam arti semantik.

string

PlaceID tempat input geocode ini.

Untuk informasi selengkapnya tentang ID Tempat, lihat di sini.

string

Jenis tempat yang akan di-geocode input. Misalnya, ['locality', 'political']. Daftar lengkap jenis dapat ditemukan di sini.

bool

Pratinjau: Menampilkan google.maps.addressvalidation.v1.Address dalam bahasa Inggris. Untuk lebih detailnya, lihat google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

string

Kode global (penuh) Tempat, seperti "9FWM33GV+HQ", yang mewakili area 1/8000 x 1/8000 derajat (~14 x 14 meter).

string

Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norwegia", yang berisi akhiran kode global dan mengganti awalan dengan nama berformat dari entitas referensi.

ValidationConclusion

Wajib. Hasil dari urutan upaya validasi.

Jika kolom ini disetel ke VALIDATION_CONCLUSION_UNSPECIFIED, error INVALID_ARGUMENT akan ditampilkan.

string

Wajib. ID respons yang menjadi tujuan masukan ini. Ini harus berupa [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] dari respons pertama dalam serangkaian upaya validasi alamat.

string

Baris alamat pertama.

string

Nama perusahaan.

string

Baris alamat kedua.

string

Nama urbanisasi Puerto Riko.

string

Kota + negara bagian + kode pos.

string

Nama kota.

string

Kode negara bagian 2 huruf.

string

Kode pos, misalnya, 10009.

string

Ekstensi kode pos 4 digit, misalnya 5023.

UspsAddress

alamat standar USPS.

string

2 digit kode poin pengiriman

string

Digit pemeriksaan titik pengiriman. Nomor ini ditambahkan ke akhir delivery_point_barcode untuk email yang dipindai secara mekanis. Menambahkan semua digit delivery_point_barcode, delivery_point_check_digit, kode pos, dan ZIP+4 bersama-sama akan menghasilkan angka yang habis dibagi 10.

string

Nilai yang mungkin untuk konfirmasi DPV. Menampilkan satu karakter atau tidak menampilkan nilai.

• N: Informasi nomor utama dan sekunder gagal dikonfirmasi DPV.
• D: Alamat dikonfirmasi hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
• S: Alamat dikonfirmasi hanya untuk nomor utama, dan informasi nomor sekunder ada tetapi tidak dikonfirmasi.
• Y: Alamat dikonfirmasi DPV untuk nomor utama dan sekunder.
• Kosong: Jika respons tidak berisi nilai dpv_confirmation, alamat tidak dikirim untuk konfirmasi DPV.

string

Catatan kaki dari validasi titik pengiriman. Beberapa catatan kaki dapat dirangkai dalam string yang sama.

• AA: Alamat input yang cocok dengan file ZIP+4
• A1: Alamat input tidak cocok dengan file ZIP+4
• BB: Cocok dengan DPV (semua komponen)
• CC: Nomor sekunder tidak cocok dan tidak wajib diisi
• C1: Nomor sekunder tidak cocok, tetapi wajib diisi
• N1: Alamat bertingkat tinggi tidak memiliki nomor sekunder
• M1: Nomor utama tidak ada
• M3: Nomor utama tidak valid
• P1: Nomor kotak PO, RR, atau HC alamat input tidak ada
• P3: Nomor kotak input PO, RR, atau HC tidak valid
• F1: Alamat input yang cocok dengan alamat militer
• G1: Alamat input yang cocok dengan alamat pengiriman umum
• U1: Alamat input yang cocok dengan kode pos unik
• PB: Alamat input cocok dengan data PBSA
• RR: Alamat yang dikonfirmasi dengan DPV dengan informasi PMB
• R1: Alamat yang dikonfirmasi DPV tanpa informasi PMB
• R7: Data Rute Operator R777 atau R779
• IA: Alamat yang Diinformasikan teridentifikasi
• TA: Nomor utama dicocokkan dengan menghapus alfa di akhir

string

Menunjukkan apakah alamatnya adalah CMRA (Commercial Mail Accepted Agency)--bisnis pribadi yang menerima email untuk klien. Menampilkan satu karakter.

• Y: Alamatnya adalah CMRA
• N: Alamat bukan CMRA

string

Apakah tempat ini kosong? Menampilkan satu karakter.

• Y: Alamat kosong
• N: Alamat tidak kosong

string

Apakah ini bukan alamat statistik atau alamat aktif? Tidak ada alamat statistik adalah alamat yang tidak terus ditempati atau alamat yang tidak dilayani oleh USPS. Menampilkan satu karakter.

• Y: Alamat tidak aktif
• N: Alamat masih aktif

int32

Menunjukkan jenis NoStat. Menampilkan kode alasan sebagai int.

• 1: IDA (Alamat Penyimpanan Internal) – Alamat yang tidak menerima email langsung dari USPS, tetapi dikirim ke alamat lepas yang melayaninya.
• 2: CDS - Alamat yang belum dapat dikirim. Misalnya, subdivisi baru tempat banyak dan nomor utama telah ditentukan, tetapi belum ada struktur untuk jumlah tamu.
• 3: Tabrakan - Alamat yang sebenarnya tidak mengonfirmasi DPV.
• 4: CMZ (College, Military, dan Lainnya) - ZIP + 4 data yang telah dimasukkan USPS ke dalam data.
• 5: Reguler - Menunjukkan alamat yang tidak menerima pengiriman dan alamat tidak dihitung sebagai kemungkinan pengiriman.
• 6: Sekunder Wajib - Alamat memerlukan informasi sekunder.

string

Tanda menunjukkan bahwa email dikirim ke satu tempat yang dapat diterima di suatu situs. Menampilkan satu karakter.

• Y: Email dikirim ke satu penerima di sebuah situs.
• N: Email tidak dikirim ke satu tempat yang dapat diterima di suatu situs.

string

Menunjukkan bahwa surat tidak dikirim ke alamat jalan. Menampilkan satu karakter.

• Y: Surat tidak dikirim ke alamat.
• N: Surat akan dikirim ke alamat.

string

Tanda menunjukkan pengiriman email tidak dilakukan setiap hari dalam seminggu. Menampilkan satu karakter.

• Y: Pengiriman email tidak dilakukan setiap hari dalam seminggu.
• N: Tidak ada indikasi bahwa pengiriman email tidak dilakukan setiap hari dalam seminggu.

int32

Bilangan bulat yang mengidentifikasi hari gagal tayang. Bisa diinterogasi menggunakan bendera bit: 0x40 – Minggu adalah hari non-pengiriman 0x20 – Senin adalah hari tidak ada pengiriman 0x10 – Selasa adalah hari tidak ada pengiriman 0x08 – Rabu adalah hari tidak ada pengiriman 0x04 – Kamis adalah hari tidak ada pengiriman 0x02 – Jumat adalah hari tidak dikirim

string

Bendera menunjukkan bahwa pintu dapat diakses, tetapi paket tidak akan ditinggalkan karena masalah keamanan. Menampilkan satu karakter.

• Y: Paket tidak akan ditinggalkan karena masalah keamanan.
• N: Tidak ada indikasi bahwa paket tidak akan ditinggalkan karena masalah keamanan.

string

Menunjukkan bahwa alamat cocok dengan data PBSA. Menampilkan satu karakter.

• Y: Alamat dicocokkan dengan data PBSA.
• N: Alamat tidak cocok dengan data PBSA.

string

Tanda menunjukkan alamat yang tidak dapat diketuk oleh USPS untuk mengirimkan email. Menampilkan satu karakter.

• Y: Pintu tidak dapat diakses.
• N: Tidak ada indikasi bahwa pintu tidak dapat diakses.

string

Menunjukkan bahwa lebih dari satu kode pengembalian DPV valid untuk alamat tersebut. Menampilkan satu karakter.

• Y: Alamat dikonfirmasi DPV untuk nomor utama dan sekunder.
• N: Informasi nomor utama dan sekunder gagal dikonfirmasi DPV.
• S: Alamat dikonfirmasi hanya untuk nomor utama, dan informasi nomor sekunder ada tetapi tidak dikonfirmasi, atau satu alfa di akhir pada nomor utama dihapus untuk membuat pencocokan DPV dan informasi sekunder diperlukan.
• D: Alamat dikonfirmasi hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
• R: Alamat dikonfirmasi, tetapi ditetapkan ke pengiriman rute palsu R777 dan R779, serta pengiriman USPS tidak diberikan.

string

Kode rute ekspedisi. Kode empat karakter yang terdiri dari awalan satu huruf dan penanda rute tiga digit.

Awalan:

• C: Rute ekspedisi (atau rute kota)
• R: Rute pedesaan
• H: Rute Kontrak Jalan Raya
• B: Bagian Kotak Kantor Pos
• G: Unit pengiriman umum

string

Indikator pengurutan tarif rute ekspedisi.

bool

Alamat pengiriman dapat dicocokkan, tetapi file EWS menunjukkan bahwa pencocokan persis akan segera tersedia.

string

Kota kantor pos utama.

string

Negara bagian utama kantor pos.

string

Singkatan kota.

string

Kode county FIPS.

string

Nama county.

string

Nomor Jalur Perjalanan yang Ditingkatkan (eLOT).

string

Tanda Menaik/Menurun eLOT (A/D).

string

Kode pengembalian LACSLink.

string

Indikator LACSLink.

bool

Kode pos khusus PO Box.

string

Catatan kaki dari pencocokan data jalan atau gedung tinggi dengan informasi. Jika ditemukan kecocokan nama bisnis, nomor sekunder akan ditampilkan.

• A: Kecocokan data SuiteLink, alamat bisnis ditingkatkan.
• 00: Tidak ada yang cocok, alamat bisnis tidak diperbaiki.

string

Penunjuk unit PMB (Private Mail Box).

string

Nomor PMB (Private Mail Box);

string

Jenis data alamat yang cocok dengan alamat input.

• F: FIRM. Data ini dicocokkan dengan Catatan Perusahaan, yang merupakan tingkat kecocokan terbaik yang tersedia untuk suatu alamat.
• G: PENGIRIMAN UMUM. Data ini cocok dengan data Pengiriman Umum.
• H: PENGEMBANGAN / Apartemen. Ini cocok dengan catatan Bangunan atau Apartemen.
• P: KOTAK KANTOR POSTINGAN. Ini cocok dengan Kotak Pos.
• R: ROUTE RURAL atau HIGHWAY CONTRACT: Ini cocok dengan catatan Rute Pedesaan atau Kontrak Jalan Raya, yang keduanya mungkin memiliki rentang Nomor Kotak terkait.
• S: RECORD STREET: Ini cocok dengan data Jalan yang berisi rentang nomor utama yang valid.

bool

Indikator bahwa alamat default ditemukan, tetapi ada alamat yang lebih spesifik.

string

Pesan error untuk pengambilan data USPS. Kolom ini diisi saat pemrosesan USPS ditangguhkan karena deteksi alamat yang dibuat secara artifisial.

Kolom data USPS mungkin tidak diisi saat error ini ada.

bool

Indikator bahwa permintaan telah diproses CASS.

PostalAddress

Wajib. Alamat yang sedang divalidasi. Alamat yang tidak berformat harus dikirimkan melalui address_lines.

Panjang total kolom dalam input ini tidak boleh lebih dari 280 karakter.

Wilayah yang didukung dapat ditemukan di sini.

Nilai language_code di alamat input dicadangkan untuk penggunaan pada masa mendatang dan diabaikan hari ini. Hasil alamat yang divalidasi akan diisi berdasarkan bahasa pilihan untuk alamat yang diberikan, seperti yang diidentifikasi oleh sistem.

Address Validation API mengabaikan nilai dalam recipients dan organization. Setiap nilai di kolom tersebut akan dihapus dan tidak ditampilkan. Jangan menyetelnya.

string

Kolom ini harus kosong untuk permintaan validasi alamat pertama. Jika diperlukan lebih banyak permintaan untuk memvalidasi satu alamat sepenuhnya (misalnya jika perubahan yang dibuat pengguna setelah validasi awal harus divalidasi ulang), setiap permintaan tindak lanjut harus mengisi kolom ini dengan response_id dari respons pertama dalam urutan validasi.

bool

Mengaktifkan mode yang kompatibel dengan USPS CASS. Hal ini hanya memengaruhi kolom google.maps.addressvalidation.v1.ValidationResult.usps_data dari google.maps.addressvalidation.v1.ValidationResult. Catatan: untuk permintaan yang mengaktifkan USPS CASS untuk alamat di Puerto Riko, google.type.PostalAddress.region_code address harus diberikan sebagai "PR", atau google.type.PostalAddress.administrative_area dari address harus diberikan sebagai "Puerto Riko" (tidak peka huruf besar/kecil) atau "PR".

Sebaiknya gunakan address yang terdiri dari berbagai komponen, atau tentukan setidaknya dua google.type.PostalAddress.address_lines dengan baris pertama berisi nomor dan nama jalan serta baris kedua berisi kota, negara bagian/provinsi, dan kode pos.

LanguageOptions

Opsional. Pratinjau: Fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Mengaktifkan Address Validation API untuk menyertakan informasi tambahan dalam respons.

string

Opsional. String yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Harus berupa string base64 aman untuk URL dan nama file dengan panjang maksimal 36 karakter ASCII. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.

Sesi dimulai saat pengguna membuat kueri Autocomplete, dan berakhir saat mereka memilih tempat serta panggilan ke Place Details atau Validasi Alamat dilakukan. Setiap sesi dapat memiliki beberapa kueri Autocomplete, diikuti dengan satu permintaan Place Details atau Address Validation. Kredensial yang digunakan untuk setiap permintaan dalam sebuah sesi harus berasal dari project Konsol Google Cloud yang sama. Setelah sesi selesai, token tidak lagi valid; aplikasi Anda harus menghasilkan token baru untuk setiap sesi. Jika parameter sessionToken dihapus, atau jika Anda menggunakan kembali token sesi, sesi tersebut dikenai biaya seolah-olah tidak ada token sesi yang diberikan (setiap permintaan ditagih secara terpisah).

Catatan: Validasi Alamat hanya dapat digunakan dalam sesi dengan Autocomplete API (Baru), bukan Autocomplete API. Lihat https://developers.google.com/maps/documentation/places/web-service/session-pricing untuk mengetahui detail selengkapnya.

ValidationResult

Hasil validasi alamat.

string

UUID yang mengidentifikasi respons ini. Jika alamat perlu divalidasi ulang, UUID ini harus menyertai permintaan baru.

Verdict

Tanda putusan keseluruhan

Address

Informasi tentang alamat itu sendiri, bukan geocode.

Geocode

Informasi tentang lokasi dan tempat yang di-geocode alamat.

AddressMetadata

Informasi lainnya yang relevan dengan pengiriman. metadata tidak dijamin akan terisi penuh untuk setiap alamat yang dikirim ke Address Validation API.

UspsData

Tanda pengiriman tambahan yang disediakan oleh USPS. Hanya disediakan di region US dan PR.

Address

Pratinjau: Fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Alamat diterjemahkan ke dalam bahasa Inggris.

Alamat yang diterjemahkan tidak dapat digunakan kembali sebagai input API. Layanan menyediakannya sehingga pengguna dapat menggunakan bahasa asli mereka untuk mengonfirmasi atau menolak validasi alamat asli yang diberikan.

Jika bagian dari alamat tidak memiliki terjemahan bahasa Inggris, layanan akan mengembalikan bagian itu dalam bahasa alternatif yang menggunakan skrip Latin. Lihat di sini untuk mengetahui penjelasan tentang cara memilih bahasa alternatif. Jika bagian dari alamat tidak memiliki terjemahan atau transliterasi dalam bahasa yang menggunakan skrip Latin, layanan akan mengembalikan bagian itu dalam bahasa lokal yang terkait dengan alamat itu.

Aktifkan output ini menggunakan tanda google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Catatan: kolom google.maps.addressvalidation.v1.Address.unconfirmed_component_types di kolom english_latin_address dan google.maps.addressvalidation.v1.AddressComponent.confirmation_level di english_latin_address.address_components tidak diisi.

Granularity

Perincian alamat input. Ini adalah hasil dari penguraian alamat input dan tidak memberikan sinyal validasi apa pun. Untuk sinyal validasi, lihat validation_granularity di bawah.

Misalnya, jika alamat input menyertakan nomor apartemen tertentu, input_granularity di sini adalah SUB_PREMISE. Jika kita tidak dapat mencocokkan nomor apartemen di database atau nomor apartemen tidak valid, validation_granularity kemungkinan akan berupa PREMISE atau di bawahnya.

Granularity

Tingkat perincian yang dapat dipenuhi API untuk sepenuhnya validate alamat. Misalnya, validation_granularity dari PREMISE menunjukkan bahwa semua komponen alamat pada level PREMISE atau yang lebih umum dapat divalidasi.

Per hasil validasi komponen alamat dapat ditemukan di google.maps.addressvalidation.v1.Address.address_components.

Granularity

Informasi tentang tingkat perincian geocode. Hal ini dapat dipahami sebagai arti semantik tentang seberapa kasar atau halus lokasi yang di-geocode.

Hal ini terkadang dapat berbeda dari validation_granularity di atas. Misalnya, {i>database<i} kami mungkin mencatat keberadaan nomor apartemen, tetapi tidak memiliki lokasi akurat untuk apartemen tersebut di dalam kompleks apartemen yang besar. Dalam hal ini, validation_granularity akan menjadi SUB_PREMISE, tetapi geocode_granularity akan menjadi PREMISE.

bool

Alamat dianggap lengkap jika tidak ada token yang belum terselesaikan, tidak ada komponen alamat yang tidak terduga atau hilang. Jika tidak disetel, nilai tersebut akan menunjukkan bahwa nilainya adalah false. Lihat kolom missing_component_types, unresolved_tokens, atau unexpected untuk mengetahui detail selengkapnya.

bool

Setidaknya satu komponen alamat tidak dapat dikategorikan atau divalidasi, lihat google.maps.addressvalidation.v1.Address.address_components untuk mengetahui detailnya.

bool

Setidaknya satu komponen alamat disimpulkan (ditambahkan) yang tidak ada dalam input. Lihat google.maps.addressvalidation.v1.Address.address_components untuk mengetahui detailnya.

bool

Setidaknya satu komponen alamat diganti, lihat google.maps.addressvalidation.v1.Address.address_components untuk mengetahui detailnya.