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

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

ข้อมูล 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 แคลิฟอร์เนีย ที่อยู่ที่มีคุณภาพ

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