Package google.maps.addressvalidation.v1

ดัชนี

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)
po_box_only_postal_code

bool

รหัสไปรษณีย์เท่านั้น
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 รายละเอียดอื่นๆ ทั้งหมดที่เก็บรวมไว้ด้วยกันเนื่องจากไม่มีการนำส่ง