เอกสารนี้ครอบคลุมการตรวจสอบที่อยู่เฉพาะในสหรัฐอเมริกา ดังนี้
ข้อมูล USPS ในเวิร์กโฟลว์
เมื่อตรวจสอบที่อยู่ในสหรัฐอเมริกา บริการ Address Validation API จะเติมส่วน uspsData ของการคืนสินค้าได้ด้วย
เนื่องจากออบเจ็กต์นี้ไม่ได้ป้อนข้อมูลเสมอไป คุณจึงไม่ควรใช้พร็อพเพอร์ตี้นี้เป็นวิธีเดียวในการตรวจสอบที่อยู่ แต่ให้รวมคอมโพเนนต์การตัดสินและที่อยู่ลงในระบบแทนด้วย
การยืนยันจุดนำส่งของ USPS (DPV)
ในการตอบกลับของ uspsData ช่อง dpvConfirmation จะแสดงผลอักขระ 1 ตัวเพื่อให้คุณทราบว่า USPS นำส่งไปยังที่อยู่ที่ระบุได้หรือไม่
คุณใช้ฟิลด์นี้เพื่อระบุสิ่งต่อไปนี้ได้
- ความถูกต้องของที่อยู่
- ในกรณีที่ที่อยู่ไม่มีหมายเลขโทรศัพท์สถานที่ตั้งย่อย
- ถ้าไม่มีหมายเลขสถานที่ย่อยในระบบข้อมูลของ USPS
บริการแสดงผลค่า dpvConfirmation ค่าใดค่าหนึ่งจาก 4 ค่า หรือไม่แสดงผลค่า dpvConfirmation เลย ตารางด้านล่างแสดงลักษณะการทำงานที่แนะนำซึ่งตรรกะของคุณควรใช้กับผลลัพธ์ที่เป็นไปได้แต่ละรายการ 5 รายการ ดูรายละเอียดเพิ่มเติมเกี่ยวกับตรรกะนี้ได้ที่ภาพรวมเวิร์กโฟลว์ในหัวข้อใช้การตอบกลับการตรวจสอบ
ค่า |
พฤติกรรม |
คำอธิบาย |
|---|---|---|
N หรือว่างเปล่า |
แก้ไขที่อยู่ |
ที่อยู่ไม่ได้รับการยืนยันโดย DPV ซึ่งหมายความว่า USPS ไม่รู้จักเลขที่สถานที่ที่ป้อนซึ่งมีอยู่บนถนน (เส้นทาง) ที่ป้อน และไม่สามารถนำส่งที่นั่นได้ |
D |
แก้ไขที่อยู่ |
ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และ
ไม่มีข้อมูลหมายเลขรอง |
S |
ยืนยันที่อยู่ |
ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และ มีข้อมูลหมายเลขรองอยู่แต่ยังไม่ได้รับการยืนยัน ซึ่งหมายความว่าหมายเลขสถานที่ที่ป้อนจะมีอยู่ในเส้นทางที่ป้อน แต่สถานที่ย่อยที่ระบุไม่มีภายในอาคารนั้น ตามที่ USPS ได้กำหนด |
Y |
ยอมรับที่อยู่ |
ที่อยู่ดังกล่าวได้รับการยืนยันโดย DPV สำหรับหมายเลขหลักและรอง ซึ่งหมายความว่า USPS จะนำส่งที่อยู่ได้โดยสมบูรณ์ รวมถึงหมายเลขสถานที่ตั้งย่อย (หากมี) |
ส่วนที่เหลือของส่วนนี้จะอธิบายสถานการณ์จริงที่ใช้รหัส DPV
ตัวอย่าง DPV N - แก้ไขที่อยู่
ตัวอย่างนี้ใช้เลขที่ถนนที่ไม่มีอยู่จริงกับที่อยู่อื่นที่ถูกต้อง
- ที่อยู่ที่ป้อน: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- ภูมิภาค: USA
- ฟิลด์
dpvConfirmationจะแสดงผล:N
นี่เป็นสัญญาณแรงมากว่าไม่มีหมายเลขสถานที่ตั้งนี้บนเส้นทางนี้ เช่นเดียวกับที่อยู่อื่นๆ ที่มีปัญหา ระบบของคุณควรแจ้งให้ผู้ใช้แก้ไข
ตัวอย่าง DPV D - แก้ไขที่อยู่
ตัวอย่างนี้ใช้สำนักงานของ Google ในนิวยอร์ก แต่ไม่มีสถานที่ตั้งย่อยซึ่งเป็นส่วนที่จำเป็นของที่อยู่ ซึ่งทำได้โดยการใช้ที่อยู่ในการสาธิตซึ่งไม่มีข้อมูลสถานที่ตั้งย่อย
- ที่อยู่ที่ป้อน: 111 8th Avenue, New York, NY, 10011
- ภูมิภาค: USA
- ฟิลด์
dpvConfirmationจะแสดงผล:D
ซึ่งเป็นการยืนยันว่าสถานที่ตั้งย่อยหายไปจากอินพุต หากต้องการได้รับ DPV เป็น Y จะต้องรวมสถานที่ตั้งย่อยที่ถูกต้องเป็นส่วนหนึ่งของอินพุต ตัวอย่างเช่น คุณอาจรวมสถานที่ตั้งย่อยที่ถูกต้องของ FL 4 (ชั้น 4) เพื่อให้ได้ค่า dpvConfirmation เป็น Y
ตัวอย่าง DPV S - ยืนยันที่อยู่
ตัวอย่างนี้ใช้หมายเลขสถานที่ตั้งย่อยที่ไม่มีอยู่ภายในอาคาร
- ที่อยู่ที่ป้อน: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- ภูมิภาค: USA
- ฟิลด์
dpvConfirmationจะแสดงผล:S
ซึ่งหมายความว่า แม้ว่า 1600 Amphitheatre Parkway จะเป็นที่อยู่ที่สามารถรับอีเมลได้ แต่ Ste 101 ภายในองค์กรนั้นไม่ใช่ส่วนที่ถูกต้องของที่อยู่ ระบบของคุณควรยืนยันข้อมูลนี้กับผู้ใช้และโอกาสในการแก้ไข
ตัวอย่าง DPV Y - ยอมรับที่อยู่
ตัวอย่างนี้ใช้ที่อยู่ Googleplex ใน Mountain View แคลิฟอร์เนีย เป็นที่อยู่ที่มีคุณภาพ
- ที่อยู่ที่ป้อน: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- ภูมิภาค: USA
- ฟิลด์
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.