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

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

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