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

เอกสารนี้ครอบคลุมการตรวจสอบที่อยู่สำหรับสหรัฐอเมริกาโดยเฉพาะ

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

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

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

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

ฟิลด์ dpvConfirmation จะแสดงผลอักขระเดียวเป็นส่วนหนึ่งของคำตอบ uspsData เพื่อแจ้งให้ทราบว่า 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
  • ภูมิภาค: สหรัฐอเมริกา
  • ฟิลด์ 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 จะเป็นที่อยู่ที่ถูกต้อง แต่ห้อง 101 เป็นส่วนที่อยู่ที่ไม่ถูกต้อง คุณอาจต้องพิจารณายืนยันข้อมูลนี้กับผู้ใช้และให้โอกาสแก้ไข

DPV Y example - accept the address

ตัวอย่างนี้ใช้ที่อยู่ 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.