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

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

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

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

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

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

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

คุณสามารถใช้ฟิลด์นี้เพื่อตรวจสอบข้อมูลต่อไปนี้

  • ความถูกต้องของที่อยู่
  • ที่อยู่ไม่มีหมายเลขสถานที่ย่อย
  • หมายเลขสถานที่ย่อยไม่มีอยู่ในระบบข้อมูลของ 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.