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

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

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

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

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

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

ในuspsDataการตอบกลับdpvConfirmation ฟิลด์จะแสดงอักขระเดียวเพื่อแจ้งให้คุณทราบว่า 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 of 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.