Address Validation (beta)

AddressValidation class

Class google.maps.addressValidation.AddressValidation

Class statis untuk mengakses AddressValidation API.

Akses dengan memanggil const {AddressValidation} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
BetafetchAddressValidation
fetchAddressValidation(request)
Parameter: 
Nilai yang Ditampilkan:  Promise<AddressValidation>
Memvalidasi alamat. Lihat https://developers.google.com/maps/documentation/javascript/address-validation/validate-address.
Betaaddress
Jenis:  Address optional
Informasi tentang alamat itu sendiri, bukan geocode.
Betageocode
Jenis:  Geocode optional
Informasi tentang lokasi dan tempat yang di-geocoding ke alamat.
Betametadata
Jenis:  AddressMetadata optional
Informasi lain yang relevan dengan kemampuan pengiriman. metadata tidak dijamin akan terisi sepenuhnya untuk setiap alamat yang dikirim ke Address Validation API.
BetaresponseId
Jenis:  string optional
UUID yang mengidentifikasi respons ini. Jika alamat perlu divalidasi ulang, UUID ini harus disertakan dalam permintaan baru.
BetauspsData
Jenis:  USPSData optional
Flag tambahan terkait kualitas pengiriman yang disediakan oleh USPS. Hanya disediakan di wilayah US dan PR.
Betaverdict
Jenis:  Verdict optional
Flag verdict keseluruhan
BetatoJSON
toJSON()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Object
Mengonversi class AddressValidation menjadi objek JSON dengan properti yang sama.

Antarmuka AddressValidationRequest

google.maps.addressValidation.AddressValidationRequest interface

Antarmuka permintaan untuk BetaAddressValidation.fetchAddressValidation.
Betaaddress
Alamat sedang divalidasi. Alamat yang tidak diformat harus dikirimkan melalui PostalAddress.addressLines.
BetapreviousResponseId optional
Jenis:  string optional
Kolom ini tidak boleh disetel 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 lanjutan harus mengisi kolom ini dengan BetaAddressValidation.responseId dari respons pertama dalam urutan validasi.
BetauspsCASSEnabled optional
Jenis:  boolean optional
Mengaktifkan mode yang kompatibel dengan CASS USPS. Hal ini hanya memengaruhi kolom BetaAddressValidation.uspsData dari AddressValidation. Catatan: untuk permintaan yang diaktifkan USPS CASS untuk alamat di Puerto Riko, PostalAddress.regionCode dari address harus diberikan sebagai "PR", atau PostalAddress.administrativeArea dari address harus diberikan sebagai "Puerto Rico" (tidak peka huruf besar/kecil) atau "PR".

Address class

Class google.maps.addressValidation.Address

Detail alamat yang diproses setelahnya. Pemrosesan pasca-pemetaan mencakup mengoreksi bagian alamat yang salah eja, mengganti bagian yang salah, dan menyimpulkan bagian yang tidak ada.

Akses dengan memanggil const {Address} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
Betacomponents
Komponen alamat individual dari alamat yang diformat dan dikoreksi, beserta informasi validasi. Hal ini memberikan informasi tentang status validasi setiap komponen.
BetaformattedAddress
Jenis:  string optional
Alamat yang diproses pasca-pemrosesan, diformat sebagai alamat satu baris yang mengikuti aturan pemformatan alamat di wilayah tempat alamat berada.
BetamissingComponentTypes
Jenis:  Array<string>
Jenis komponen yang seharusnya 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 adalah ['street_number', 'route'] untuk input seperti "Boulder, Colorado, 80301, USA". Daftar kemungkinan jenis dapat ditemukan di sini.
BetapostalAddress
Jenis:  PostalAddress optional
Alamat yang diproses setelahnya ditampilkan sebagai alamat pos.
BetaunconfirmedComponentTypes
Jenis:  Array<string>
Jenis komponen yang ada di address_components tetapi tidak dapat dikonfirmasi kebenarannya. Kolom ini disediakan untuk memudahkan: isinya setara dengan melakukan iterasi melalui address_components untuk menemukan jenis semua komponen yang BetaAddressComponent.confirmationLevel-nya bukan BetaConfirmationLevel.CONFIRMED atau tanda BetaAddressComponent.inferred tidak disetel ke true. Daftar kemungkinan jenis dapat ditemukan di sini.
BetaunresolvedTokens
Jenis:  Array<string>
Token apa pun dalam input yang tidak dapat diselesaikan. Ini mungkin merupakan input yang tidak dikenali sebagai bagian alamat yang valid (misalnya, dalam input seperti "123235253253 Main St, San Francisco, CA, 94105", token yang tidak terselesaikan mungkin terlihat seperti ["123235253253"] karena tidak terlihat seperti nomor jalan yang valid.

Kelas AddressComponent

Class google.maps.addressValidation.AddressComponent

Mewakili satu komponen alamat (mis. nama jalan, kota).

Akses dengan memanggil const {AddressComponent} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
BetacomponentName
Jenis:  string optional
Teks nama komponen. Misalnya, "5th Avenue" untuk nama jalan atau "1253" untuk nomor jalan,
BetacomponentNameLanguageCode
Jenis:  string optional
Kode bahasa BCP-47. Ini tidak akan ada jika nama komponen tidak dikaitkan dengan bahasa, seperti nomor jalan.
BetacomponentType
Jenis:  string optional
Jenis komponen alamat. Lihat Tabel 2: Jenis tambahan yang ditampilkan oleh layanan Places untuk mengetahui daftar kemungkinan jenis.
BetaconfirmationLevel
Jenis:  ConfirmationLevel optional
Menunjukkan tingkat kepastian bahwa komponen sudah benar.
Betainferred
Jenis:  boolean
Jika benar, komponen ini bukan bagian dari input, tetapi disimpulkan untuk lokasi alamat. Komponen ini direkomendasikan untuk alamat lengkap.
Betareplaced
Jenis:  boolean
Menunjukkan bahwa nama komponen diganti dengan nama yang sama sekali berbeda. Misalnya, mengganti kode pos yang salah dengan kode pos yang benar untuk alamat tersebut. Ini bukan perubahan tampilan; komponen input telah diubah ke komponen lain.
BetaspellCorrected
Jenis:  boolean
Menunjukkan koreksi pada kesalahan ejaan dalam nama komponen. API tidak selalu menandai perubahan dari satu varian ejaan ke varian ejaan lainnya, seperti "centre" menjadi "center".
Betaunexpected
Jenis:  boolean
Jika benar (true), komponen ini tidak diharapkan ada dalam alamat pos untuk wilayah tertentu. Kata ini dipertahankan hanya karena merupakan bagian dari input.

Kelas AddressMetadata

Class google.maps.addressValidation.AddressMetadata

Metadata untuk alamat. AddressMetadata tidak dijamin akan terisi sepenuhnya untuk setiap alamat yang dikirim ke Address Validation API.

Akses dengan memanggil const {AddressMetadata} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
Betabusiness
Jenis:  boolean
BetapoBox
Jenis:  boolean
Betaresidential
Jenis:  boolean

Konstanta ConfirmationLevel

google.maps.addressValidation.ConfirmationLevel konstanta

Berbagai kemungkinan nilai yang menunjukkan tingkat kepastian bahwa komponen tersebut benar.

Akses dengan memanggil const {ConfirmationLevel} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
BetaCONFIRMED
BetaUNCONFIRMED_AND_SUSPICIOUS
BetaUNCONFIRMED_BUT_PLAUSIBLE

Geocode class

Class google.maps.addressValidation.Geocode

Berisi informasi tentang tempat input di-geocoding.

Akses dengan memanggil const {Geocode} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
Betabounds
Jenis:  LatLngBounds optional
Batas tempat yang di-geocoding.
BetafeatureSizeMeters
Jenis:  number optional
Ukuran tempat yang di-geocoding, dalam meter. Ini adalah ukuran lain dari kekasaran lokasi yang di-geocode, tetapi dalam ukuran fisik, bukan dalam makna semantik.
Betalocation
Jenis:  LatLngAltitude optional
Lokasi input yang di-geocoding.
BetaplaceId
Jenis:  string optional
ID Tempat dari tempat yang di-geocoding. Penggunaan Place lebih disarankan daripada menggunakan alamat, koordinat lintang/bujur, atau plus codes. Menggunakan koordinat untuk merutekan atau menghitung petunjuk arah mengemudi akan selalu menghasilkan titik yang disesuaikan dengan jalan terdekat dengan koordinat tersebut. Jalan ini mungkin bukan jalan yang akan mengarah ke tujuan dengan cepat atau aman dan mungkin tidak dekat dengan titik akses ke properti. Selain itu, saat lokasi di-geocode balik, tidak ada jaminan bahwa alamat yang ditampilkan akan cocok dengan alamat asli.
BetaplaceTypes
Jenis:  Array<string>
Jenis tempat yang di-geocoding inputnya. Misalnya, ['locality', 'political']. Daftar lengkap jenis dapat ditemukan di dokumentasi Geocoding API.
BetaplusCode
Jenis:  PlusCode optional
Plus Codes yang sesuai dengan location.
BetafetchPlace
fetchPlace()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Tidak Ada
Menampilkan representasi Place dari Geocode ini. Untuk mendapatkan detail lengkap tempat, panggilan ke place.fetchFields() harus dilakukan.

Konstanta perincian

google.maps.addressValidation.Granularity konstanta

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

Akses dengan memanggil const {Granularity} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
BetaBLOCK Alamat atau geocode menunjukkan blok. Hanya digunakan di wilayah yang memiliki pengalamatan tingkat blok, seperti Jepang.
BetaOTHER Semua perincian lainnya, yang dikelompokkan bersama karena tidak dapat ditayangkan.
BetaPREMISE Hasil tingkat bangunan.
BetaPREMISE_PROXIMITY Geocode yang memperkirakan lokasi tingkat bangunan dari alamat.
BetaROUTE Geocode atau alamat memiliki perincian hingga rute, seperti jalan, jalan raya, atau jalan tol.
BetaSUB_PREMISE Hasil tingkat di bawah bangunan, seperti apartemen.

USPSAddress class

Class google.maps.addressValidation.USPSAddress

Representasi USPS dari alamat AS.

Akses dengan memanggil const {USPSAddress} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
Betacity
Jenis:  string optional
Nama kota.
BetacityStateZipAddressLine
Jenis:  string optional
Baris alamat yang berisi kota, negara bagian, dan kode pos.
Betafirm
Jenis:  string optional
Nama perusahaan.
BetafirstAddressLine
Jenis:  string optional
Baris pertama alamat.
BetasecondAddressLine
Jenis:  string optional
Baris kedua alamat.
Betastate
Jenis:  string optional
Kode negara bagian 2 huruf.
Betaurbanization
Jenis:  string optional
Nama urbanisasi Puerto Riko.
BetazipCode
Jenis:  string optional
Kode pos, misalnya "10009".
BetazipCodeExtension
Jenis:  string optional
Ekstensi kode pos 4 digit, misalnya "5023".

USPSData class

Class google.maps.addressValidation.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.

Akses dengan memanggil const {USPSData} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
BetaabbreviatedCity
Jenis:  string optional
Kota singkat.
BetaaddressRecordType
Jenis:  string optional
Jenis catatan alamat yang cocok dengan alamat input.
BetacarrierRoute
Jenis:  string optional
Kode rute ekspedisi. Kode empat karakter yang terdiri dari awalan satu huruf dan penentu rute tiga digit.
BetacarrierRouteIndicator
Jenis:  string optional
Indikator pengurutan tarif rute ekspedisi.
BetacassProcessed
Jenis:  boolean
Indikator bahwa permintaan telah diproses CASS.
Betacounty
Jenis:  string optional
Nama county.
BetadeliveryPointCheckDigit
Jenis:  string optional
Digit pengecek titik pengiriman. Nomor ini ditambahkan ke akhir kode batang titik pengiriman untuk surat yang dipindai secara mekanis. Menambahkan semua digit delivery_point_barcode, delivery_point_check_digit, kode pos, dan ZIP+4 akan menghasilkan angka yang dapat dibagi 10.
BetadeliveryPointCode
Jenis:  string optional
Kode titik pengiriman 2 digit.
BetadpvCMRA
Jenis:  string optional
Menunjukkan apakah alamat tersebut adalah CMRA (Commercial Mail Receiving Agency)--bisnis pribadi yang menerima surat untuk klien. Menampilkan satu karakter.
BetadpvConfirmation
Jenis:  string optional
Kemungkinan nilai untuk konfirmasi DPV. Menampilkan satu karakter atau tidak menampilkan nilai.
BetadpvDoorNotAccessible
Jenis:  string optional
Tanda menunjukkan alamat yang tidak dapat dikunjungi USPS untuk mengantarkan surat. Menampilkan satu karakter.
BetadpvDrop
Jenis:  string optional
Bendera menunjukkan bahwa surat dikirim ke satu wadah di suatu lokasi. Menampilkan satu karakter.
BetadpvEnhancedDeliveryCode
Jenis:  string optional
Menunjukkan bahwa lebih dari satu kode respons DPV valid untuk alamat tersebut. Menampilkan satu karakter.
BetadpvFootnote
Jenis:  string optional
Catatan kaki dari validasi titik pengiriman. Beberapa catatan kaki dapat digabungkan dalam string yang sama.
BetadpvNonDeliveryDays
Jenis:  string optional
Tanda menunjukkan bahwa pengiriman surat tidak dilakukan setiap hari dalam seminggu. Menampilkan satu karakter.
BetadpvNonDeliveryDaysValues
Jenis:  number optional
Bilangan bulat yang mengidentifikasi hari gagal tayang. Dapat diinterogasi menggunakan flag bit: 0x40 – Hari Minggu adalah hari tidak ada pengiriman 0x20 – Hari Senin adalah hari tidak ada pengiriman 0x10 – Hari Selasa adalah hari tidak ada pengiriman 0x08 – Hari Rabu adalah hari tidak ada pengiriman 0x04 – Hari Kamis adalah hari tidak ada pengiriman 0x02 – Hari Jumat adalah hari tidak ada pengiriman 0x01 – Hari Sabtu adalah hari tidak ada pengiriman
BetadpvNoSecureLocation
Jenis:  string optional
Bendera menunjukkan bahwa pintu dapat diakses, tetapi paket tidak akan ditinggalkan karena masalah keamanan. Menampilkan satu karakter.
BetadpvNoStat
Jenis:  string optional
Menunjukkan apakah alamat adalah alamat tanpa statistik atau alamat aktif. Alamat non-stat adalah alamat yang tidak ditempati secara terus-menerus atau alamat yang tidak dilayani oleh USPS. Menampilkan satu karakter.
BetadpvNoStatReasonCode
Jenis:  number optional
Menunjukkan jenis NoStat. Menampilkan kode alasan sebagai int.
BetadpvPBSA
Jenis:  string optional
Menunjukkan bahwa alamat cocok dengan data PBSA. Menampilkan satu karakter.
BetadpvThrowback
Jenis:  string optional
Menunjukkan bahwa surat tidak dikirim ke alamat jalan. Menampilkan satu karakter.
BetadpvVacant
Jenis:  string optional
Menunjukkan apakah alamat kosong. Menampilkan satu karakter.
BetaelotFlag
Jenis:  string optional
Flag Menaik/Menurun eLOT (A/D).
BetaelotNumber
Jenis:  string optional
Nomor Jalur Perjalanan yang Ditingkatkan (eLOT).
BetaerrorMessage
Jenis:  string optional
Pesan error untuk pengambilan data USPS. Kolom ini diisi saat pemrosesan USPS ditangguhkan karena terdeteksi alamat yang dibuat secara artifisial.
BetafipsCountyCode
Jenis:  string optional
Kode county FIPS.
BetahasDefaultAddress
Jenis:  boolean
Indikator bahwa alamat default ditemukan, tetapi ada alamat yang lebih spesifik.
BetahasNoEWSMatch
Jenis:  boolean
Alamat pengiriman dapat dicocokkan, tetapi file EWS menunjukkan bahwa kecocokan persis akan segera tersedia.
BetalacsLinkIndicator
Jenis:  string optional
Indikator LACSLink.
BetalacsLinkReturnCode
Jenis:  string optional
Kode respons LACSLink.
BetapmbDesignator
Jenis:  string optional
Penentu desain unit PMB (Private Mail Box).
BetapmbNumber
Jenis:  string optional
Nomor PMB (Private Mail Box).
BetapoBoxOnlyPostalCode
Jenis:  boolean
Kode pos khusus kotak PO.
BetapostOfficeCity
Jenis:  string optional
Kota kantor pos utama.
BetapostOfficeState
Jenis:  string optional
Negara bagian kantor pos utama.
BetastandardizedAddress
Jenis:  USPSAddress optional
Alamat standar USPS.
BetasuiteLinkFootnote
Jenis:  string optional
Catatan kaki dari pencocokan data jalan atau bangunan tinggi dengan informasi unit. Jika kecocokan nama bisnis ditemukan, nomor sekunder akan ditampilkan.

Class Verdict

Class google.maps.addressValidation.Verdict

Mewakili alamat yang diproses setelahnya untuk alamat yang diberikan.

Akses dengan memanggil const {Verdict} = await google.maps.importLibrary("addressValidation").
Lihat Library di Maps JavaScript API.
BetaaddressComplete
Jenis:  boolean
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 false. Lihat kolom BetaAddress.missingComponentTypes, BetaAddress.unresolvedTokens, atau BetaAddressComponent.unexpected untuk mengetahui detail selengkapnya.
BetageocodeGranularity
Jenis:  Granularity optional
Informasi tentang perincian Geocode. Hal ini dapat dipahami sebagai makna semantik seberapa kasar atau akurat lokasi yang di-geocoding.
BetahasInferredComponents
Jenis:  boolean
Setidaknya satu komponen alamat disimpulkan (yaitu ditambahkan) yang tidak ada dalam input, lihat AddressComponent untuk mengetahui detailnya.
BetahasReplacedComponents
Jenis:  boolean optional
Setidaknya satu komponen alamat diganti - lihat AddressComponent untuk mengetahui detailnya.
BetahasUnconfirmedComponents
Jenis:  boolean
Setidaknya satu komponen alamat tidak dapat dikategorikan atau divalidasi, lihat AddressComponent untuk mengetahui detailnya.
BetainputGranularity
Jenis:  Granularity optional
Perincian alamat input. Ini adalah hasil parsing alamat input dan tidak memberikan sinyal validasi apa pun. Untuk sinyal validasi, lihat validationGranularity.
BetavalidationGranularity
Jenis:  Granularity optional
Tingkat perincian yang dapat digunakan API untuk memvalidasi alamat sepenuhnya. Misalnya, validationGranularity PREMISE menunjukkan bahwa semua komponen alamat di tingkat PREMISE dan yang lebih luas dapat divalidasi.