Package google.maps.addressvalidation.v1

Indeks

AddressValidation

Layanan untuk memvalidasi alamat.

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

Masukan tentang hasil urutan upaya validasi. Ini harus menjadi panggilan terakhir yang dilakukan setelah urutan panggilan validasi untuk alamat yang sama, dan harus dipanggil setelah transaksi selesai. Pesan ini hanya boleh dikirim sekali untuk urutan permintaan ValidateAddress yang diperlukan untuk memvalidasi alamat sepenuhnya.
ValidateAddress

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

Memvalidasi alamat.

Alamat

Detail alamat pascapemrosesan. Pascapemrosesan mencakup memperbaiki bagian alamat yang salah eja, mengganti bagian yang salah, dan menyimpulkan bagian yang hilang.

Kolom
formatted_address

string

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

Catatan: format alamat ini mungkin tidak cocok dengan format alamat di kolom postal_address. Misalnya, postal_address selalu mewakili negara sebagai region_code 2 huruf, seperti "US" atau "NZ". Sebaliknya, kolom ini menggunakan bentuk nama negara yang lebih panjang, seperti "USA" atau "New Zealand".
postal_address

PostalAddress

Alamat yang diproses setelahnya yang direpresentasikan sebagai alamat pos.
address_components[]

AddressComponent

Daftar yang tidak diurutkan. Setiap komponen alamat dari alamat yang diformat dan dikoreksi, beserta informasi validasi. Halaman ini memberikan informasi tentang status validasi setiap komponen.

Komponen alamat tidak diurutkan dengan cara tertentu. Jangan membuat asumsi apa pun tentang urutan komponen alamat dalam daftar.
missing_component_types[]

string

Jenis komponen yang diharapkan ada dalam 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.
unconfirmed_component_types[]

string

Jenis komponen yang ada di address_components, tetapi tidak dapat dikonfirmasi kebenarannya. Kolom ini disediakan untuk memudahkan: kontennya setara dengan melakukan iterasi melalui address_components untuk menemukan jenis semua komponen dengan confirmation_level bukan CONFIRMED atau tanda inferred tidak disetel ke true. Daftar kemungkinan jenis dapat ditemukan di sini.
unresolved_tokens[]

string

Token apa pun dalam input yang tidak dapat di-resolve. Ini mungkin masukan yang tidak dikenali sebagai bagian alamat yang valid. Misalnya, untuk input seperti "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US", token yang belum terselesaikan mungkin terlihat seperti ["Parcel", "0000123123", "&", "0000456456"].

AddressComponent

Mewakili komponen alamat, seperti jalan, kota, atau negara bagian.

Kolom
component_name

ComponentName

Nama untuk komponen ini.
component_type

string

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

ConfirmationLevel

Menunjukkan tingkat kepastian yang kita miliki bahwa komponen tersebut sudah benar.
inferred

bool

Menunjukkan bahwa komponen tersebut bukan bagian dari input, tetapi kami menyimpulkannya untuk lokasi alamat dan yakin bahwa komponen tersebut harus diberikan untuk alamat yang lengkap.
spell_corrected

bool

Menunjukkan koreksi pada kesalahan ejaan dalam nama komponen. API tidak selalu menandai perubahan dari satu varian ejaan ke varian ejaan lainnya, seperti saat mengubah "centre" menjadi "center". Fitur ini juga tidak selalu menandai kesalahan ejaan umum, seperti saat mengubah "Amphitheater Pkwy" menjadi "Amphitheatre Pkwy".
replaced

bool

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

bool

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

ConfirmationLevel

Berbagai kemungkinan nilai untuk tingkat konfirmasi.

Enum
CONFIRMATION_LEVEL_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
CONFIRMED Kami dapat memverifikasi bahwa komponen ini ada dan masuk akal dalam konteks alamat lainnya.
UNCONFIRMED_BUT_PLAUSIBLE Komponen ini tidak dapat dikonfirmasi, tetapi kemungkinan komponen ini ada. Misalnya, nomor jalan dalam rentang angka yang valid dan diketahui di jalan yang nomor rumahnya tidak diketahui.
UNCONFIRMED_AND_SUSPICIOUS Komponen ini tidak dikonfirmasi dan mungkin salah. Misalnya, lingkungan yang tidak cocok dengan informasi lain dari alamat.

AddressMetadata

Metadata untuk alamat. metadata tidak dijamin akan terisi penuh untuk setiap alamat yang dikirim ke Address Validation API.

Kolom
business

bool

Menunjukkan bahwa ini adalah alamat bisnis. Jika tidak ditetapkan, menunjukkan bahwa nilainya tidak diketahui.
po_box

bool

Menunjukkan bahwa alamat tersebut adalah kotak pos. Jika tidak disetel, nilai akan menunjukkan bahwa nilai tidak diketahui.
residential

bool

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

ComponentName

Wrapper untuk nama komponen.

Kolom
text

string

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

string

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

Geocode

Berisi informasi tentang tempat input di-geocoding.

Kolom
location

LatLng

Lokasi input yang di-geocoding.

Penggunaan ID tempat lebih disukai daripada menggunakan alamat, koordinat lintang/bujur, atau kode plus. Menggunakan koordinat saat mengarahkan rute atau menghitung arah mengemudi akan selalu menghasilkan titik yang dipaskan ke jalan yang paling dekat dengan koordinat tersebut. Jalan ini mungkin bukan jalan yang akan mengarah ke tujuan dengan cepat atau aman dan 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.
plus_code

PlusCode

Plus Codes yang sesuai dengan location.
bounds

Viewport

Batas tempat yang di-geocoding.
feature_size_meters

float

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

string

PlaceID tempat input geocode ini.

Untuk informasi selengkapnya tentang ID Tempat, lihat di sini.
place_types[]

string

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

LanguageOptions

Pratinjau: Fitur ini sedang 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.

Memungkinkan Address Validation API menyertakan informasi tambahan dalam respons.

Kolom
return_english_latin_address

bool

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

PlusCode

Plus Codes (http://plus.codes) adalah referensi lokasi dengan dua format: kode global yang menentukan persegi panjang 14mx14m (1/8000 derajat) atau lebih kecil, dan kode gabungan, yang mengganti awalan dengan lokasi referensi.

Kolom
global_code

string

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

string

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

ProvideValidationFeedbackRequest

Permintaan untuk mengirim masukan validasi.

Kolom
conclusion

ValidationConclusion

Wajib. Hasil dari urutan upaya validasi.

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

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.

ValidationConclusion

Kemungkinan hasil akhir dari urutan permintaan validasi alamat yang diperlukan untuk memvalidasi alamat.

Enum
VALIDATION_CONCLUSION_UNSPECIFIED Nilai ini tidak digunakan. Jika kolom ProvideValidationFeedbackRequest.conclusion disetel ke VALIDATION_CONCLUSION_UNSPECIFIED, error INVALID_ARGUMENT akan ditampilkan.
VALIDATED_VERSION_USED Versi alamat yang ditampilkan oleh Address Validation API digunakan untuk transaksi.
USER_VERSION_USED Versi alamat yang diberikan oleh pengguna digunakan untuk transaksi
UNVALIDATED_VERSION_USED Versi alamat yang dimasukkan setelah upaya validasi terakhir, tetapi tidak divalidasi ulang, digunakan untuk transaksi.
UNUSED Transaksi dibatalkan dan alamat tidak digunakan.

ProvideValidationFeedbackResponse

Jenis ini tidak memiliki kolom.

Respons untuk masukan validasi.

Respons akan kosong jika masukan berhasil dikirim.

UspsAddress

Representasi USPS dari alamat AS.

Kolom
first_address_line

string

Baris alamat pertama.
firm

string

Nama perusahaan.
second_address_line

string

Baris alamat kedua.
urbanization

string

Nama urbanisasi Puerto Riko.
city_state_zip_address_line

string

Kota + negara bagian + kode pos.
city

string

Nama kota.
state

string

Kode negara bagian 2 huruf.
zip_code

string

Kode pos, misalnya 10009.
zip_code_extension

string

Ekstensi kode pos 4 digit, misalnya 5023.

UspsData

Data USPS untuk alamat. uspsData tidak dijamin akan terisi sepenuhnya untuk setiap alamat AS atau PR yang dikirim ke Address Validation API. Sebaiknya integrasikan kolom alamat cadangan dalam respons jika Anda menggunakan uspsData sebagai bagian utama respons.

Kolom
standardized_address

UspsAddress

Alamat standar USPS.
delivery_point_code

string

Kode titik pengiriman 2 digit
delivery_point_check_digit

string

Digit periksa 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.
dpv_confirmation

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 DPV hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
  • S: Alamat dikonfirmasi DPV 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.
dpv_footnote

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: Dicocokkan dengan DPV (semua komponen)
  • CC: Nomor sekunder tidak cocok dan tidak diperlukan
  • C1: Nomor sekunder tidak cocok, tetapi wajib diisi
  • N1: Alamat gedung bertingkat 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 PO, RR, atau HC Box alamat input 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 DPV dengan informasi PMB
  • R1: Alamat yang dikonfirmasi DPV tanpa informasi PMB
  • R7: Data Rute Operator R777 atau R779
  • IA: Alamat yang Diinformasikan diidentifikasi
  • TA: Nomor utama yang dicocokkan dengan menghapus alfa di akhir
dpv_cmra

string

Menunjukkan apakah alamat tersebut adalah CMRA (Commercial Mail Receiving Agency)--bisnis pribadi yang menerima surat untuk klien. Menampilkan satu karakter.

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

string

Apakah tempat ini kosong? Menampilkan satu karakter.

  • Y: Alamat kosong
  • N: Alamat tidak kosong
dpv_no_stat

string

Apakah ini alamat tanpa 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
dpv_no_stat_reason_code

int32

Menunjukkan jenis NoStat. Menampilkan kode alasan sebagai int.

  • 1: IDA (Internal Drop Address) – Alamat yang tidak menerima surat langsung dari USPS, tetapi dikirim ke alamat drop yang melayaninya.
  • 2: CDS - Alamat yang belum dapat dikirim. Misalnya, subdivisi baru yang lot dan nomor utamanya telah ditentukan, tetapi belum ada struktur untuk penghuni.
  • 3: Tabrakan - Alamat yang sebenarnya tidak dikonfirmasi DPV.
  • 4: CMZ (College, Military, and Other Types) - Data ZIP + 4 yang telah digabungkan USPS.
  • 5: Biasa - Menunjukkan alamat yang tidak menerima pengiriman dan alamat tersebut tidak dihitung sebagai kemungkinan pengiriman.
  • 6: Sekunder Wajib - Alamat memerlukan informasi sekunder.
dpv_drop

string

Tanda menunjukkan bahwa email dikirim ke satu penerima di situs. Menampilkan satu karakter.

  • Y: Surat dikirim ke satu kotak surat di situs.
  • N: Email tidak dikirim ke satu tempat yang dapat diterima di suatu situs.
dpv_throwback

string

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

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

string

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

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

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 ada pengiriman 0x01 - Sabtu adalah hari tidak pengiriman
dpv_no_secure_location

string

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

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

string

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

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

string

Tanda menunjukkan alamat tempat USPS tidak dapat mengetuk pintu untuk mengantarkan surat. Menampilkan satu karakter.

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

string

Menunjukkan bahwa lebih dari satu kode hasil 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 DPV hanya untuk nomor utama, dan informasi nomor sekunder ada tetapi tidak dikonfirmasi, atau satu alfa di akhir nomor utama dihapus untuk membuat kecocokan DPV dan informasi sekunder diperlukan.
  • D: Alamat dikonfirmasi hanya untuk nomor utama, dan informasi nomor sekunder tidak ada.
  • R: Alamat dikonfirmasi, tetapi ditetapkan ke rute phantom R777 dan R779, dan pengiriman USPS tidak disediakan.
carrier_route

string

Kode rute operator. Kode empat karakter yang terdiri dari awalan satu huruf dan penunjuk rute tiga digit.

Awalan:

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

string

Indikator pengurutan tarif rute ekspedisi.
ews_no_match

bool

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

string

Kota kantor pos utama.
post_office_state

string

Status kantor pos utama.
abbreviated_city

string

Kota singkatan.
fips_county_code

string

Kode county FIPS.
county

string

Nama county.
elot_number

string

Nomor Line of Travel (eLOT) yang Ditingkatkan.
elot_flag

string

Flag eLOT Naik/Turun (A/D).
po_box_only_postal_code

bool

Kode pos khusus Kotak Pos.
pmb_designator

string

Penunjuk unit PMB (Private Mail Box).
pmb_number

string

Nomor PMB (Kotak Surat Pribadi);
address_record_type

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: GEDUNG / APARTEMEN. Ini cocok dengan data Bangunan atau Apartemen.
  • P: POST OFFICE BOX. Ini cocok dengan Kotak Pos.
  • R: RURAL ROUTE atau HIGHWAY CONTRACT: Ini adalah kecocokan dengan data Rural Route atau Highway Contract, yang keduanya mungkin memiliki rentang Nomor Kotak terkait.
  • S: RECORD STREET: Ini cocok dengan data Jalan yang berisi rentang nomor utama yang valid.
default_address

bool

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

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 jika error ini terjadi.
cass_processed

bool

Indikator bahwa permintaan telah diproses CASS.

ValidateAddressRequest

Permintaan untuk memvalidasi alamat.

Kolom
address

PostalAddress

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

Total panjang kolom dalam input ini tidak boleh melebihi 280 karakter.

Wilayah yang didukung dapat ditemukan di sini.

Nilai language_code di alamat input dicadangkan untuk penggunaan pada masa mendatang dan diabaikan saat 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. Semua nilai di kolom tersebut akan dihapus dan tidak ditampilkan. Jangan tetapkan.
previous_response_id

string

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

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 atas berbagai komponen, atau tentukan setidaknya dua google.type.PostalAddress.address_lines dengan baris pertama berisi nomor dan nama jalan dan baris kedua berisi kota, negara bagian/provinsi, dan kode pos.
language_options

LanguageOptions

Opsional. Pratinjau: Fitur ini sedang 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.
session_token

string

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

Sesi dimulai saat pengguna membuat kueri Autocomplete, dan berakhir saat mereka memilih tempat dan panggilan ke Place Details atau Address Validation dilakukan. Setiap sesi dapat memiliki beberapa kueri Autocomplete, yang 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 membuat token baru untuk setiap sesi. Jika parameter sessionToken dihilangkan, 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.

ValidateAddressResponse

Respons terhadap permintaan validasi alamat.

Kolom
result

ValidationResult

Hasil validasi alamat.
response_id

string

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

ValidationResult

Hasil validasi alamat.

Kolom
verdict

Verdict

Flag verdict keseluruhan
address

Address

Informasi tentang alamat itu sendiri, bukan geocode.
geocode

Geocode

Informasi tentang lokasi dan tempat yang di-geocode alamat.
metadata

AddressMetadata

Informasi lain yang relevan dengan ketersampaian. metadata tidak dijamin terisi penuh untuk setiap alamat yang dikirim ke Address Validation API.
usps_data

UspsData

Flag ketersampaian tambahan yang disediakan oleh USPS. Hanya disediakan di wilayah US dan PR.
english_latin_address

Address

Pratinjau: Fitur ini sedang 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 yang diterjemahkan ke dalam bahasa Inggris.

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

Jika bagian alamat tidak memiliki terjemahan bahasa Inggris, layanan akan menampilkan bagian tersebut 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 flag google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

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

Putusan

Ringkasan umum hasil validasi alamat dan geocode.

Kolom
input_granularity

Granularity

Tingkat perincian alamat input. Ini adalah hasil 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 akan menjadi 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.
validation_granularity

Granularity

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

Hasil validasi per komponen alamat dapat ditemukan di google.maps.addressvalidation.v1.Address.address_components.
geocode_granularity

Granularity

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

Nilai ini terkadang dapat berbeda dari validation_granularity di atas. Misalnya, database kami mungkin mencatat keberadaan nomor apartemen, tetapi tidak memiliki lokasi yang tepat untuk apartemen tersebut dalam kompleks apartemen besar. Dalam hal ini, validation_granularity akan menjadi SUB_PREMISE, tetapi geocode_granularity akan menjadi PREMISE.
address_complete

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

bool

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

bool

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

bool

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

Perincian

Berbagai tingkat perincian yang dapat dimiliki alamat atau geocode. Jika digunakan untuk menunjukkan tingkat perincian alamat, nilai ini menunjukkan tingkat perincian alamat yang mengidentifikasi tujuan pengiriman. Misalnya, alamat seperti "123 Main Street, Redwood City, CA, 94061" mengidentifikasi PREMISE, sedangkan alamat seperti "Redwood City, CA, 94061" mengidentifikasi LOCALITY. Namun, jika kita tidak dapat menemukan geocode untuk "123 Main Street" di Redwood City, geocode yang ditampilkan mungkin berupa perincian LOCALITY meskipun alamatnya lebih terperinci.

Enum
GRANULARITY_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
SUB_PREMISE Hasil tingkat di bawah bangunan, seperti apartemen.
PREMISE Hasil tingkat bangunan.
PREMISE_PROXIMITY Geocode yang mendekati lokasi tingkat gedung dari alamat.
BLOCK Alamat atau geocode menunjukkan blok. Hanya digunakan di wilayah yang memiliki alamat tingkat blok, seperti Jepang.
ROUTE Geocode atau alamat bersifat terperinci untuk rute, seperti jalan, jalan raya, atau jalan tol.
OTHER Semua tingkat perincian lainnya, yang dikelompokkan bersama karena tidak dapat dikirim.