Package google.maps.addressvalidation.v1

ดัชนี

• AddressValidation (อินเทอร์เฟซ)
• Address (ข้อความ)
• AddressComponent (ข้อความ)
• AddressComponent.ConfirmationLevel (enum)
• AddressMetadata (ข้อความ)
• ComponentName (ข้อความ)
• Geocode (ข้อความ)
• LanguageOptions (ข้อความ)
• PlusCode (ข้อความ)
• ProvideValidationFeedbackRequest (ข้อความ)
• ProvideValidationFeedbackRequest.ValidationConclusion (enum)
• ProvideValidationFeedbackResponse (ข้อความ)
• UspsAddress (ข้อความ)
• UspsData (ข้อความ)
• ValidateAddressRequest (ข้อความ)
• ValidateAddressResponse (ข้อความ)
• ValidationResult (ข้อความ)
• Verdict (ข้อความ)
• Verdict.Granularity (enum)

AddressValidation

บริการสำหรับการตรวจสอบที่อยู่

ProvideValidationFeedback

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

ValidateAddress
rpc ValidateAddress(ValidateAddressRequest) returns (ValidateAddressResponse) ตรวจสอบที่อยู่

ที่อยู่

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

ช่อง
formatted_address	string ที่อยู่หลังการประมวลผล ซึ่งอยู่ในรูปแบบที่อยู่บรรทัดเดียวตามกฎการจัดรูปแบบที่อยู่ของภูมิภาคที่ที่อยู่นั้นตั้งอยู่
postal_address	PostalAddress ที่อยู่ที่ประมวลผลแล้วซึ่งแสดงเป็นที่อยู่ไปรษณีย์
address_components[]	AddressComponent รายการที่ไม่เรียงลำดับ องค์ประกอบที่อยู่แต่ละรายการของที่อยู่ที่จัดรูปแบบและแก้ไขแล้ว รวมถึงข้อมูลการตรวจสอบความถูกต้อง ซึ่งจะให้ข้อมูลเกี่ยวกับสถานะการตรวจสอบของแต่ละคอมโพเนนต์ ส่วนประกอบที่อยู่ไม่ได้เรียงลำดับตามวิธีที่ระบุ อย่าคาดเดาใดๆ เกี่ยวกับลำดับขององค์ประกอบที่อยู่ในรายการ
missing_component_types[]	string ประเภทของคอมโพเนนต์ที่คาดว่าจะแสดงในที่อยู่ทางไปรษณีย์ที่มีรูปแบบถูกต้อง แต่ไม่พบในอินพุต และ ไม่สามารถอนุมานได้ คอมโพเนนต์ประเภทนี้ไม่มีใน formatted_address, postal_address หรือ address_components ตัวอย่างเช่น ['street_number', 'route'] สำหรับอินพุต เช่น "Boulder, Colorado, 80301, USA" โปรดดูประเภทที่เป็นไปได้ที่นี่
unconfirmed_component_types[]	string ประเภทของคอมโพเนนต์ที่มีอยู่ใน address_components แต่ยืนยันความถูกต้องไม่ได้ ช่องนี้มีไว้เพื่อความสะดวก: เนื้อหาของช่องจะเทียบเท่ากับการทำซ้ำผ่าน address_components เพื่อค้นหาประเภทของคอมโพเนนต์ทั้งหมดที่ confirmation_level ไม่ใช่ CONFIRMED หรือไม่ได้ตั้งค่าแฟล็ก inferred เป็น true โปรดดูประเภทที่เป็นไปได้ที่นี่
unresolved_tokens[]	string โทเค็นในอินพุตที่แปลงไม่ได้ ซึ่งอาจเป็นอินพุตที่ระบบไม่รู้จักว่าเป็นส่วนที่ถูกต้องของที่อยู่ (เช่น ในข้อมูล เช่น "123235253253 Main St, San Francisco, CA, 94105" โทเค็นที่ยังไม่ได้แก้ไขอาจมีลักษณะดังนี้ ["123235253253"] เนื่องจากดูไม่ใช่เลขที่ถนนที่ถูกต้อง

AddressComponent

หมายถึงส่วนประกอบที่อยู่ เช่น ถนน เมือง หรือรัฐ

ช่อง
component_name	ComponentName ชื่อคอมโพเนนต์นี้
component_type	string ประเภทขององค์ประกอบที่อยู่ โปรดดูรายการประเภทที่เป็นไปได้ในตารางที่ 2: ประเภทเพิ่มเติมที่บริการ Places แสดงผล
confirmation_level	ConfirmationLevel ระบุระดับความแน่นอนที่เรามีว่าคอมโพเนนต์ถูกต้อง
inferred	bool ระบุว่าคอมโพเนนต์ไม่ได้เป็นส่วนหนึ่งของอินพุต แต่เราได้อนุมานไว้สำหรับตำแหน่งที่อยู่และเชื่อว่าควรมีการระบุสำหรับที่อยู่ที่สมบูรณ์
spell_corrected	bool ระบุการแก้ไขการสะกดคำผิดในชื่อคอมโพเนนต์ API จะไม่แจ้งการเปลี่ยนแปลงจากรูปแบบการสะกดคำหนึ่งเป็นอีกรูปแบบหนึ่งเสมอ เช่น เมื่อเปลี่ยน "กึ่งกลาง" เป็น "กึ่งกลาง" และไม่ได้แจ้งการสะกดผิดที่พบบ่อยเสมอไป เช่น เมื่อเปลี่ยน "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 การใช้พิกัดเมื่อกำหนดเส้นทางหรือคำนวณเส้นทางขับขี่จะทำให้จุดตัดไปบนถนนที่ใกล้กับพิกัดเหล่านั้นมากที่สุดเสมอ ถนนนี้อาจไม่ใช่ถนนที่จะนำไปยังจุดหมายได้อย่างรวดเร็วหรือปลอดภัย และต้องไม่อยู่ใกล้จุดเข้าใช้งานไปยังที่พัก นอกจากนี้ เมื่อตำแหน่งถูกเข้ารหัสพิกัดภูมิศาสตร์แบบย้อนกลับ จะไม่มีการรับประกันว่าที่อยู่ที่ส่งกลับมาจะตรงกับที่อยู่เดิม
plus_code	PlusCode Plus Code ที่ตรงกับ location
bounds	Viewport ขอบเขตของสถานที่ที่ระบุพิกัดภูมิศาสตร์
feature_size_meters	float ขนาดของสถานที่ที่ระบุพิกัดภูมิศาสตร์ในหน่วยเมตร นี่เป็นการวัดความหยาบของตำแหน่งที่ระบุพิกัดภูมิศาสตร์ไว้อีกแบบหนึ่ง แต่เป็นการวัดขนาดทางกายภาพ ไม่ใช่ในความหมายเชิงความหมาย
place_id	string PlaceID ของสถานที่ที่ระบุพิกัดทางภูมิศาสตร์นี้ ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่นี่
place_types[]	string ประเภทของสถานที่ที่อินพุตระบุพิกัดทางภูมิศาสตร์ เช่น ['locality', 'political'] ดูรายการประเภททั้งหมดได้ที่นี่

LanguageOptions

ตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการรองรับอย่างจำกัด และการเปลี่ยนแปลงในผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจใช้ไม่ได้กับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปจะอยู่ภายใต้ข้อกำหนดเฉพาะของบริการ 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 รูปแบบ ได้แก่ โค้ดส่วนกลางที่กำหนดขนาด 14mx14m (1/8000 ขององศา) หรือสี่เหลี่ยมผืนผ้าที่เล็กกว่า และโค้ดประกอบ ซึ่งแทนที่คำนำหน้าด้วยตำแหน่งอ้างอิง

ช่อง
global_code	string รหัสสากล (แบบสมบูรณ์) ของสถานที่ เช่น "9FWM33GV+HQ" ซึ่งแสดงพื้นที่ 1/8000 x 1/8000 องศา (ประมาณ 14 x 14 เมตร)
compound_code	string รหัสรวมของสถานที่ เช่น "33GV+HQ, Ramberg,นอร์เวย์" ซึ่งมีส่วนต่อท้ายรหัสสากล และแทนที่คำนำหน้าด้วยชื่อที่จัดรูปแบบของเอนทิตีอ้างอิง

ProvideValidationFeedbackRequest

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

ช่อง
conclusion	ValidationConclusion ต้องระบุ ผลลัพธ์ของความพยายามในการตรวจสอบตามลำดับ หากตั้งค่าช่องนี้เป็น VALIDATION_CONCLUSION_UNSPECIFIED ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
response_id	string ต้องระบุ รหัสของคำตอบที่เป็นคำอธิบายของความคิดเห็นนี้ ซึ่งควรเป็น [response_id][google.maps.addressValidation.v1.ValidAddressRequest.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 ที่อยู่บรรทัดที่สอง
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 อย่างครบถ้วนสำหรับที่อยู่ในสหรัฐอเมริกาหรือที่อยู่ PR ทุกรายการที่ส่งไปยัง 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, รหัสไปรษณีย์ และ 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: ระเบียน Route R777 หรือ R779 ของผู้ให้บริการขนส่ง IA: ระบุที่อยู่ที่ได้รับข้อมูลแล้ว TA: จับคู่หมายเลขหลักโดยทิ้งอัลฟ่าต่อท้าย
dpv_cmra	string ระบุว่าที่อยู่เป็น CMRA (Commercial Mail Receive 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 (วิทยาลัย ทหาร และอื่นๆ) - ไฟล์ ZIP + 4 ระเบียน USPS ได้รวมอยู่ในข้อมูล 5: ปกติ - บ่งบอกว่าที่อยู่ดังกล่าวไม่ได้รับการนำส่ง และระบบไม่นับรวมที่อยู่ดังกล่าวว่าเป็นการส่งที่เป็นไปได้ 6: ต้องระบุข้อมูลรอง - ที่อยู่ต้องใช้ข้อมูลรอง
dpv_drop	string ธงระบุว่ามีการส่งอีเมลไปยังผู้รับเพียงตัวเดียวที่ไซต์ แสดงผลอักขระเดี่ยว Y: อีเมลจะส่งไปยังเว็บไซต์ที่รับเพียง 1 ตัว N: อีเมลไม่ได้ส่งไปยังผู้รับเลยในเว็บไซต์
dpv_throwback	string ระบุว่าไม่มีการส่งอีเมลไปยังที่อยู่ แสดงผลอักขระเดี่ยว Y: ไปรษณีย์ไม่ได้ส่งไปยังที่อยู่ N: ไปรษณีย์ไปยังที่อยู่
dpv_non_delivery_days	string การทำเครื่องหมายระบุว่าไม่มีการส่งอีเมลทุกวันของสัปดาห์ แสดงผลอักขระเดี่ยว Y: ไม่มีการส่งอีเมลทุกวัน N: ไม่มีข้อบ่งชี้ว่าไม่มีการส่งอีเมลทุกวัน
dpv_non_delivery_days_values	int32 จำนวนเต็มที่ระบุวันที่ไม่แสดงโฆษณา อาจมีการตรวจสอบโดยใช้แฟล็กบิตดังนี้ 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: ที่อยู่ได้รับการยืนยันแต่กำหนดให้ใช้กับเส้นทาง Phantom 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 eLOT จากน้อยไปมาก/มากไปน้อย (A/D)
lacs_link_return_code	string รหัสการคืนสินค้า LACSLink
lacs_link_indicator	string ตัวบ่งชี้ LACSLink
po_box_only_postal_code	bool รหัสไปรษณีย์เท่านั้น
suitelink_footnote	string เชิงอรรถตั้งแต่การจับคู่ถนนหรืออาคารสูงไปจนถึงข้อมูลห้อง หากพบชื่อธุรกิจที่ตรงกัน ระบบจะแสดงผลหมายเลขรอง A: การจับคู่บันทึก SuiteLink ปรับปรุงที่อยู่ธุรกิจแล้ว 00: ไม่พบข้อมูลที่ตรงกัน ที่อยู่ธุรกิจจะไม่ได้รับการปรับปรุง
pmb_designator	string ผู้กำหนดหน่วย PMB (Private Mail Box)
pmb_number	string หมายเลข PMB (Private Mail Box)
address_record_type	string ประเภทของระเบียนที่อยู่ที่ตรงกับที่อยู่ที่ป้อน F: มั่นคง การจับคู่นี้เป็นการจับคู่กับ Firm Record ซึ่งเป็นการจับคู่ระดับสูงสุดที่มีสำหรับที่อยู่ G: การนำส่งทั่วไป รายการนี้ตรงกับระเบียนการส่งทั่วไป H: การสร้าง / อพาร์ตเมนต์ รายการนี้ตรงกับระเบียนอาคารหรืออพาร์ตเมนต์ P: กล่องเอกสาร รายการนี้ตรงกับตู้ไปรษณีย์ R: สัญญาเส้นทาง RURAL หรือ HIGHWAY CONTRACT: รายการนี้ตรงกับระเบียนเส้นทางชนบทหรือทางหลวงของสัญญาทางหลวง ซึ่งทั้ง 2 รายการนี้อาจมีช่วงหมายเลข Box ที่เชื่อมโยงกัน S: บันทึกถนน: ข้อมูลนี้ตรงกับ Street 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 เท่านั้น หมายเหตุ: สำหรับคำขอที่เปิดใช้ USPS CASS สำหรับที่อยู่ในเปอร์โตริโก คุณต้องระบุ 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 ไม่บังคับ ตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการรองรับอย่างจำกัด และการเปลี่ยนแปลงในผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจใช้ไม่ได้กับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปจะอยู่ภายใต้ข้อกำหนดเฉพาะของบริการ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ในคำอธิบายขั้นตอนการเปิดตัว เปิดใช้ Address Validation API เพื่อรวมข้อมูลเพิ่มเติมในการตอบกลับ
session_token	string ไม่บังคับ สตริงที่ระบุเซสชันการเติมข้อความอัตโนมัติเพื่อจุดประสงค์ในการเรียกเก็บเงิน ต้องเป็นสตริง base64 สำหรับ URL และชื่อไฟล์ที่ปลอดภัยและมีอักขระ ASCII ไม่เกิน 36 ตัว มิฉะนั้น ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT เซสชันนี้จะเริ่มต้นเมื่อผู้ใช้ทำการค้นหาจากการเติมข้อความอัตโนมัติ และสรุปเมื่อผู้ใช้เลือกสถานที่และมีการเรียกรายละเอียดสถานที่หรือการตรวจสอบที่อยู่ แต่ละเซสชันสามารถใส่คำค้นหาอัตโนมัติได้หลายรายการ ตามด้วยรายละเอียดสถานที่หรือคำขอตรวจสอบที่อยู่ 1 รายการ ข้อมูลเข้าสู่ระบบที่ใช้สำหรับแต่ละคำขอภายในเซสชันต้องเป็นของโปรเจ็กต์ Google Cloud Console เดียวกัน เมื่อจบเซสชันแล้ว โทเค็นจะใช้ไม่ได้อีกต่อไป แอปของคุณจะต้องสร้างโทเค็นใหม่สำหรับแต่ละเซสชัน หากไม่ใส่พารามิเตอร์ sessionToken หรือหากนำโทเค็นเซสชันมาใช้ซ้ำ ระบบจะเรียกเก็บเงินเซสชันเสมือนว่าไม่ได้ให้โทเค็นเซสชันไว้ (แต่ละคำขอจะถูกเรียกเก็บเงินแยกกัน) หมายเหตุ: การตรวจสอบที่อยู่ใช้ได้เฉพาะในเซสชันที่มี 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 การแจ้งเกี่ยวกับการนำส่งเพิ่มเติมจาก USPS ให้บริการในภูมิภาค US และ PR เท่านั้น
english_latin_address	Address ตัวอย่าง: ฟีเจอร์นี้อยู่ในเวอร์ชันตัวอย่าง (ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไป) ผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจมีการรองรับอย่างจำกัด และการเปลี่ยนแปลงในผลิตภัณฑ์และฟีเจอร์ก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอาจใช้ไม่ได้กับเวอร์ชันก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปอื่นๆ ข้อเสนอก่อนเวอร์ชันสำหรับผู้ใช้ทั่วไปจะอยู่ภายใต้ข้อกำหนดเฉพาะของบริการ Google Maps Platform ดูข้อมูลเพิ่มเติมได้ในคำอธิบายขั้นตอนการเปิดตัว แปลที่อยู่เป็นภาษาอังกฤษ ที่อยู่ที่แปลจะใช้ซ้ำเป็นอินพุต API ไม่ได้ บริการนี้มีไว้ให้เพื่อให้ผู้ใช้สามารถใช้ภาษาของตนเพื่อยืนยันหรือปฏิเสธการตรวจสอบความถูกต้องของที่อยู่เดิมที่ให้ไว้ หากบางส่วนของที่อยู่ไม่มีคำแปลภาษาอังกฤษ บริการจะแสดงส่วนนั้นในภาษาอื่นที่ใช้ตัวเขียนภาษาละติน ดูคำอธิบายวิธีการเลือกภาษาอื่นได้ที่นี่ หากบางส่วนของที่อยู่ไม่มีคำแปลหรือคำทับศัพท์ในภาษาที่ใช้อักษรละติน บริการแสดงส่วนนั้นเป็นภาษาท้องถิ่นที่เชื่อมโยงกับที่อยู่ เปิดใช้เอาต์พุตนี้โดยใช้แฟล็ก 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 รายละเอียดของที่อยู่อินพุต ซึ่งเป็นผลมาจากการแยกวิเคราะห์ที่อยู่อินพุตและไม่ได้ให้สัญญาณสำหรับการตรวจสอบความถูกต้อง ดูสัญญาณการตรวจสอบได้จากvalidation_granularityด้านล่าง ตัวอย่างเช่น หากที่อยู่ที่ป้อนมีหมายเลขอพาร์ตเมนต์ที่เฉพาะเจาะจง input_granularity ในที่นี้จะเป็น SUB_PREMISE หากเราจับคู่หมายเลขอพาร์ตเมนต์ในฐานข้อมูลไม่ได้ หรือหมายเลขอพาร์ตเมนต์ไม่ถูกต้อง validation_granularity ก็น่าจะเป็น PREMISE หรือต่ำกว่า
validation_granularity	Granularity ระดับรายละเอียดที่ API สามารถvalidateที่อยู่ได้อย่างสมบูรณ์ ตัวอย่างเช่น 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

รายละเอียด

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

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