จัดการที่อยู่ในสหรัฐอเมริกา

เอกสารนี้ครอบคลุม Address Validation เฉพาะในสหรัฐอเมริกา ดังนี้

• การใช้ข้อมูล USPS ในเวิร์กโฟลว์
• ช่อง USPS Delivery Point Verification (dpv)
• ข้อความด้านความปลอดภัย

ข้อมูล USPS ในเวิร์กโฟลว์

เมื่อตรวจสอบที่อยู่ในสหรัฐอเมริกา Address Validation API ยังสามารถป้อนข้อมูลส่วน uspsData ของการแสดงผลได้ด้วย

เนื่องจากออบเจ็กต์นี้ไม่ได้ป้อนข้อมูลเสมอไป คุณจึงไม่ควรใช้พร็อพเพอร์ตี้นี้เป็นวิธีเดียวในการตรวจสอบที่อยู่ แต่ควรใส่คำตัดสินและคอมโพเนนต์ที่อยู่ลงในระบบด้วย

การยืนยันจุดนำส่งของ USPS (DPV)

ในส่วนของการตอบกลับ uspsData ช่อง dpvConfirmation จะแสดงผลอักขระเดียวเพื่อแจ้งให้คุณทราบว่า USPS สามารถนำส่งไปยังที่อยู่ที่ระบุได้หรือไม่

คุณใช้ช่องนี้เพื่อระบุสิ่งต่อไปนี้ได้

• ความถูกต้องของที่อยู่
• หากที่อยู่ไม่มีหมายเลขย่อยของสถานที่ตั้ง
• หากไม่มีหมายเลขสถานที่ย่อยในระบบข้อมูลของ USPS

บริการจะแสดงผลค่า dpvConfirmation 1 ใน 4 ค่าหรือไม่แสดงผลค่า dpvConfirmation เลย ตารางด้านล่างแสดงลักษณะการทำงานที่แนะนำซึ่งตรรกะของคุณควรใช้สำหรับผลลัพธ์ที่เป็นไปได้ทั้ง 5 รายการ ดูรายละเอียดเพิ่มเติมเกี่ยวกับตรรกะนี้ได้ที่ภาพรวมเวิร์กโฟลว์ในสร้างตรรกะการตรวจสอบความถูกต้อง

ส่วนที่เหลือของส่วนนี้จะกล่าวถึงสถานการณ์จริงที่ใช้รหัส DPV

DPV N example - fix the address

ตัวอย่างนี้ใช้หมายเลขถนนที่ไม่มีอยู่จริงในที่อยู่ที่ถูกต้อง

• ที่อยู่ที่ป้อน: 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 example - confirm the address

ตัวอย่างนี้ใช้หมายเลขย่อยของสถานที่ซึ่งไม่มีอยู่ภายในอาคาร

• ที่อยู่ที่ป้อน: 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.