Indeks
AddressValidation
(antar muka)Address
(pesan)AddressComponent
(pesan)AddressComponent.ConfirmationLevel
(enum)AddressMetadata
(pesan)ComponentName
(pesan)Geocode
(pesan)LanguageOptions
(pesan)PlusCode
(pesan)ProvideValidationFeedbackRequest
(pesan)ProvideValidationFeedbackRequest.ValidationConclusion
(enum)ProvideValidationFeedbackResponse
(pesan)UspsAddress
(pesan)UspsData
(pesan)ValidateAddressRequest
(pesan)ValidateAddressResponse
(pesan)ValidationResult
(pesan)Verdict
(pesan)Verdict.Granularity
(enum)
AddressValidation
Layanan untuk memvalidasi alamat.
ProvideValidationFeedback |
---|
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. Ini hanya boleh dikirim sekali untuk urutan permintaan |
ValidateAddress |
---|
Memvalidasi alamat. |
Alamat
Detail alamat yang telah diproses. Pasca-pemrosesan mencakup memperbaiki bagian alamat yang salah eja, mengganti bagian yang salah, dan menyimpulkan bagian yang hilang.
Kolom | |
---|---|
formatted_address |
Alamat yang telah diproses, yang diformat sebagai alamat satu baris dengan mengikuti aturan pemformatan alamat di wilayah tempat alamat berada. |
postal_address |
Alamat yang telah diproses sebelumnya sebagai alamat pos. |
address_components[] |
Daftar yang tidak diurutkan. Komponen alamat individual dari alamat yang diformat dan dikoreksi, bersama dengan informasi validasi. Hal ini memberikan informasi tentang status validasi setiap komponen. Komponen alamat tidak diurutkan dengan cara tertentu. Jangan membuat asumsi tentang urutan komponen alamat dalam daftar. |
missing_component_types[] |
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 |
unconfirmed_component_types[] |
Jenis komponen yang ada di |
unresolved_tokens[] |
Token dalam input yang tidak dapat diselesaikan. Ini mungkin 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 |
AddressComponent
Mewakili komponen alamat, seperti jalan, kota, atau negara bagian.
Kolom | |
---|---|
component_name |
Nama untuk komponen ini. |
component_type |
Jenis komponen alamat. Lihat Tabel 2: Jenis tambahan yang ditampilkan oleh layanan Places untuk daftar kemungkinan jenis. |
confirmation_level |
Menunjukkan tingkat kepastian yang kita miliki bahwa komponen sudah benar. |
inferred |
Menunjukkan bahwa komponen bukan bagian dari input, tetapi kita menyimpulkannya untuk lokasi alamat dan yakin bahwa komponen harus diberikan untuk alamat lengkap. |
spell_corrected |
Menunjukkan koreksi kesalahan ejaan dalam nama komponen. API tersebut tidak selalu menandai perubahan dari satu varian ejaan ke varian ejaan lainnya, seperti saat mengubah "center" menjadi "center". Error ini juga tidak selalu menandai kesalahan ejaan umum, seperti ketika mengubah "Amphitheater Pkwy" menjadi "Amphitheatre Pkwy". |
replaced |
Menunjukkan nama komponen yang telah diganti dengan nama yang sama sekali berbeda, misalnya kode pos yang salah diganti dengan kode pos yang benar untuk alamat tersebut. Ini bukan perubahan tampilan, komponen input telah diubah menjadi komponen yang berbeda. |
unexpected |
Menunjukkan komponen alamat yang tidak diharapkan ada dalam alamat pos untuk wilayah yang ditentukan. Kami mempertahankannya hanya karena itu 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 besar komponen tersebut ada. Misalnya, nomor jalan dalam rentang nomor valid yang diketahui di jalan yang tidak mengetahui nomor rumah tertentu. |
UNCONFIRMED_AND_SUSPICIOUS |
Komponen ini belum dikonfirmasi dan kemungkinan salah. Misalnya, lingkungan yang tidak sesuai dengan informasi lain dari alamat tersebut. |
AddressMetadata
Metadata untuk alamat. metadata
tidak dijamin akan terisi penuh untuk setiap alamat yang dikirim ke Address Validation API.
Kolom | |
---|---|
business |
Menunjukkan bahwa ini adalah alamat bisnis. Jika tidak disetel, nilai akan tidak diketahui. |
po_box |
Menunjukkan bahwa alamat PO box. Jika tidak disetel, nilai akan tidak diketahui. |
residential |
Menunjukkan bahwa ini adalah alamat tempat tinggal. Jika tidak disetel, nilai akan tidak diketahui. |
ComponentName
Wrapper untuk nama komponen.
Kolom | |
---|---|
text |
Teks nama. Misalnya, "5th Avenue" untuk nama jalan atau "1253" untuk nomor jalan. |
language_code |
Kode bahasa BCP-47. Ini tidak akan ada jika nama komponen tidak dikaitkan dengan bahasa, seperti nomor jalan. |
Geocode
Berisi informasi tentang tempat tempat input geocode.
Kolom | |
---|---|
location |
Lokasi input yang di-geocode. Lebih disarankan menggunakan ID tempat daripada alamat, koordinat lintang/bujur, atau kode plus. Menggunakan koordinat saat merutekan atau menghitung arah mengemudi akan selalu mengakibatkan titik dipaskan ke jalan yang paling dekat dengan koordinat tersebut. Jalan ini mungkin bukan jalan yang akan mengarah dengan cepat atau aman ke tujuan dan mungkin tidak dekat titik akses ke properti. Selain itu, bila lokasi di-geocode terbalik, tidak ada jaminan bahwa alamat yang ditampilkan akan cocok dengan alamat aslinya. |
plus_code |
Plus Codes yang sesuai dengan |
bounds |
Batas tempat yang di-geocoding. |
feature_size_meters |
Ukuran tempat yang di-geocode, dalam meter. Ini adalah ukuran lain dari kekasaran lokasi geocode, namun dalam ukuran fisik, bukan dalam arti semantik. |
place_id |
PlaceID tempat yang akan di-geocode oleh input ini. Untuk informasi selengkapnya tentang ID Tempat, lihat di sini. |
place_types[] |
Jenis tempat yang di-geocode inputnya. Misalnya, |
LanguageOptions
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 informasi selengkapnya, lihat deskripsi tahap peluncuran.
Mengaktifkan Address Validation API untuk menyertakan informasi tambahan dalam respons.
Kolom | |
---|---|
return_english_latin_address |
Pratinjau: Menampilkan |
PlusCode
Plus Codes (http://plus.codes) adalah referensi lokasi dengan dua format: kode global yang menentukan 14 m x 14 m (1/8000 derajat) atau kotak yang lebih kecil, dan kode gabungan, yang menggantikan awalan dengan lokasi referensi.
Kolom | |
---|---|
global_code |
Kode global (lengkap) tempat, seperti "9FWM33GV+HQ", yang mewakili area 1/8000 x 1/8000 derajat (~14 kali 14 meter). |
compound_code |
Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norwegia", yang berisi akhiran kode global dan mengganti awalan dengan nama entitas referensi yang diformat. |
ProvideValidationFeedbackRequest
Permintaan untuk mengirimkan masukan validasi.
Kolom | |
---|---|
conclusion |
Wajib. Hasil dari urutan upaya validasi. Jika kolom ini disetel ke |
response_id |
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 untuk alamat AS.
Kolom | |
---|---|
first_address_line |
Baris alamat pertama. |
firm |
Nama perusahaan. |
second_address_line |
Baris alamat kedua. |
urbanization |
Nama urbanisasi Puerto Riko. |
city_state_zip_address_line |
Kota + negara bagian + kode pos. |
city |
Nama kota. |
state |
Kode negara bagian 2 huruf. |
zip_code |
Kode pos, misalnya 10009. |
zip_code_extension |
Ekstensi kode pos 4 digit, misalnya 5023. |
UspsData
Data USPS untuk alamat. uspsData
tidak dijamin akan terisi penuh untuk setiap alamat PR atau Amerika Serikat yang dikirim ke Address Validation API. Sebaiknya integrasikan kolom alamat cadangan dalam respons jika Anda menggunakan uspsData sebagai bagian utama respons.
Kolom | |
---|---|
standardized_address |
alamat standar USPS. |
delivery_point_code |
Kode poin pengiriman 2 digit |
delivery_point_check_digit |
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 secara bersamaan akan menghasilkan angka yang dapat dibagi 10. |
dpv_confirmation |
Nilai yang mungkin untuk konfirmasi DPV. Menampilkan satu karakter atau tidak menampilkan nilai.
|
dpv_footnote |
Catatan kaki dari validasi titik pengiriman. Beberapa catatan kaki dapat dirangkai ke dalam string yang sama.
|
dpv_cmra |
Menunjukkan apakah alamatnya adalah CMRA (Commercial Mail Receiving Agency)--bisnis pribadi yang menerima email untuk klien. Menampilkan satu karakter.
|
dpv_vacant |
Apakah tempat ini kosong? Menampilkan satu karakter.
|
dpv_no_stat |
Apakah ini alamat tanpa statistik atau alamat aktif? Tidak ada alamat statistik yang tidak terus-menerus ditempati atau alamat yang tidak dilayani USPS. Menampilkan satu karakter.
|
dpv_no_stat_reason_code |
Menunjukkan jenis NoStat. Menampilkan kode alasan sebagai int.
|
dpv_drop |
Tanda menunjukkan bahwa email dikirim ke satu penerima pesan di situs. Menampilkan satu karakter.
|
dpv_throwback |
Menunjukkan bahwa surat tidak dikirim ke alamat tersebut. Menampilkan satu karakter.
|
dpv_non_delivery_days |
Bendera menunjukkan pengiriman email tidak dilakukan setiap hari dalam seminggu. Menampilkan satu karakter.
|
dpv_non_delivery_days_values |
Bilangan bulat yang mengidentifikasi hari gagal tayang. Hal ini dapat diinterogasi menggunakan bit flag: 0x40 - Minggu adalah hari tidak terkirim 0x20 - Senin adalah hari tidak terkirim 0x10 - Selasa adalah hari tidak dikirim 0x08 - Rabu adalah hari tidak terkirim 0x04 - Kamis adalah hari tidak terkirim 0x02 - Jumat adalah hari tidak terkirim 0x01 - Sabtu adalah hari tidak terkirim |
dpv_no_secure_location |
Tanda menunjukkan bahwa pintu dapat diakses, tetapi paket tidak akan ditinggalkan karena masalah keamanan. Menampilkan satu karakter.
|
dpv_pbsa |
Menunjukkan bahwa alamat cocok dengan data PBSA. Menampilkan satu karakter.
|
dpv_door_not_accessible |
Bendera menunjukkan alamat tempat USPS tidak dapat mengetuk pintu untuk mengirim email. Menampilkan satu karakter.
|
dpv_enhanced_delivery_code |
Menunjukkan bahwa lebih dari satu kode pengembalian DPV yang valid untuk alamat tersebut. Menampilkan satu karakter.
|
carrier_route |
Kode rute ekspedisi. Kode empat karakter yang terdiri dari awalan satu huruf dan penanda rute tiga digit. Awalan:
|
carrier_route_indicator |
Indikator pengurutan tarif rute ekspedisi. |
ews_no_match |
Alamat pengiriman dapat dicocokkan, tetapi file EWS menunjukkan bahwa alamat yang sama persis akan tersedia dalam waktu dekat. |
post_office_city |
Kota kantor pos utama. |
post_office_state |
Negara bagian utama kantor pos. |
abbreviated_city |
Singkatan kota. |
fips_county_code |
Kode wilayah FIPS. |
county |
Nama county. |
elot_number |
Nomor Line of Travel (eLOT) yang ditingkatkan. |
elot_flag |
eLOT Tanda Menaik/Menurun (A/D). |
lacs_link_return_code |
Kode pengembalian LACSLink. |
lacs_link_indicator |
Indikator LACSLink. |
po_box_only_postal_code |
Hanya kode pos PO Box. |
suitelink_footnote |
Catatan kaki dari pencocokan catatan jalan atau gedung tinggi dengan informasi suite. Jika ditemukan kecocokan nama bisnis, nomor sekunder akan ditampilkan.
|
pmb_designator |
Penanda unit PMB (Private Mail Box). |
pmb_number |
Nomor PMB (Private Mail Box); |
address_record_type |
Jenis data alamat yang cocok dengan alamat input.
|
default_address |
Indikator bahwa alamat default ditemukan, tetapi ada alamat yang lebih spesifik. |
error_message |
Pesan error untuk pengambilan data USPS. Kolom ini diisi saat pemrosesan USPS ditangguhkan karena terdeteksi adanya alamat yang dibuat secara artifisial. Kolom data USPS mungkin tidak diisi saat ada error ini. |
cass_processed |
Indikator bahwa permintaan telah diproses CASS. |
ValidateAddressRequest
Permintaan untuk memvalidasi alamat.
Kolom | |
---|---|
address |
Wajib. Alamat yang sedang divalidasi. Alamat yang tidak berformat harus dikirim melalui Panjang total kolom dalam input ini tidak boleh lebih dari 280 karakter. Wilayah yang didukung dapat ditemukan di sini. Nilai Address Validation API mengabaikan nilai dalam |
previous_response_id |
Bidang 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 |
enable_usps_cass |
Mengaktifkan mode yang kompatibel dengan USPS CASS. Ini hanya memengaruhi kolom Sebaiknya gunakan |
language_options |
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 informasi selengkapnya, lihat deskripsi tahap peluncuran. Mengaktifkan Address Validation API untuk menyertakan informasi tambahan dalam respons. |
session_token |
Opsional. String yang mengidentifikasi sesi Autocomplete untuk tujuan penagihan. Harus berupa string base64 yang 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 melakukan panggilan ke Place Details atau Validasi Alamat. Setiap sesi dapat memiliki beberapa kueri Autocomplete, diikuti dengan satu permintaan Place Details atau Validasi Alamat. Kredensial yang digunakan untuk setiap permintaan dalam suatu 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 Catatan: Validasi Alamat hanya dapat digunakan dalam sesi dengan API Autocomplete (Baru), bukan Autocomplete API. Lihat https://developers.google.com/maps/documentation/places/web-service/session-pricing untuk detail selengkapnya. |
ValidateAddressResponse
Respons terhadap permintaan validasi alamat.
Kolom | |
---|---|
result |
Hasil validasi alamat. |
response_id |
UUID yang mengidentifikasi respons ini. Jika alamat perlu divalidasi ulang, UUID ini harus disertakan dengan permintaan baru. |
ValidationResult
Hasil validasi alamat.
Kolom | |
---|---|
verdict |
Tanda verdict keseluruhan |
address |
Informasi tentang alamat itu sendiri yang berbeda dengan geocode. |
geocode |
Informasi tentang lokasi dan tempat yang akan di-geocoding pada alamat tersebut. |
metadata |
Informasi lainnya yang relevan dengan kemampuan pengiriman. |
usps_data |
Tanda pengiriman tambahan disediakan oleh USPS. Hanya disediakan di wilayah |
english_latin_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 informasi selengkapnya, lihat deskripsi tahap peluncuran. Alamat diterjemahkan ke bahasa Inggris. Alamat yang diterjemahkan tidak dapat digunakan kembali sebagai input API. Layanan ini menyediakannya sehingga pengguna dapat menggunakan bahasa asli mereka untuk mengonfirmasi atau menolak validasi alamat yang awalnya disediakan. Jika bagian alamat tidak memiliki terjemahan bahasa Inggris, layanan akan menampilkan bagian tersebut dalam bahasa alternatif yang menggunakan skrip Latin. Lihat di sini untuk mendapatkan 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. Aktifkan output ini menggunakan flag Catatan: kolom |
Putusan
Ringkasan tingkat tinggi hasil validasi alamat dan geocode.
Kolom | |
---|---|
input_granularity |
Perincian alamat input. Ini adalah hasil dari penguraian alamat input dan tidak memberikan sinyal validasi apa pun. Untuk sinyal validasi, lihat Misalnya, jika alamat input menyertakan nomor apartemen tertentu, |
validation_granularity |
Tingkat perincian yang dapat digunakan API untuk validate alamat sepenuhnya. Misalnya, Hasil validasi komponen per alamat dapat ditemukan di |
geocode_granularity |
Informasi tentang perincian Ini terkadang dapat berbeda dari |
address_complete |
Alamat dianggap lengkap jika tidak ada token yang belum terselesaikan, tidak ada komponen alamat yang tidak terduga atau hilang. Jika tidak disetel, menunjukkan bahwa nilainya adalah |
has_unconfirmed_components |
Setidaknya satu komponen alamat tidak dapat dikategorikan atau divalidasi. Lihat |
has_inferred_components |
Setidaknya satu komponen alamat yang disimpulkan (ditambahkan) yang tidak ada dalam input, lihat |
has_replaced_components |
Setidaknya satu komponen alamat telah diganti, lihat |
Tingkat perincian
Berbagai perincian yang dapat dimiliki oleh alamat atau geocode. Jika digunakan untuk menunjukkan perincian untuk alamat, nilai ini menunjukkan seberapa baik tingkat perincian alamat mengidentifikasi tujuan email. 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 bangunan untuk alamat tersebut. |
BLOCK |
Alamat atau geocode menunjukkan blok. Hanya digunakan di wilayah yang memiliki pemberian alamat tingkat blok, seperti Jepang. |
ROUTE |
Geocode atau alamat terperinci untuk merutekan, seperti jalan, jalan, atau jalan raya. |
OTHER |
Semua perincian lainnya, yang dikelompokkan bersama karena tidak dapat diserahkan. |