เอกสารนี้ครอบคลุมการตรวจสอบที่อยู่ที่เฉพาะเจาะจงกับสหรัฐอเมริกา
ข้อมูล USPS ในเวิร์กโฟลว์
เมื่อตรวจสอบที่อยู่ในสหรัฐอเมริกา Address Validation API จะป้อนข้อมูลในส่วน uspsData ของการตอบกลับด้วย
เนื่องจากระบบไม่ได้ป้อนข้อมูลในออบเจ็กต์นี้เสมอไป คุณจึงไม่ควรใช้พร็อพเพอร์ตี้นี้เป็นวิธีเดียวในการตรวจสอบที่อยู่ แต่ควรรวมผลการตัดสินและคอมโพเนนต์ที่อยู่ไว้ในระบบด้วย
การยืนยันจุดนำส่ง (DPV) ของ USPS
ฟิลด์ dpvConfirmation จะแสดงอักขระเดียวเพื่อแจ้งให้คุณทราบว่า USPS สามารถนำส่งไปยังที่อยู่ที่ระบุได้หรือไม่ ซึ่งเป็นส่วนหนึ่งของการตอบกลับ uspsData
คุณสามารถใช้ฟิลด์นี้เพื่อพิจารณาสิ่งต่อไปนี้
- ความถูกต้องของที่อยู่
- ที่อยู่ไม่มีหมายเลขสถานที่ย่อย
- หมายเลขสถานที่ย่อยไม่มีอยู่ในระบบข้อมูลของ USPS
บริการจะแสดงค่า dpvConfirmation 1 ใน 4 ค่า หรือไม่แสดงค่า dpvConfirmation เลย ตารางด้านล่างแสดงลักษณะการทำงานที่แนะนําซึ่งตรรกะของคุณควรใช้สำหรับผลลัพธ์ที่เป็นไปได้ 5 รายการ ดูรายละเอียดเพิ่มเติมเกี่ยวกับตรรกะนี้ได้ที่
ภาพรวมเวิร์กโฟลว์ในส่วนสร้างตรรกะการตรวจสอบ
ค่า |
ลักษณะการทำงาน |
คำอธิบาย |
|---|---|---|
N หรือว่างเปล่า |
แก้ไขที่อยู่ |
ที่อยู่ไม่ได้รับการยืนยัน DPV ซึ่งหมายความว่า USPS ไม่รู้จักหมายเลขสถานที่ที่ป้อน ซึ่งมีอยู่ในถนน (เส้นทาง) ที่ป้อน และไม่สามารถนำส่งไปยังที่อยู่นั้นได้ |
D |
แก้ไขที่อยู่ |
ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และไม่มีข้อมูลหมายเลขรอง |
S |
ยืนยันที่อยู่ |
ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และมี ข้อมูลหมายเลขรองแต่ไม่ได้รับการยืนยัน ซึ่งหมายความว่าหมายเลขสถานที่ที่ป้อนมีอยู่ในเส้นทางที่ป้อน แต่สถานที่ย่อยที่ระบุไม่มีอยู่ในอาคารนั้นตามข้อมูลของ USPS |
Y |
ยอมรับที่อยู่ |
ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักและหมายเลขรอง ซึ่งหมายความว่า USPS สามารถนำส่งไปยังที่อยู่นี้ได้อย่างสมบูรณ์ รวมถึง หมายเลขสถานที่ย่อย (หากมี) |
ส่วนที่เหลือของส่วนนี้จะอธิบายสถานการณ์จริงที่ใช้รหัส DPV
ตัวอย่าง DPV N - แก้ไขที่อยู่
ตัวอย่างนี้ใช้หมายเลขถนนที่ไม่มีอยู่จริงในที่อยู่ที่ถูกต้อง
- ที่อยู่ที่ป้อน: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- ภูมิภาค: สหรัฐอเมริกา
- ฟิลด์
dpvConfirmationจะแสดงN
นี่เป็นสัญญาณที่ชัดเจนมาก ว่าหมายเลขสถานที่นี้ไม่มีอยู่ในเส้นทางนี้ เช่นเดียวกับที่อยู่ที่มีปัญหาอื่นๆ ระบบควรแจ้งให้ผู้ใช้แก้ไข
ตัวอย่าง DPV D - แก้ไขที่อยู่
ตัวอย่างนี้ใช้สำนักงานของ Google ในนิวยอร์ก แต่ไม่มีสถานที่ย่อยซึ่งเป็นส่วนที่จำเป็นของที่อยู่ คุณสามารถดูได้โดยใช้ ที่อยู่ใน เดโม โดยไม่มีข้อมูลสถานที่ย่อย
- ที่อยู่ที่ป้อน: 111 8th Avenue, New York, NY, 10011
- ภูมิภาค: สหรัฐอเมริกา
- ฟิลด์
dpvConfirmationจะแสดงD
ซึ่งยืนยันว่าไม่มีสถานที่ย่อยในข้อมูลที่ป้อน คุณต้องระบุสถานที่ย่อยที่ถูกต้องเป็นส่วนหนึ่งของข้อมูลที่ป้อนจึงจะได้รับ DPV เป็น Y ตัวอย่างเช่น คุณสามารถระบุสถานที่ย่อยที่ถูกต้องเป็น FL 4 (ชั้น 4) เพื่อให้ได้ค่า dpvConfirmation เป็น Y
ตัวอย่าง DPV S - ยืนยันที่อยู่
ตัวอย่างนี้ใช้หมายเลขสถานที่ย่อยที่ไม่มีอยู่ในอาคาร
- ที่อยู่ที่ป้อน: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- ภูมิภาค: สหรัฐอเมริกา
- ฟิลด์
dpvConfirmationจะแสดงS
ซึ่งบ่งชี้ว่า 1600 Amphitheatre Parkway เป็นที่อยู่ที่รับจดหมายได้ แต่สถานที่ย่อย Ste 101 ไม่ใช่ส่วนที่ถูกต้องของที่อยู่ ระบบควรยืนยันข้อมูลนี้กับผู้ใช้และให้โอกาสในการแก้ไข
ตัวอย่าง DPV Y - ยอมรับที่อยู่
ตัวอย่างนี้ใช้ที่อยู่ Googleplex ใน Mountain View, CA เป็นที่อยู่คุณภาพที่ทราบ
- ที่อยู่ที่ป้อน: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- ภูมิภาค: สหรัฐอเมริกา
- ฟิลด์
dpvConfirmationจะแสดงY
USPS สามารถนำส่งไปยังที่อยู่นี้ได้อย่างสมบูรณ์ ซึ่งช่วยให้คุณมั่นใจได้ในระดับสูงว่า API แสดงที่อยู่คุณภาพดี และคุณสามารถใช้ที่อยู่นั้นได้ตามที่แสดง
หมายเหตุ: DPV ไม่ได้ระบุว่า Address Validation API ได้ทำการเปลี่ยนแปลงข้อมูลที่ป้อนหรือไม่ เช่น การแก้ไขการสะกด
ข้อความด้านความปลอดภัยสำหรับที่อยู่ในสหรัฐอเมริกา
ส่วนนี้ครอบคลุมแฟล็กความปลอดภัยที่ระบุไว้ในข้อมูล USPS สำหรับที่อยู่ที่สร้างขึ้นโดยไม่เป็นไปตามธรรมชาติ มาตรการรักษาความปลอดภัยนี้ออกแบบมาเพื่อป้องกันการสร้างรายการที่อยู่โดยไม่เป็นไปตามธรรมชาติ โดยตรวจหาเมื่อที่อยู่ที่ส่งมาดูเหมือนจะสร้างขึ้นโดยไม่เป็นไปตามธรรมชาติและไม่ได้มาอย่างถูกต้อง ซึ่งเกิดขึ้นได้ยากมาก
เมื่อ USPS ระบุที่อยู่ที่สร้างขึ้นโดยไม่เป็นไปตามธรรมชาติ errorMessage
ฟิลด์ของ uspsData พร็อพเพอร์ตี้ของการตอบกลับจะมี
ข้อความแสดงข้อผิดพลาดที่อธิบายปัญหา เช่น
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.