เอกสารนี้ครอบคลุมถึงการตรวจสอบที่อยู่เฉพาะในสหรัฐอเมริกา:
ข้อมูล USPS ในเวิร์กโฟลว์ของคุณ
เมื่อตรวจสอบที่อยู่ในสหรัฐอเมริกา บริการ Address Validation API ยังสามารถป้อนข้อมูลในส่วน uspsData ของผลตอบแทนได้ด้วย
คุณไม่ควรเชื่อถือสิ่งนี้เนื่องจากออบเจ็กต์นี้ไม่ได้มีการป้อนข้อมูลเสมอไป เป็นวิธีเดียวในการตรวจสอบที่อยู่ แต่รวม และระบุคอมโพเนนต์ลงในระบบของคุณด้วย
การยืนยันจุดนำส่งของ USPS (DPV)
ช่อง dpvConfirmation
จะแสดงค่าเดียวในฐานะส่วนหนึ่งของการตอบกลับ uspsData
เพื่อแจ้งให้ทราบว่า USPS นำส่งไปยังที่อยู่ที่ระบุไว้ได้หรือไม่
คุณใช้ช่องนี้เพื่อระบุสิ่งต่อไปนี้ได้
- ความถูกต้องของที่อยู่
- หากที่อยู่ไม่มีหมายเลขสถานที่ตั้งย่อย
- หากไม่มีหมายเลขสถานที่ย่อยอยู่ในระบบข้อมูลของ USPS
บริการแสดงผล 1 ใน 4 ค่า dpvConfirmation
หรือไม่แสดง
แสดงผลค่า 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 ถนน 2 สาย กรุงเทพฯ 10220
- ภูมิภาค: สหรัฐอเมริกา
- ฟิลด์
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 แคลิฟอร์เนีย ที่อยู่ที่มีคุณภาพ
- ที่อยู่ที่ป้อน: 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.