Package google.maps.addressvalidation.v1

ดัชนี

AddressValidation

บริการสำหรับตรวจสอบความถูกต้องของที่อยู่

ProvideValidationFeedback

rpc ProvideValidationFeedback(ProvideValidationFeedbackRequest) returns (ProvideValidationFeedbackResponse)

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

rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse)

ตรวจสอบที่อยู่

ที่อยู่

รายละเอียดของที่อยู่หลังการประมวลผล ขั้นตอนหลังการประมวลผลประกอบด้วยการแก้ไขส่วนที่สะกดผิดของที่อยู่ แทนที่ส่วนที่ไม่ถูกต้อง และอนุมานส่วนที่ขาดหายไป

ช่อง
formatted_address

string

ที่อยู่หลังการประมวลผลซึ่งมีการจัดรูปแบบเป็นที่อยู่บรรทัดเดียวตามกฎการจัดรูปแบบที่อยู่ของภูมิภาคที่อยู่ที่ตั้งอยู่

หมายเหตุ: รูปแบบของที่อยู่นี้อาจไม่ตรงกับรูปแบบของที่อยู่ในช่อง postal_address เช่น postal_address จะแสดงประเทศเป็นregion_code 2 ตัวอักษรเสมอ เช่น "US" หรือ "NZ" ในทางตรงกันข้าม ฟิลด์นี้ใช้ชื่อประเทศแบบยาว เช่น "สหรัฐอเมริกา" หรือ "นิวซีแลนด์"
postal_address

PostalAddress

ที่อยู่หลังการประมวลผลที่แสดงเป็นที่อยู่ไปรษณีย์
address_components[]

AddressComponent

รายการที่ไม่เรียงลําดับ องค์ประกอบที่อยู่แต่ละรายการของที่อยู่ที่ได้รับการจัดรูปแบบและแก้ไขแล้ว พร้อมข้อมูลการตรวจสอบ ซึ่งจะแสดงข้อมูลเกี่ยวกับสถานะการตรวจสอบของคอมโพเนนต์แต่ละรายการ

องค์ประกอบที่อยู่ไม่ได้จัดเรียงตามลําดับที่เจาะจง อย่าคาดเดาลำดับขององค์ประกอบที่อยู่ในรายการ
missing_component_types[]

string

ประเภทของคอมโพเนนต์ที่คาดว่าจะอยู่ในที่อยู่สำหรับจัดส่งที่มีการจัดรูปแบบถูกต้อง แต่ไม่พบคําสั่งซื้อในอินพุตและไม่สามารถอนุมานได้ ตัวอย่างเช่น ['street_number', 'route'] สำหรับอินพุตอย่าง "Boulder, Colorado, 80301, USA" ดูรายการประเภทที่เป็นไปได้ได้ที่นี่

หมายเหตุ: คุณอาจเห็นประเภทคอมโพเนนต์ที่ขาดหายไปเมื่อคิดว่าได้ระบุคอมโพเนนต์ที่ขาดหายไปแล้ว ตัวอย่างเช่น กรณีนี้อาจเกิดขึ้นเมื่อที่อยู่ป้อนมีชื่ออาคาร แต่ไม่มีหมายเลขพร็อพเพอร์ตี้ ในที่อยู่ "渋谷区渋谷３丁目　Shibuya Stream" ชื่ออาคาร "Shibuya Stream" มีประเภทคอมโพเนนต์เป็น premise แต่ไม่มีหมายเลขสถานที่ตั้ง ดังนั้น missing_component_types จะมี premise
unconfirmed_component_types[]

string

ประเภทของคอมโพเนนต์ที่มีอยู่ใน address_components แต่ไม่สามารถยืนยันความถูกต้องได้ ช่องนี้มีไว้เพื่อความสะดวก เนื้อหาของช่องนี้เทียบเท่ากับการวนผ่าน address_components เพื่อค้นหาประเภทของคอมโพเนนต์ทั้งหมดที่ confirmation_level ไม่ใช่ CONFIRMED หรือไม่ได้ตั้งค่า Flag inferred เป็น true ดูรายการประเภทที่เป็นไปได้ได้ที่นี่
unresolved_tokens[]

string

โทเค็นในอินพุตที่ไม่สามารถแก้ไขได้ อาจเป็นอินพุตที่ระบบไม่รู้จักว่าเป็นส่วนที่ถูกต้องของที่อยู่ ตัวอย่างเช่น สำหรับอินพุต เช่น "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US" โทเค็นที่ยังไม่ได้รับการแก้ไขอาจมีลักษณะดังนี้ ["Parcel", "0000123123", "&", "0000456456"]

AddressComponent

แสดงองค์ประกอบที่อยู่ เช่น ถนน เมือง หรือรัฐ

ช่อง
component_name

ComponentName

ชื่อของคอมโพเนนต์นี้
component_type

string

ประเภทของคอมโพเนนต์ที่อยู่ ดูรายการประเภทที่เป็นไปได้ได้ในตารางที่ 2: ประเภทเพิ่มเติมที่บริการสถานที่แสดงผล
confirmation_level

ConfirmationLevel

บ่งบอกระดับความแน่นอนที่เรามีว่าคอมโพเนนต์นั้นถูกต้อง
inferred

bool

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

bool

บ่งบอกการแก้ไขการสะกดผิดในชื่อคอมโพเนนต์ API อาจไม่ได้แจ้งว่าการเปลี่ยนแปลงจากรูปแบบการสะกดคำรูปแบบหนึ่งเป็นรูปแบบอื่นเป็นข้อผิดพลาดเสมอไป เช่น เมื่อเปลี่ยนจาก "centre" เป็น "center" นอกจากนี้ ระบบจะไม่แจ้งการสะกดผิดที่พบบ่อยเสมอไป เช่น เมื่อเปลี่ยน "Amphitheater Pkwy" เป็น "Amphitheatre Pkwy"
replaced

bool

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

bool

ระบุองค์ประกอบที่อยู่ที่ไม่ควรจะอยู่ในที่อยู่ไปรษณีย์ของภูมิภาคหนึ่งๆ เราจึงเก็บไว้เนื่องจากเป็นส่วนหนึ่งของอินพุต

ConfirmationLevel

ค่าต่างๆ ที่เป็นไปได้สำหรับระดับการยืนยัน

Enum
CONFIRMATION_LEVEL_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้งาน
CONFIRMED เรายืนยันได้ว่าคอมโพเนนต์นี้มีอยู่และเหมาะสมในบริบทของที่อยู่ส่วนที่เหลือ
UNCONFIRMED_BUT_PLAUSIBLE ไม่สามารถยืนยันคอมโพเนนต์นี้ได้ แต่มีความเป็นไปได้ที่จะมีคอมโพเนนต์นี้อยู่ เช่น หมายเลขถนนที่อยู่ในช่วงตัวเลขที่ถูกต้องซึ่งทราบแล้วบนถนนที่ไม่ทราบหมายเลขบ้านที่เฉพาะเจาะจง
UNCONFIRMED_AND_SUSPICIOUS คอมโพเนนต์นี้ไม่ได้รับการยืนยันและอาจมีข้อมูลไม่ถูกต้อง เช่น ย่านที่ไม่ตรงกับส่วนอื่นของที่อยู่

AddressMetadata

ข้อมูลเมตาของที่อยู่หลังการประมวลผล เราไม่รับประกันว่า metadata จะแสดงข้อมูลอย่างครบถ้วนสำหรับทุกที่อยู่ซึ่งส่งไปยัง Address Validation API

ช่อง
business

bool

ระบุว่านี่คือที่อยู่ของธุรกิจ หากไม่ได้ตั้งค่าไว้ แสดงว่าไม่ทราบค่า
po_box

bool

ระบุว่าเป็นที่อยู่ของตู้ ปณ. หากไม่ได้ตั้งค่าไว้ แสดงว่าไม่ทราบค่า
residential

bool

ระบุว่าเป็นที่อยู่ของที่พักอาศัย หากไม่ได้ตั้งค่าไว้ แสดงว่าไม่ทราบค่า

ComponentName

Wrapper สําหรับชื่อของคอมโพเนนต์

ช่อง
text

string

ข้อความชื่อ เช่น "5th Avenue" สำหรับชื่อถนน หรือ "1253" สำหรับเลขที่ถนน
language_code

string

รหัสภาษา BCP-47 จะไม่มีข้อมูลนี้หากชื่อคอมโพเนนต์ไม่ได้เชื่อมโยงกับภาษา เช่น เลขที่

รหัสพิกัดภูมิศาสตร์

มีข้อมูลเกี่ยวกับสถานที่ที่แปลงพิกัดภูมิศาสตร์ของอินพุต

ช่อง
location

LatLng

ตำแหน่งที่ป้อนข้อมูลซึ่งเข้ารหัสพิกัดภูมิศาสตร์แล้ว

เราขอแนะนำให้ใช้รหัสสถานที่แทนการใช้ที่อยู่ พิกัดละติจูด/ลองจิจูด หรือ Plus Codes การใช้พิกัดเมื่อกำหนดเส้นทางหรือคำนวณเส้นทางขับรถจะทำให้ระบบจับจุดไปยังถนนที่อยู่ใกล้กับพิกัดเหล่านั้นที่สุดเสมอ ถนนนี้อาจไม่ใช่ถนนที่จะนำคุณไปยังจุดหมายอย่างรวดเร็วหรือปลอดภัย และอาจไม่ได้อยู่ใกล้กับจุดเข้าใช้งานของที่พัก นอกจากนี้ เมื่อมีการแปลงพิกัดภูมิศาสตร์ย้อนกลับ เราไม่รับประกันว่าที่อยู่ที่ได้รับจะตรงกับที่อยู่เดิม
plus_code

PlusCode

Plus Code ที่สอดคล้องกับ location
bounds

Viewport

ขอบเขตของสถานที่ที่ผ่านการเข้ารหัสพิกัดภูมิศาสตร์
feature_size_meters

float

ขนาดของสถานที่ที่ระบุพิกัดภูมิศาสตร์เป็นเมตร ค่านี้เป็นอีกวิธีในการวัดความหยาบของตำแหน่งที่ผ่านการเข้ารหัสพิกัดภูมิศาสตร์ แต่วัดจากขนาดจริงแทนความหมายเชิงอรรถศาสตร์
place_id

string

รหัสสถานที่ของสถานที่ที่ข้อมูลนี้เข้ารหัสพิกัดภูมิศาสตร์

ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่นี่
place_types[]

string

ประเภทสถานที่ที่ระบบจับคู่พิกัดภูมิศาสตร์ของอินพุต เช่น ['locality', 'political'] ดูรายการประเภททั้งหมดได้ที่นี่

LanguageOptions

เวอร์ชันตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจใช้ร่วมกับเวอร์ชันอื่นๆ ของเวอร์ชันก่อน GA ไม่ได้ ข้อเสนอก่อนเปิดตัวอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายสถานะการเปิดตัว

ช่วยให้ Address Validation API รวมข้อมูลเพิ่มเติมในการตอบกลับได้

ช่อง
return_english_latin_address

bool

ตัวอย่าง: แสดงผล google.maps.addressvalidation.v1.Address เป็นภาษาอังกฤษ ดูรายละเอียดได้ที่ google.maps.addressvalidation.v1.ValidationResult.english_latin_address

PlusCode

Plus Code (http://plus.codes) คือข้อมูลอ้างอิงตำแหน่งที่มี 2 รูปแบบ ได้แก่ โค้ดสากลที่กำหนดสี่เหลี่ยมผืนผ้าขนาด 14x14 เมตร (1/8000 องศา) หรือเล็กกว่านั้น และโค้ดแบบผสมที่ใช้สถานที่อ้างอิงแทนคำนำหน้า

ช่อง
global_code

string

รหัสสากล (แบบเต็ม) ของสถานที่ เช่น "9FWM33GV+HQ" ซึ่งแสดงพื้นที่ 1/8000 องศาคูณ 1/8000 องศา (~14 x 14 เมตร)
compound_code

string

รหัสแบบผสมของสถานที่ เช่น "33GV+HQ, Ramberg, Norway" ซึ่งมีนามสกุลของรหัสสากลและแทนที่คำนำหน้าด้วยชื่อที่มีการจัดรูปแบบของเอนทิตีอ้างอิง

ProvideValidationFeedbackRequest

คำขอส่งความคิดเห็นเกี่ยวกับการยืนยัน

ช่อง
conclusion

ValidationConclusion

ต้องระบุ ผลลัพธ์ของลําดับความพยายามตรวจสอบ

หากตั้งค่าช่องนี้เป็น VALIDATION_CONCLUSION_UNSPECIFIED ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
response_id

string

ต้องระบุ รหัสของคำตอบที่ความคิดเห็นนี้ใช้อ้างอิง ซึ่งควรเป็น [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] จากการตอบกลับครั้งแรกในชุดการพยายามตรวจสอบที่อยู่

ValidationConclusion

ผลลัพธ์สุดท้ายที่เป็นไปได้ของลําดับคําขอยืนยันที่อยู่ที่จําเป็นสําหรับยืนยันที่อยู่

Enum
VALIDATION_CONCLUSION_UNSPECIFIED ค่านี้ไม่ได้ใช้งาน หากตั้งค่าช่อง ProvideValidationFeedbackRequest.conclusion เป็น VALIDATION_CONCLUSION_UNSPECIFIED ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
VALIDATED_VERSION_USED ระบบใช้ที่อยู่เวอร์ชันที่ Address Validation API แสดงผลสำหรับธุรกรรม
USER_VERSION_USED มีการระบุที่อยู่เวอร์ชันที่ผู้ใช้ระบุไว้สำหรับธุรกรรม
UNVALIDATED_VERSION_USED ระบบใช้ที่อยู่เวอร์ชันที่ป้อนหลังจากพยายามตรวจสอบครั้งล่าสุดแต่ไม่ได้ตรวจสอบอีกครั้งสำหรับธุรกรรม
UNUSED ธุรกรรมถูกยกเลิกและไม่ได้ใช้ที่อยู่

ProvideValidationFeedbackResponse

ประเภทนี้ไม่มีช่อง

การตอบกลับความคิดเห็นเกี่ยวกับการให้สิทธิ์

การตอบกลับจะว่างเปล่าหากส่งความคิดเห็นสำเร็จ

UspsAddress

การนำเสนอที่อยู่ของสหรัฐอเมริกาโดย USPS

ช่อง
first_address_line

string

บรรทัดที่อยู่แรก
firm

string

ชื่อบริษัท
second_address_line

string

ที่อยู่บรรทัดที่ 2
urbanization

string

ชื่อเมืองในเปอร์โตริโก
city_state_zip_address_line

string

เมือง + รัฐ + รหัสไปรษณีย์
city

string

ชื่อเมือง
state

string

รหัสรัฐ 2 ตัวอักษร
zip_code

string

รหัสไปรษณีย์ เช่น 10009
zip_code_extension

string

ส่วนขยายรหัสไปรษณีย์ 4 หลัก เช่น 5023

UspsData

ข้อมูล USPS สำหรับที่อยู่ เราไม่รับประกันว่า uspsData จะแสดงข้อมูลที่อยู่ของสหรัฐอเมริกาหรือเปอร์โตริโกทุกรายการที่ส่งไปยัง Address Validation API อย่างครบถ้วน เราขอแนะนำให้ผสานรวมช่องที่อยู่สำรองในการตอบกลับหากคุณใช้ uspsData เป็นส่วนหลักของคำตอบ

ช่อง
standardized_address

UspsAddress

ที่อยู่แบบมาตรฐานของ USPS
delivery_point_code

string

รหัสจุดนำส่ง 2 หลัก
delivery_point_check_digit

string

หมายเลขตรวจสอบจุดนำส่ง ระบบจะเพิ่มหมายเลขนี้ไว้ที่ส่วนท้ายของ delivery_point_barcode สำหรับจดหมายที่สแกนด้วยเครื่อง การนำตัวเลขทั้งหมดของ delivery_point_barcode, delivery_point_check_digit, postal code และ ZIP+4 มาบวกกันควรให้ผลลัพธ์ที่หารด้วย 10 ได้
dpv_confirmation

string

ค่าที่เป็นไปได้สำหรับการยืนยัน DPV แสดงผลอักขระเดี่ยวหรือไม่แสดงผลค่าใดๆ

  • N: ยืนยันหมายเลขหลักและหมายเลขรองด้วย DPV ไม่สำเร็จ
  • D: ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และไม่มีข้อมูลหมายเลขรอง
  • S: ที่อยู่ได้รับการยืนยันผ่าน DPV สำหรับหมายเลขหลักเท่านั้น และมีข้อมูลหมายเลขรองแต่ไม่ได้รับการยืนยัน
  • Y: ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักและหมายเลขรอง
  • ว่าง: หากคำตอบไม่มีค่า dpv_confirmation แสดงว่าไม่มีการส่งที่อยู่เพื่อยืนยัน DPV
dpv_footnote

string

เชิงอรรถจากการตรวจสอบจุดนำส่ง เชิงอรรถหลายรายการอาจต่อท้ายกันอยู่ในสตริงเดียวกัน

  • AA: ป้อนที่อยู่ซึ่งตรงกับไฟล์ ZIP+4
  • A1: ที่อยู่ป้อนไม่ตรงกับไฟล์ ZIP+4
  • BB: จับคู่กับ DPV (คอมโพเนนต์ทั้งหมด)
  • CC: หมายเลขรองไม่ตรงกันและไม่จําเป็น
  • C1: หมายเลขรองไม่ตรงกัน แต่จำเป็นต้องระบุ
  • N1: ที่อยู่อาคารสูงไม่มีหมายเลขรอง
  • M1: ไม่มีหมายเลขหลัก
  • M3: หมายเลขหลักไม่ถูกต้อง
  • P1: ป้อนที่อยู่ PO, RR หรือ HC ที่ไม่มีหมายเลขกล่อง
  • P3: หมายเลข PO, RR หรือ HC Box ที่ป้อนไม่ถูกต้อง
  • F1: ป้อนที่อยู่ซึ่งตรงกับที่อยู่ของหน่วยทหาร
  • G1: ป้อนที่อยู่ซึ่งตรงกับที่อยู่สำหรับจัดส่งทั่วไป
  • U1: ป้อนที่อยู่ซึ่งตรงกับรหัสไปรษณีย์ที่ไม่ซ้ำกัน
  • PB: ป้อนที่อยู่ซึ่งตรงกับระเบียน PBSA
  • RR: DPV ยืนยันที่อยู่ด้วยข้อมูล PMB
  • R1: ที่อยู่ที่ได้รับการยืนยันจาก DPV โดยไม่มีข้อมูล PMB
  • R7: ระเบียนเส้นทางของผู้ให้บริการ R777 หรือ R779
  • IA: ระบุที่อยู่ที่ได้รับแจ้งแล้ว
  • TA: หมายเลขหลักที่ตรงกันโดยตัดตัวอักษรตามหลังออก
dpv_cmra

string

ระบุว่าที่อยู่เป็น CMRA (Commercial Mail Receiving Agency) ซึ่งเป็นธุรกิจส่วนตัวที่รับจดหมายสำหรับลูกค้าหรือไม่ แสดงผลอักขระเดียว

  • Y: ที่อยู่เป็น CMRA
  • N: ที่อยู่ไม่ใช่ CMRA
dpv_vacant

string

สถานที่นี้ว่างไหม แสดงผลอักขระเดียว

  • Y: ไม่มีผู้รับในที่อยู่ที่ระบุ
  • N: ที่อยู่มีคนอยู่
dpv_no_stat

string

ที่อยู่นี้เป็นที่อยู่ที่ไม่มีสถิติหรือที่อยู่ที่มีการใช้งาน ที่อยู่ที่ไม่มีสถิติคือที่อยู่ที่ไม่มีผู้อยู่อาศัยอย่างต่อเนื่องหรือที่อยู่ที่ไม่ได้อยู่ในบริการของ USPS แสดงผลอักขระเดียว

  • Y: ที่อยู่ไม่ทำงาน
  • N: ที่อยู่ใช้งานได้
dpv_no_stat_reason_code

int32

ระบุประเภท NoStat แสดงผลรหัสเหตุผลเป็น int

  • 1: IDA (ที่อยู่สำหรับจัดส่งภายใน) – ที่อยู่ที่ไม่รับจดหมายจาก USPS โดยตรง แต่มีการนำส่งไปยังที่อยู่สำหรับจัดส่งที่ให้บริการ
  • 2: CDS - ที่อยู่ซึ่งยังไม่พร้อมใช้งาน เช่น มีการแบ่งที่ดินใหม่ซึ่งมีการระบุแปลงและหมายเลขหลักแล้ว แต่ยังไม่มีโครงสร้างสำหรับการเข้าพัก
  • 3: ที่อยู่ซ้ำ - ที่อยู่ที่ไม่ได้ยืนยันด้วย DPV
  • 4: CMZ (วิทยาลัย ทหาร และประเภทอื่นๆ) - รหัสไปรษณีย์ + 4 ระเบียนที่ USPS รวมไว้ในข้อมูล
  • 5: ปกติ - บ่งชี้ที่อยู่ที่ไม่ได้รับการนําส่ง และระบบจะไม่นับที่อยู่ดังกล่าวเป็นการนําส่งที่เป็นไปได้
  • 6: ต้องระบุข้อมูลรอง - ที่อยู่ต้องใช้ข้อมูลรอง
dpv_drop

string

การตั้งค่าสถานะบ่งบอกว่ามีการนำส่งจดหมายไปยังกล่องรับจดหมายใบเดียวในเว็บไซต์ แสดงผลอักขระเดียว

  • Y: การนำส่งจดหมายไปยังกล่องรับจดหมายแห่งเดียวในสถานที่หนึ่ง
  • N: ไม่ได้นำส่งจดหมายไปยังกล่องรับจดหมายแห่งเดียวในสถานที่หนึ่ง
dpv_throwback

string

บ่งบอกว่าไม่ได้นำส่งจดหมายไปยังที่อยู่ แสดงผลอักขระเดียว

  • Y: ไม่ได้นำส่งจดหมายไปยังที่อยู่
  • N: ไปรษณีย์นำส่งไปยังที่อยู่
dpv_non_delivery_days

string

การตั้งค่าสถานะบ่งบอกว่าการนำส่งจดหมายไม่ได้ดำเนินการทุกวันในสัปดาห์ แสดงผลอักขระเดียว

  • Y: การนำส่งจดหมายไม่ได้ดำเนินการทุกวันในสัปดาห์
  • N: ไม่มีข้อบ่งชี้ว่าการนำส่งจดหมายไม่ได้ดำเนินการทุกวันในสัปดาห์
dpv_non_delivery_days_values

int32

จำนวนเต็มระบุวันที่ไม่มีการนำส่ง ซึ่งสามารถตรวจสอบโดยใช้ Flag แบบบิต ดังนี้ 0x40 – วันอาทิตย์เป็นวันที่ไม่มีการนำส่ง 0x20 – วันจันทร์เป็นวันที่ไม่มีการนำส่ง 0x10 – วันอังคารเป็นวันที่ไม่มีการนำส่ง 0x08 – วันพุธเป็นวันที่ไม่มีการนำส่ง 0x04 – วันพฤหัสบดีเป็นวันที่ไม่มีการนำส่ง 0x02 – วันศุกร์เป็นวันที่ไม่มีการนำส่ง 0x01 – วันเสาร์เป็นวันที่ไม่มีการนำส่ง
dpv_no_secure_location

string

แจ้งว่าประตูเข้าถึงได้ แต่จะไม่มีการทิ้งพัสดุเนื่องจากข้อกังวลด้านความปลอดภัย แสดงผลอักขระเดียว

  • Y: จะไม่มีการนำพัสดุไปไว้ที่หน้าประตูเนื่องจากข้อกังวลด้านความปลอดภัย
  • N: ไม่มีข้อบ่งชี้ว่าจะไม่นำส่งพัสดุเนื่องจากข้อกังวลด้านความปลอดภัย
dpv_pbsa

string

บ่งบอกว่าที่อยู่ตรงกับระเบียน PBSA แสดงผลอักขระเดียว

  • Y: ที่อยู่ตรงกับระเบียน PBSA
  • N: ที่อยู่ไม่ตรงกับระเบียน PBSA
dpv_door_not_accessible

string

แจ้งว่า USPS ไม่สามารถเคาะประตูเพื่อนำส่งจดหมาย แสดงผลอักขระเดียว

  • Y: เข้าถึงประตูไม่ได้
  • N: ไม่มีป้ายระบุว่าประตูเข้าถึงไม่ได้
dpv_enhanced_delivery_code

string

บ่งบอกว่าที่อยู่ใช้รหัสผลลัพธ์ DPV ได้มากกว่า 1 รหัส แสดงผลอักขระเดียว

  • Y: ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักและหมายเลขรอง
  • N: ยืนยันหมายเลขหลักและหมายเลขรองด้วย DPV ไม่สำเร็จ
  • S: ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และข้อมูลหมายเลขรองมีให้แต่ไม่ได้รับการยืนยัน หรือมีการลบอักษรตัวสุดท้าย 1 ตัวในหมายเลขหลักออกเพื่อให้ตรงกับ DPV และจำเป็นต้องใช้ข้อมูลรอง
  • D: ที่อยู่ได้รับการยืนยัน DPV สำหรับหมายเลขหลักเท่านั้น และไม่มีข้อมูลหมายเลขรอง
  • R: ยืนยันที่อยู่แล้ว แต่กำหนดเส้นทางเป็นเส้นทางที่ไม่มีอยู่จริง R777 และ R779 และไม่ได้ระบุการนำส่งของ USPS
carrier_route

string

รหัสเส้นทางของผู้ให้บริการ รหัส 4 อักขระที่ประกอบด้วยคำนำหน้า 1 อักขระและตัวระบุเส้นทาง 3 หลัก

คำนำหน้า

  • C: เส้นทางของผู้ให้บริการขนส่ง (หรือเส้นทางในเมือง)
  • R: เส้นทางชนบท
  • H: เส้นทางสัญญาทางหลวง
  • B: ส่วนตู้ ปณ.
  • G: หน่วยการนำส่งทั่วไป
carrier_route_indicator

string

ตัวบ่งชี้การจัดเรียงอัตราเส้นทางของผู้ให้บริการขนส่ง
ews_no_match

bool

ที่อยู่สำหรับจัดส่งจับคู่ได้ แต่ไฟล์ EWS ระบุว่าการจับคู่ที่ตรงกันทั้งหมดจะพร้อมใช้งานในเร็วๆ นี้
post_office_city

string

เมืองที่มีที่ทำการไปรษณีย์หลัก
post_office_state

string

รัฐของที่ทำการไปรษณีย์หลัก
abbreviated_city

string

เมืองแบบย่อ
fips_county_code

string

รหัส FIPS ของเคาน์ตี้
county

string

ชื่อเคาน์ตี้
elot_number

string

หมายเลขเส้นทางที่ปรับปรุงแล้ว (eLOT)
elot_flag

string

Flag (A/D) ของ eLOT ที่เพิ่มขึ้น/ลดลง
po_box_only_postal_code

bool

รหัสไปรษณีย์ของตู้ ปณ. เท่านั้น
pmb_designator

string

ตัวระบุหน่วย PMB (ตู้จดหมายส่วนตัว)
pmb_number

string

หมายเลข PMB (ตู้จดหมายส่วนตัว)
address_record_type

string

ประเภทระเบียนที่อยู่ซึ่งตรงกับที่อยู่ที่ป้อน

  • F: FIRM รายการนี้ตรงกับระเบียนบริษัท ซึ่งเป็นการจับคู่ในระดับที่ละเอียดที่สุดสำหรับที่อยู่
  • G: การนำส่งทั่วไป รายการนี้ตรงกับระเบียนการนำส่งทั่วไป
  • H: อาคาร / อพาร์ตเมนต์ รายการนี้ตรงกับระเบียนอาคารหรืออพาร์ตเมนต์
  • P: ที่ทำการไปรษณีย์ ที่อยู่นี้ตรงกับตู้ไปรษณีย์
  • R: เส้นทางชนบทหรือสัญญาทางหลวง: รายการนี้ตรงกับระเบียนเส้นทางชนบทหรือสัญญาทางหลวง ซึ่งทั้ง 2 รายการอาจมีช่วงหมายเลขกล่องที่เกี่ยวข้อง
  • S: RECORD ถนน: รายการนี้ตรงกับ RECORD ถนนซึ่งมีช่วงหมายเลขหลักที่ถูกต้อง
default_address

bool

ตัวบ่งชี้ที่ระบุว่าพบที่อยู่เริ่มต้น แต่มีที่อยู่เฉพาะเจาะจงมากกว่า
error_message

string

ข้อความแสดงข้อผิดพลาดสำหรับการดึงข้อมูล USPS ข้อมูลนี้จะแสดงขึ้นเมื่อการประมวลผลของ USPS ถูกระงับเนื่องจากตรวจพบที่อยู่ที่สร้างขึ้นมา

ฟิลด์ข้อมูล USPS อาจไม่แสดงเมื่อมีข้อผิดพลาดนี้
cass_processed

bool

ตัวบ่งชี้ว่าคําขอได้รับการประมวลผล CASS แล้ว

ValidateAddressRequest

คำขอยืนยันที่อยู่

ช่อง
address

PostalAddress

ต้องระบุ ที่อยู่อยู่ระหว่างการตรวจสอบ คุณควรส่งที่อยู่ที่ไม่มีการจัดรูปแบบผ่าน address_lines

ความยาวรวมของช่องในอินพุตนี้ต้องไม่เกิน 280 อักขระ

ดูภูมิภาคที่รองรับได้ที่นี่

ระบบจะสงวนค่า language_code ในที่อยู่อินพุตไว้สำหรับการใช้งานในอนาคตและจะไม่สนใจในตอนนี้ ระบบจะป้อนข้อมูลที่อยู่ที่ได้รับการตรวจสอบตามภาษาที่ต้องการสำหรับที่อยู่นั้นๆ ตามที่ระบบระบุ

Address Validation API ไม่สนใจค่าใน recipients และ organization ระบบจะทิ้งค่าในช่องเหล่านั้นและไม่แสดงผล โปรดอย่าตั้งค่า
previous_response_id

string

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

bool

เปิดใช้โหมดที่เข้ากันได้กับ USPS CASS ซึ่งจะส่งผลต่อเฉพาะช่อง google.maps.addressvalidation.v1.ValidationResult.usps_data ของ google.maps.addressvalidation.v1.ValidationResult หมายเหตุ: สำหรับคำขอที่อยู่ในเปอร์โตริโกที่เปิดใช้ CASS ของ USPS คุณต้องระบุ google.type.PostalAddress.region_code ของ address เป็น "PR" หรือระบุ google.type.PostalAddress.administrative_area ของ address เป็น "เปอร์โตริโก" (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) หรือ "PR"

เราขอแนะนำให้ใช้ address แบบคอมโพเนนต์ หรือระบุ google.type.PostalAddress.address_lines อย่างน้อย 2 รายการ โดยให้บรรทัดแรกมีหมายเลขและชื่อถนน ส่วนบรรทัดที่ 2 มีเมือง รัฐ และรหัสไปรษณีย์
language_options

LanguageOptions

ไม่บังคับ เวอร์ชันตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจใช้ร่วมกับเวอร์ชันอื่นๆ ของเวอร์ชันก่อน GA ไม่ได้ ข้อเสนอก่อนเปิดตัวอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายสถานะการเปิดตัว

ช่วยให้ Address Validation API รวมข้อมูลเพิ่มเติมในการตอบกลับได้
session_token

string

ไม่บังคับ สตริงที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อวัตถุประสงค์ในการเรียกเก็บเงิน ต้องเป็นสตริง Base64 ที่ปลอดภัยสำหรับ URL และชื่อไฟล์ซึ่งมีความยาวไม่เกิน 36 อักขระ ASCII ไม่เช่นนั้น ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

เซสชันจะเริ่มขึ้นเมื่อผู้ใช้ทำการค้นหาแบบเติมข้อความอัตโนมัติ และสิ้นสุดลงเมื่อผู้ใช้เลือกสถานที่และมีการเรียกใช้รายละเอียดสถานที่หรือการยืนยันที่อยู่ เซสชันแต่ละรายการอาจมีคำค้นหาที่ระบบเติมข้อความอัตโนมัติหลายรายการ ตามด้วยคำขอรายละเอียดสถานที่หรือการยืนยันที่อยู่ 1 รายการ ข้อมูลเข้าสู่ระบบที่ใช้สำหรับคำขอแต่ละรายการภายในเซสชันต้องมาจากโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อเซสชันสิ้นสุดลง โทเค็นจะไม่มีผลอีกต่อไป แอปของคุณจึงต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ใส่พารามิเตอร์ sessionToken หรือคุณใช้โทเค็นเซสชันซ้ำ ระบบจะเรียกเก็บเงินสำหรับเซสชันนั้นเสมือนว่าไม่ได้ระบุโทเค็นเซสชัน (ระบบจะเรียกเก็บเงินสำหรับคำขอแต่ละรายการแยกกัน)

หมายเหตุ: การตรวจสอบที่อยู่ใช้ได้เฉพาะในเซสชันที่มี Autocomplete (ใหม่) API เท่านั้น จะใช้กับ Autocomplete API ไม่ได้ ดูรายละเอียดเพิ่มเติมได้ที่ https://developers.google.com/maps/documentation/places/web-service/session-pricing

ValidateAddressResponse

การตอบกลับคำขอตรวจสอบที่อยู่

ช่อง
result

ValidationResult

ผลการตรวจสอบที่อยู่
response_id

string

UUID ที่ระบุการตอบกลับนี้ หากต้องการตรวจสอบที่อยู่อีกครั้ง UUID นี้ต้องมาพร้อมกับคำขอใหม่

ValidationResult

ผลการตรวจสอบที่อยู่

ช่อง
verdict

Verdict

แฟล็กคำตัดสินโดยรวม
address

Address

ข้อมูลเกี่ยวกับที่อยู่ ไม่ใช่พิกัดภูมิศาสตร์
geocode

Geocode

ข้อมูลเกี่ยวกับสถานที่ตั้งและสถานที่ที่ที่อยู่ได้รับการจับคู่พิกัดภูมิศาสตร์
metadata

AddressMetadata

ข้อมูลอื่นๆ ที่เกี่ยวข้องกับความสามารถในการนำส่ง เราไม่รับประกันว่า metadata จะแสดงข้อมูลอย่างครบถ้วนสำหรับทุกที่อยู่ซึ่งส่งไปยัง Address Validation API
usps_data

UspsData

Flag ความสามารถในการนำส่งเพิ่มเติมที่ USPS ระบุ มีให้บริการในภูมิภาค US และ PR เท่านั้น
english_latin_address

Address

เวอร์ชันตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจใช้ร่วมกับเวอร์ชันอื่นๆ ของเวอร์ชันก่อน GA ไม่ได้ ข้อเสนอก่อนเปิดตัวอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายสถานะการเปิดตัว

ที่อยู่แปลเป็นภาษาอังกฤษ

ที่อยู่ที่ได้รับการแปลจะใช้ซ้ำเป็นอินพุต API ไม่ได้ บริการมีคำอธิบายเพื่อให้ผู้ใช้ใช้ภาษาแม่ของตนเพื่อยืนยันหรือปฏิเสธการตรวจสอบที่อยู่ที่ให้ไว้ตั้งแต่แรกได้

หากส่วนใดส่วนหนึ่งของที่อยู่ไม่มีคำแปลภาษาอังกฤษ บริการจะแสดงผลส่วนนั้นในภาษาอื่นที่ใช้อักษรละติน ดูคำอธิบายเกี่ยวกับวิธีเลือกภาษาอื่นได้ที่นี่ หากส่วนใดส่วนหนึ่งของที่อยู่ไม่มีคำแปลหรือการถอดเสียงเป็นภาษาที่ใช้อักษรละติน บริการจะแสดงผลส่วนนั้นในภาษาท้องถิ่นที่เชื่อมโยงกับที่อยู่

เปิดใช้เอาต์พุตนี้โดยใช้ Flag google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address

หมายเหตุ: ช่อง google.maps.addressvalidation.v1.Address.unconfirmed_component_types ใน english_latin_address และช่อง google.maps.addressvalidation.v1.AddressComponent.confirmation_level ใน english_latin_address.address_components ไม่มีข้อมูล

คำตัดสิน

ภาพรวมระดับสูงของผลการตรวจสอบที่อยู่และพิกัดภูมิศาสตร์

ช่อง
input_granularity

Granularity

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

เช่น หากที่อยู่ป้อนมีหมายเลขอพาร์ตเมนต์ที่เฉพาะเจาะจง input_granularity ที่นี่จะเป็น SUB_PREMISE หากบริการตรวจสอบที่อยู่จับคู่หมายเลขอพาร์ตเมนต์ในฐานข้อมูลไม่ได้หรือหมายเลขอพาร์ตเมนต์ไม่ถูกต้อง validation_granularity มีแนวโน้มที่จะเป็นแบบ PREMISE หรือหยาบกว่า
validation_granularity

Granularity

ระดับความละเอียดของที่อยู่หลังการประมวลผลที่ API สามารถตรวจสอบได้อย่างสมบูรณ์ เช่น validation_granularity ของ PREMISE บ่งบอกว่าสามารถตรวจสอบองค์ประกอบที่อยู่ทั้งหมดที่ระดับ PREMISE หรือต่ำกว่าได้

ผลการตรวจสอบองค์ประกอบที่อยู่แต่ละรายการจะแสดงใน google.maps.addressvalidation.v1.Address.address_components
geocode_granularity

Granularity

ข้อมูลเกี่ยวกับความละเอียดของ geocode ซึ่งหมายถึงความหมายเชิงอรรถศาสตร์ของความละเอียดของตำแหน่งที่ผ่านการเข้ารหัสพิกัดภูมิศาสตร์

ซึ่งบางครั้งอาจแตกต่างจาก validation_granularity ด้านบน เช่น ฐานข้อมูลของเราอาจบันทึกหมายเลขอพาร์ตเมนต์ แต่ไม่มีตำแหน่งที่แน่นอนของอพาร์ตเมนต์ภายในอาคารอพาร์ตเมนต์ขนาดใหญ่ ในกรณีนี้ validation_granularity จะกลายเป็น SUB_PREMISE แต่ geocode_granularity จะกลายเป็น PREMISE
address_complete

bool

ระบบจะถือว่าที่อยู่หลังการประมวลผลเสร็จสมบูรณ์หากไม่มีโทเค็นที่ยังไม่ได้รับการแก้ไข ไม่มีองค์ประกอบที่อยู่ที่ไม่คาดคิดหรือขาดหายไป หากไม่ได้ตั้งค่าไว้ แสดงว่าค่าคือ false ดูรายละเอียดเพิ่มเติมในช่อง missing_component_types, unresolved_tokens หรือ unexpected
has_unconfirmed_components

bool

ไม่สามารถจัดหมวดหมู่หรือตรวจสอบองค์ประกอบที่อยู่อย่างน้อย 1 รายการ ดูรายละเอียดที่ google.maps.addressvalidation.v1.Address.address_components
has_inferred_components

bool

ระบบอนุมาน (เพิ่ม) องค์ประกอบที่อยู่อย่างน้อย 1 รายการที่ไม่ได้อยู่ในอินพุต ดูรายละเอียดที่ google.maps.addressvalidation.v1.Address.address_components
has_replaced_components

bool

มีการเปลี่ยนองค์ประกอบที่อยู่อย่างน้อย 1 รายการ โปรดดูรายละเอียดที่ google.maps.addressvalidation.v1.Address.address_components
possible_next_action

PossibleNextAction

เวอร์ชันตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจใช้ร่วมกับเวอร์ชันอื่นๆ ของเวอร์ชันก่อน GA ไม่ได้ ข้อเสนอก่อนเปิดตัวอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายสถานะการเปิดตัว

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

bool

มีการแก้ไขตัวสะกดขององค์ประกอบที่อยู่อย่างน้อย 1 รายการ ดูรายละเอียดที่ google.maps.addressvalidation.v1.Address.address_components

รายละเอียด

รายละเอียดต่างๆ ที่ที่อยู่หรือพิกัดภูมิศาสตร์อาจมี เมื่อใช้เพื่อระบุความละเอียดของที่อยู่ ค่าเหล่านี้จะระบุความละเอียดของที่อยู่ที่จะระบุปลายทางการส่งจดหมาย เช่น ที่อยู่อย่าง "123 Main Street, Redwood City, CA, 94061" จะระบุ PREMISE ส่วนที่อยู่อย่าง "Redwood City, CA, 94061" จะระบุ LOCALITY อย่างไรก็ตาม หากไม่พบพิกัดภูมิศาสตร์สําหรับ "123 Main Street" ใน Redwood City พิกัดภูมิศาสตร์ที่แสดงอาจมีความละเอียดระดับ LOCALITY แม้ว่าที่อยู่จะมีความละเอียดมากกว่าก็ตาม

Enum
GRANULARITY_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้งาน
SUB_PREMISE ผลลัพธ์ที่อยู่ต่ำกว่าระดับอาคาร เช่น อพาร์ตเมนต์
PREMISE ผลลัพธ์ระดับอาคาร
PREMISE_PROXIMITY พิกัดภูมิศาสตร์ที่ประมาณตำแหน่งระดับอาคารของที่อยู่
BLOCK ที่อยู่หรือรหัสพิกัดภูมิศาสตร์แสดงถึงบล็อก ใช้เฉพาะในภูมิภาคที่มีการระบุที่อยู่ระดับบล็อก เช่น ญี่ปุ่น
ROUTE พิกัดภูมิศาสตร์หรือที่อยู่มีความละเอียดตามเส้นทาง เช่น ถนน ทางหลวง หรือทาง
OTHER รายละเอียดอื่นๆ ทั้งหมด ซึ่งจะจัดกลุ่มไว้ด้วยกันเนื่องจากไม่ใช่ข้อมูลที่จะนําส่งได้

PossibleNextAction

เวอร์ชันตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจมีการรองรับที่จำกัด และการเปลี่ยนแปลงผลิตภัณฑ์และฟีเจอร์เวอร์ชันก่อน GA อาจใช้ร่วมกับเวอร์ชันอื่นๆ ของเวอร์ชันก่อน GA ไม่ได้ ข้อเสนอก่อนเปิดตัวอยู่ภายใต้ข้อกำหนดเฉพาะบริการของ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ที่คำอธิบายสถานะการเปิดตัว

การดำเนินการถัดไปที่เป็นไปได้ซึ่งอาจทำได้ โดยอิงตามการตอบกลับของ API

Enum
POSSIBLE_NEXT_ACTION_UNSPECIFIED ค่าเริ่มต้น ค่านี้ไม่ได้ใช้งาน
FIX ช่องคำตอบของ API อย่างน้อย 1 ช่องบ่งบอกถึงปัญหาที่อาจเกิดขึ้นกับที่อยู่หลังการประมวลผล เช่น verdict.validation_granularity คือ OTHER การแจ้งให้ลูกค้าแก้ไขที่อยู่อาจช่วยปรับปรุงคุณภาพของที่อยู่ได้
CONFIRM_ADD_SUBPREMISES การตอบกลับของ API ระบุว่าที่อยู่หลังการประมวลผลอาจไม่มีพร็อพเพอร์ตี้ย่อย การแจ้งให้ลูกค้าตรวจสอบที่อยู่และพิจารณาเพิ่มหมายเลขห้องอาจช่วยปรับปรุงคุณภาพของที่อยู่ได้ ที่อยู่หลังการประมวลผลอาจมีปัญหาเล็กๆ น้อยๆ อื่นๆ ด้วย หมายเหตุ: ค่า enum นี้จะแสดงผลสำหรับที่อยู่ในสหรัฐอเมริกาเท่านั้น
CONFIRM ฟิลด์ของการตอบกลับ API อย่างน้อย 1 ฟิลด์บ่งบอกถึงปัญหาเล็กน้อยที่อาจเกิดขึ้นกับที่อยู่หลังการประมวลผล เช่น องค์ประกอบที่อยู่ postal_code คือ replaced การแจ้งให้ลูกค้าตรวจสอบที่อยู่อาจช่วยปรับปรุงคุณภาพของที่อยู่ได้
ACCEPT การตอบกลับของ API ไม่มีสัญญาณที่รับประกันค่า PossibleNextAction อื่นๆ คุณอาจพิจารณาใช้ที่อยู่หลังการประมวลผลโดยไม่ต้องแจ้งให้ลูกค้าทราบเพิ่มเติม แต่การดำเนินการนี้ไม่ได้รับประกันว่าที่อยู่นั้นถูกต้อง และที่อยู่ดังกล่าวอาจยังมีการแก้ไขอยู่ คุณมีหน้าที่รับผิดชอบในการพิจารณาว่าจะแจ้งให้ลูกค้าทราบหรือไม่และอย่างไร โดยขึ้นอยู่กับการประเมินความเสี่ยงของคุณเอง