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