Package google.type

ดัชนี

LatLng

วัตถุที่แสดงคู่ละติจูด/ลองจิจูด ซึ่งจะแสดงเป็นคู่ของตัวเลขทศนิยมเพื่อแสดงองศาละติจูดและองศาลองจิจูด ออบเจ็กต์นี้ต้องเป็นไปตาม มาตรฐาน WGS84 เว้นแต่จะระบุไว้เป็นอย่างอื่น ค่าต้องอยู่ในช่วงมาตรฐาน

ช่อง
latitude

double

ละติจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-90.0, +90.0]
longitude

double

ลองจิจูด หน่วยเป็นองศา โดยต้องอยู่ในช่วง [-180.0, +180.0]

PostalAddress

แสดงที่อยู่ไปรษณีย์ เช่น สำหรับการนำส่งทางไปรษณีย์หรือที่อยู่สำหรับการชําระเงิน เมื่อระบุที่อยู่ไปรษณีย์แล้ว บริการไปรษณีย์จะส่งสินค้าไปยังสถานที่ตั้ง ตู้ ปณ. หรือที่คล้ายกันได้ ไม่ได้มีไว้เพื่อสร้างแบบจำลองตำแหน่งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)

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

คำแนะนำเกี่ยวกับการป้อน/แก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่พร้อมใช้งานแบบหลายภาษา เช่น https://github.com/google/libaddressinput) - ผู้ใช้ไม่ควรเห็นองค์ประกอบ UI สำหรับการป้อนหรือแก้ไขช่องที่อยู่นอกประเทศที่ใช้ช่องนั้น

ดูคําแนะนําเพิ่มเติมเกี่ยวกับวิธีใช้สคีมานี้ได้ที่ https://support.google.com/business/answer/6397478

ช่อง
revision

int32

การแก้ไขสคีมาของ PostalAddress ค่าอื่นที่ไม่ใช่ 0 จะทำให้ API แสดงผลข้อผิดพลาด INVALID_ARGUMENT
region_code

string

ไม่บังคับ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html เช่น "CH" สำหรับสวิตเซอร์แลนด์ หากไม่ได้ระบุรหัสภูมิภาค ระบบจะอนุมานจากที่อยู่ หากทราบ ขอแนะนำให้ใส่รหัสภูมิภาคมาด้วยเพื่อประสิทธิภาพที่ดีที่สุด การมีภูมิภาคที่ไม่สอดคล้องกันหรือซ้ำกันอาจทําให้ประสิทธิภาพแย่ลง เช่น หาก address_lines มีภูมิภาคอยู่แล้ว อย่าระบุรหัสภูมิภาคอีกครั้งในช่องนี้ ดูภูมิภาคที่รองรับได้ในคำถามที่พบบ่อย
language_code

string

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

string

ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศไม่ได้ใช้หรือกำหนดให้ต้องระบุรหัสไปรษณีย์ แต่หากใช้รหัสไปรษณีย์ ระบบอาจเรียกใช้การตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา)
sorting_code

string

ไม่บังคับ รหัสการจัดเรียงเพิ่มเติมสำหรับแต่ละประเทศ ซึ่งไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ค่าที่ใช้จะเป็นสตริง เช่น "CEDEX" ตามด้วยตัวเลข (ไม่บังคับ) (เช่น "CEDEX 7") หรือจะเป็นตัวเลขเพียงอย่างเดียวก็ได้ ซึ่งแสดงถึง "รหัสภาค" (จาไมก้า), "ตัวบ่งชี้พื้นที่การนำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น ไอวอรี่โคสต์)
administrative_area

string

ไม่บังคับ เขตบริหารย่อยที่สูงที่สุดซึ่งใช้สำหรับที่อยู่ไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด เขต หรือจังหวัด สำหรับสเปนโดยเฉพาะ ข้อมูลนี้หมายถึงจังหวัด ไม่ใช่แคว้นปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") มีหลายประเทศไม่ใช้เขตบริหารในที่อยู่ทางไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ คุณควรปล่อยฟิลด์นี้ว่างไว้
locality

string

ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมือง/อำเภอของที่อยู่ เช่น เมืองในสหรัฐอเมริกา เทศบาลในอิตาลี เมืองในสหราชอาณาจักร ในภูมิภาคของโลกที่ระบุสถานที่ตั้งไม่ชัดเจนหรือไม่เหมาะกับโครงสร้างนี้ ให้เว้นว่างไว้และใช้ address_lines
sublocality

string

ไม่บังคับ เขตท้องที่ของที่อยู่ ตัวอย่างเช่น ละแวกบ้าน เขตเมือง เขตต่างๆ
address_lines[]

string

ต้องระบุ บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายถึงระดับที่ต่ำกว่าของที่อยู่

เนื่องจากค่าใน address_lines ไม่มีข้อมูลประเภทและบางครั้งอาจมีหลายค่าในช่องเดียว (เช่น "Austin, TX") ดังนั้นการเรียงลำดับบรรทัดจะต้องชัดเจน ลําดับของบรรทัดที่อยู่ควรเป็น "ลําดับของซองจดหมาย" สําหรับประเทศ/ภูมิภาคของที่อยู่

การแสดงข้อมูลที่มีโครงสร้างขั้นต่ำที่อนุญาตของที่อยู่ประกอบด้วยข้อมูลทั้งหมดที่อยู่ใน address_lines หากไม่ได้ระบุ region_code ระบบจะอนุมานภูมิภาคจากบรรทัดที่อยู่

เราขอแนะนำให้สร้างที่อยู่ที่มีเพียง address_lines แล้วทำการจับคู่พิกัดภูมิศาสตร์เพื่อจัดการกับที่อยู่ที่ไม่มีโครงสร้างโดยสมบูรณ์ (แทนที่จะเดาว่าส่วนใดของที่อยู่ควรเป็นสถานที่ตั้งหรือเขตบริหาร)
recipients[]

string

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

string

โปรดหลีกเลี่ยงการตั้งค่าช่องนี้ ปัจจุบัน Address Validation API ไม่ได้ใช้ แม้ว่าในตอนนี้ API จะไม่ปฏิเสธคำขอที่มีการตั้งค่าช่องนี้ แต่ระบบจะทิ้งข้อมูลดังกล่าวและจะไม่แสดงในคำตอบ