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

ประเภทของคอมโพเนนต์ที่คาดว่าจะอยู่ในที่อยู่สำหรับจัดส่งที่มีการจัดรูปแบบถูกต้อง แต่ไม่พบคําสั่งซื้อในอินพุตและไม่สามารถอนุมานได้ องค์ประกอบประเภทนี้ไม่มีอยู่ใน formatted_address, postal_address หรือ address_components ตัวอย่างเช่น ['street_number', 'route'] สำหรับอินพุตอย่าง "Boulder, Colorado, 80301, USA" ดูรายการประเภทที่เป็นไปได้ได้ที่นี่
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: ประเภทเพิ่มเติมที่บริการ 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 Codes การใช้พิกัดเมื่อกำหนดเส้นทางหรือคำนวณเส้นทางขับรถจะทำให้ระบบจับจุดไปยังถนนที่อยู่ใกล้กับพิกัดเหล่านั้นที่สุดเสมอ ถนนนี้อาจไม่ใช่ถนนที่จะนำคุณไปยังจุดหมายอย่างรวดเร็วหรือปลอดภัย และอาจไม่ได้อยู่ใกล้กับจุดเข้าใช้งานของที่พัก นอกจากนี้ เมื่อมีการแปลงพิกัดภูมิศาสตร์ย้อนกลับ เราไม่รับประกันว่าที่อยู่ที่ได้รับจะตรงกับที่อยู่เดิม
plus_code

PlusCode

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

Viewport

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

float

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

string

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานที่ได้ที่นี่
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, 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, รหัสไปรษณีย์ และ 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 (วิทยาลัย ทหาร และอื่นๆ) - ไฟล์ ZIP + 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: บันทึกถนน: ข้อมูลนี้ตรงกับ 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 หมายเหตุ: สำหรับคำขอที่อยู่ในเปอร์โตริโกที่เปิดใช้ 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

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

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

รายละเอียด

รายละเอียดต่างๆ ที่ที่อยู่หรือพิกัดภูมิศาสตร์อาจมี เมื่อใช้เพื่อระบุความละเอียดของที่อยู่ ค่าเหล่านี้จะระบุความละเอียดของที่อยู่ที่จะระบุปลายทางการส่งจดหมาย เช่น ที่อยู่อย่าง "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 รายละเอียดอื่นๆ ทั้งหมด ซึ่งจะรวมไว้ในกลุ่มเดียวกันเนื่องจากไม่สามารถนําส่งได้