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

เอกสารนี้ครอบคลุมถึงการตรวจสอบที่อยู่เฉพาะในสหรัฐอเมริกา:

ข้อมูล 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, 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.