- Permintaan HTTP
- Isi permintaan
- Isi respons
- PostalAddress
- LanguageOptions
- ValidationResult
- Putusan
- Perincian
- Alamat
- AddressComponent
- ComponentName
- ConfirmationLevel
- Geocode
- LatLng
- PlusCode
- Area pandang
- AddressMetadata
- UspsData
- UspsAddress
Memvalidasi alamat.
Permintaan HTTP
POST https://addressvalidation.googleapis.com/v1:validateAddress
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "address": { object ( |
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 |
previousResponseId |
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 |
enableUspsCass |
Mengaktifkan mode yang kompatibel dengan USPS CASS. Ini hanya memengaruhi kolom Sebaiknya gunakan |
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 informasi selengkapnya, lihat deskripsi tahap peluncuran. Mengaktifkan Address Validation API untuk menyertakan informasi tambahan dalam respons. |
sessionToken |
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. |
Isi respons
Respons terhadap permintaan validasi alamat.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"result": {
object ( |
Kolom | |
---|---|
result |
Hasil validasi alamat. |
responseId |
UUID yang mengidentifikasi respons ini. Jika alamat perlu divalidasi ulang, UUID ini harus disertakan dengan permintaan baru. |
PostalAddress
Mewakili alamat pos, mis. untuk pengiriman pos atau alamat pembayaran. Seperti alamat pos, layanan pos dapat mengirimkan item ke lokasi, P.O. Box, atau yang serupa. Aplikasi ini tidak dimaksudkan untuk membuat model lokasi geografis (jalan, kota, gunung).
Dalam penggunaan umum, alamat akan dibuat melalui input pengguna atau dari mengimpor data yang ada, bergantung pada jenis prosesnya.
Saran terkait input / pengeditan alamat: - Gunakan widget alamat yang siap melakukan internasionalisasi seperti https://github.com/google/libaddressinput) - Pengguna tidak boleh diberi elemen UI untuk memasukkan atau mengedit kolom selain negara tempat kolom tersebut digunakan.
Untuk panduan lebih lanjut tentang cara menggunakan skema ini, lihat: https://support.google.com/business/answer/6397478
Representasi JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Kolom | |
---|---|
revision |
Revisi skema |
regionCode |
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 kode wilayah tidak diberikan, kode tersebut akan diambil dari alamat. Untuk performa terbaik, sebaiknya sertakan kode wilayah jika Anda mengetahuinya. Wilayah yang tidak konsisten atau berulang dapat menyebabkan performa yang buruk, misalnya, jika |
languageCode |
Kode bahasa di alamat input dicadangkan untuk penggunaan di masa mendatang dan diabaikan hari ini. API menampilkan alamat dalam bahasa yang sesuai untuk lokasi alamat tersebut. |
postalCode |
Opsional. Kode pos alamat. Tidak semua negara menggunakan atau mewajibkan keberadaan kode pos, tetapi jika digunakan, kode pos tersebut dapat memicu validasi tambahan dengan bagian alamat yang lain (misalnya validasi negara bagian/pos di Amerika Serikat). |
sortingCode |
Opsional. Kode pengurutan tambahan khusus negara. Atribut ini tidak digunakan di sebagian besar wilayah. Jika digunakan, nilainya berupa string seperti "CEDEX", secara opsional diikuti dengan angka (misalnya "CEDEX 7"), atau hanya angka, yang mewakili "kode sektor" (Jamaika), "indikator area pengiriman" (Malawi), atau "indikator kantor pos" (misalnya Côte d'Ivoire). |
administrativeArea |
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 (misalnya "Barcelona" dan bukan "Catalunya"). Banyak negara tidak menggunakan wilayah administratif dalam alamat pos. Misalnya, di Swiss, kolom ini harus dibiarkan tidak terisi. |
locality |
Opsional. Secara umum merujuk pada bagian kota dari alamat. Contoh: US city, IT comune, UK post city. Di wilayah dunia dengan lokalitas yang tidak didefinisikan dengan baik atau tidak cocok dengan struktur ini, biarkan lokalitas kosong dan gunakan addressLines. |
sublocality |
Opsional. Sublokalitas alamat. Misalnya, ini dapat berupa kawasan, kota kecil, distrik. |
addressLines[] |
Wajib. Baris alamat tidak terstruktur yang menggambarkan tingkat alamat yang lebih rendah. |
recipients[] |
Jangan tetapkan kolom ini. Address Validation API saat ini tidak menggunakannya. Meskipun saat ini API tidak akan menolak permintaan dengan set kolom ini, informasi akan dibuang dan tidak akan ditampilkan dalam respons. |
organization |
Jangan tetapkan kolom ini. Address Validation API saat ini tidak menggunakannya. Meskipun saat ini API tidak akan menolak permintaan dengan set kolom ini, informasi akan dibuang dan tidak akan ditampilkan dalam respons. |
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.
Representasi JSON |
---|
{ "returnEnglishLatinAddress": boolean } |
Kolom | |
---|---|
returnEnglishLatinAddress |
Pratinjau: Menampilkan |
ValidationResult
Hasil validasi alamat.
Representasi JSON |
---|
{ "verdict": { object ( |
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. |
uspsData |
Tanda pengiriman tambahan disediakan oleh USPS. Hanya disediakan di wilayah |
englishLatinAddress |
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.
Representasi JSON |
---|
{ "inputGranularity": enum ( |
Kolom | |
---|---|
inputGranularity |
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, |
validationGranularity |
Tingkat perincian yang dapat digunakan API untuk validate alamat sepenuhnya. Misalnya, Hasil validasi komponen per alamat dapat ditemukan di |
geocodeGranularity |
Informasi tentang perincian Ini terkadang dapat berbeda dari |
addressComplete |
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 |
hasUnconfirmedComponents |
Setidaknya satu komponen alamat tidak dapat dikategorikan atau divalidasi. Lihat |
hasInferredComponents |
Setidaknya satu komponen alamat yang disimpulkan (ditambahkan) yang tidak ada dalam input, lihat |
hasReplacedComponents |
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. |
Alamat
Detail alamat yang telah diproses. Pasca-pemrosesan mencakup memperbaiki bagian alamat yang salah eja, mengganti bagian yang salah, dan menyimpulkan bagian yang hilang.
Representasi JSON |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
Kolom | |
---|---|
formattedAddress |
Alamat yang telah diproses, yang diformat sebagai alamat satu baris dengan mengikuti aturan pemformatan alamat di wilayah tempat alamat berada. |
postalAddress |
Alamat yang telah diproses sebelumnya sebagai alamat pos. |
addressComponents[] |
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. |
missingComponentTypes[] |
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 |
unconfirmedComponentTypes[] |
Jenis komponen yang ada di |
unresolvedTokens[] |
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.
Representasi JSON |
---|
{ "componentName": { object ( |
Kolom | |
---|---|
componentName |
Nama untuk komponen ini. |
componentType |
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 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. |
spellCorrected |
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. |
ComponentName
Wrapper untuk nama komponen.
Representasi JSON |
---|
{ "text": string, "languageCode": string } |
Kolom | |
---|---|
text |
Teks nama. Misalnya, "5th Avenue" untuk nama jalan atau "1253" untuk nomor jalan. |
languageCode |
Kode bahasa BCP-47. Ini tidak akan ada jika nama komponen tidak dikaitkan dengan bahasa, seperti nomor jalan. |
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. |
Geocode
Berisi informasi tentang tempat tempat input geocode.
Representasi JSON |
---|
{ "location": { object ( |
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. |
plusCode |
Plus Codes yang sesuai dengan |
bounds |
Batas tempat yang di-geocoding. |
featureSizeMeters |
Ukuran tempat yang di-geocode, dalam meter. Ini adalah ukuran lain dari kekasaran lokasi geocode, namun dalam ukuran fisik, bukan dalam arti semantik. |
placeId |
PlaceID tempat yang akan di-geocode oleh input ini. Untuk informasi selengkapnya tentang ID Tempat, lihat di sini. |
placeTypes[] |
Jenis tempat yang di-geocode inputnya. Misalnya, |
LatLng
Objek yang merepresentasikan pasangan garis lintang/bujur. Objek ini dinyatakan sebagai pasangan double untuk mewakili derajat lintang dan derajat bujur. Kecuali jika ditentukan lain, objek ini harus sesuai dengan standar WGS84. Nilai harus berada dalam rentang yang dinormalisasi.
Representasi JSON |
---|
{ "latitude": number, "longitude": number } |
Kolom | |
---|---|
latitude |
Lintang dalam derajat. Harus dalam rentang [-90.0, +90.0]. |
longitude |
Bujur dalam derajat. Harus dalam rentang [-180.0, +180.0]. |
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.
Representasi JSON |
---|
{ "globalCode": string, "compoundCode": string } |
Kolom | |
---|---|
globalCode |
Kode global (lengkap) tempat, seperti "9FWM33GV+HQ", yang mewakili area 1/8000 x 1/8000 derajat (~14 kali 14 meter). |
compoundCode |
Kode gabungan tempat, seperti "33GV+HQ, Ramberg, Norwegia", yang berisi akhiran kode global dan mengganti awalan dengan nama entitas referensi yang diformat. |
Area Tampilan
Area pandang lintang dan bujur, yang direpresentasikan sebagai dua titik low
dan high
yang secara diagonal berlawanan. Area pandang dianggap sebagai area tertutup, yaitu mencakup batasnya. Batas lintang harus berkisar antara -90 hingga 90 derajat inklusif, dan batas bujur harus berkisar antara -180 hingga 180 derajat inklusif. Berbagai kasus mencakup:
Jika
low
=high
, area tampilan terdiri dari satu titik tersebut.Jika
low.longitude
>high.longitude
, rentang bujur akan dibalik (area pandang melintasi garis bujur 180 derajat).Jika
low.longitude
= -180 derajat danhigh.longitude
= 180 derajat, area pandang akan mencakup semua garis bujur.Jika
low.longitude
= 180 derajat danhigh.longitude
= -180 derajat, rentang bujur kosong.Jika
low.latitude
>high.latitude
, rentang lintang kosong.
low
dan high
harus diisi, dan kotak yang diwakili tidak boleh kosong (seperti yang ditentukan oleh definisi di atas). Area pandang kosong akan menghasilkan error.
Misalnya, area pandang ini sepenuhnya mencakup New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Representasi JSON |
---|
{ "low": { object ( |
Kolom | |
---|---|
low |
Wajib. Titik rendah area pandang. |
high |
Wajib. Titik tinggi area pandang. |
AddressMetadata
Metadata untuk alamat. metadata
tidak dijamin akan terisi penuh untuk setiap alamat yang dikirim ke Address Validation API.
Representasi JSON |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
Kolom | |
---|---|
business |
Menunjukkan bahwa ini adalah alamat bisnis. Jika tidak disetel, nilai akan tidak diketahui. |
poBox |
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. |
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.
Representasi JSON |
---|
{
"standardizedAddress": {
object ( |
Kolom | |
---|---|
standardizedAddress |
alamat standar USPS. |
deliveryPointCode |
Kode poin pengiriman 2 digit |
deliveryPointCheckDigit |
Digit pemeriksaan titik pengiriman. Nomor ini ditambahkan ke akhir delivery_point_barcode untuk email yang dipindai secara mekanis. Menambahkan semua digit delivery_point_barcode, deliveryPointCheckDigit, kode pos, dan ZIP+4 secara bersamaan akan menghasilkan angka yang dapat dibagi 10. |
dpvConfirmation |
Nilai yang mungkin untuk konfirmasi DPV. Menampilkan satu karakter atau tidak menampilkan nilai.
|
dpvFootnote |
Catatan kaki dari validasi titik pengiriman. Beberapa catatan kaki dapat dirangkai ke dalam string yang sama.
|
dpvCmra |
Menunjukkan apakah alamatnya adalah CMRA (Commercial Mail Receiving Agency)--bisnis pribadi yang menerima email untuk klien. Menampilkan satu karakter.
|
dpvVacant |
Apakah tempat ini kosong? Menampilkan satu karakter.
|
dpvNoStat |
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.
|
dpvNoStatReasonCode |
Menunjukkan jenis NoStat. Menampilkan kode alasan sebagai int.
|
dpvDrop |
Tanda menunjukkan bahwa email dikirim ke satu penerima pesan di situs. Menampilkan satu karakter.
|
dpvThrowback |
Menunjukkan bahwa surat tidak dikirim ke alamat tersebut. Menampilkan satu karakter.
|
dpvNonDeliveryDays |
Bendera menunjukkan pengiriman email tidak dilakukan setiap hari dalam seminggu. Menampilkan satu karakter.
|
dpvNonDeliveryDaysValues |
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 |
dpvNoSecureLocation |
Tanda menunjukkan bahwa pintu dapat diakses, tetapi paket tidak akan ditinggalkan karena masalah keamanan. Menampilkan satu karakter.
|
dpvPbsa |
Menunjukkan bahwa alamat cocok dengan data PBSA. Menampilkan satu karakter.
|
dpvDoorNotAccessible |
Bendera menunjukkan alamat tempat USPS tidak dapat mengetuk pintu untuk mengirim email. Menampilkan satu karakter.
|
dpvEnhancedDeliveryCode |
Menunjukkan bahwa lebih dari satu kode pengembalian DPV yang valid untuk alamat tersebut. Menampilkan satu karakter.
|
carrierRoute |
Kode rute ekspedisi. Kode empat karakter yang terdiri dari awalan satu huruf dan penanda rute tiga digit. Awalan:
|
carrierRouteIndicator |
Indikator pengurutan tarif rute ekspedisi. |
ewsNoMatch |
Alamat pengiriman dapat dicocokkan, tetapi file EWS menunjukkan bahwa alamat yang sama persis akan tersedia dalam waktu dekat. |
postOfficeCity |
Kota kantor pos utama. |
postOfficeState |
Negara bagian utama kantor pos. |
abbreviatedCity |
Singkatan kota. |
fipsCountyCode |
Kode wilayah FIPS. |
county |
Nama county. |
elotNumber |
Nomor Line of Travel (eLOT) yang ditingkatkan. |
elotFlag |
eLOT Tanda Menaik/Menurun (A/D). |
lacsLinkReturnCode |
Kode pengembalian LACSLink. |
lacsLinkIndicator |
Indikator LACSLink. |
poBoxOnlyPostalCode |
Hanya kode pos PO Box. |
suitelinkFootnote |
Catatan kaki dari pencocokan catatan jalan atau gedung tinggi dengan informasi suite. Jika ditemukan kecocokan nama bisnis, nomor sekunder akan ditampilkan.
|
pmbDesignator |
Penanda unit PMB (Private Mail Box). |
pmbNumber |
Nomor PMB (Private Mail Box); |
addressRecordType |
Jenis data alamat yang cocok dengan alamat input.
|
defaultAddress |
Indikator bahwa alamat default ditemukan, tetapi ada alamat yang lebih spesifik. |
errorMessage |
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. |
cassProcessed |
Indikator bahwa permintaan telah diproses CASS. |
UspsAddress
Representasi USPS untuk alamat AS.
Representasi JSON |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
Kolom | |
---|---|
firstAddressLine |
Baris alamat pertama. |
firm |
Nama perusahaan. |
secondAddressLine |
Baris alamat kedua. |
urbanization |
Nama urbanisasi Puerto Riko. |
cityStateZipAddressLine |
Kota + negara bagian + kode pos. |
city |
Nama kota. |
state |
Kode negara bagian 2 huruf. |
zipCode |
Kode pos, misalnya 10009. |
zipCodeExtension |
Ekstensi kode pos 4 digit, misalnya 5023. |