Package google.type

ดัชนี

LatLng

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

ช่อง
latitude

double

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

double

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

LocalizedText

ข้อความที่แปลเป็นภาษาท้องถิ่นในภาษาหนึ่งๆ

ช่อง
text

string

สตริงที่แปลแล้วในภาษาที่ตรงกับ language_code ด้านล่าง
language_code

string

รหัสภาษา BCP-47 ของข้อความ เช่น "en-US" หรือ "sr-Latn"

ดูข้อมูลเพิ่มเติมได้ที่ http://www.unicode.org/reports/tr35/#Unicode_locale_identifier

PostalAddress

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

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

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

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

ช่อง
revision

int32

การแก้ไขสคีมาของ PostalAddress ต้องตั้งค่าเป็น 0 ซึ่งเป็นการแก้ไขล่าสุด

การแก้ไขใหม่ทั้งหมดต้องใช้งานร่วมกับการแก้ไขเก่าได้
region_code

string

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

string

ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาในที่อยู่นี้ (หากทราบ) ภาษานี้มักจะเป็นภาษา UI ของแบบฟอร์มการป้อนข้อมูล หรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือภาษาที่เทียบเท่าซึ่งถอดเสียง ซึ่งอาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สำคัญต่อความถูกต้องของข้อมูลและจะไม่ส่งผลต่อการตรวจสอบหรือการดําเนินการอื่นๆ ที่ไม่เกี่ยวข้องกับการจัดรูปแบบ

หากไม่ทราบค่านี้ ก็ไม่ควรระบุ (แทนที่จะระบุค่าเริ่มต้นที่ไม่ถูกต้อง)

ตัวอย่างเช่น "zh-Hant", "ja", "ja-Latn", "en"
postal_code

string

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

string

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

string

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

string

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

string

ไม่บังคับ เขตท้องที่ของที่อยู่ เช่น อาจเป็นย่าน เมืองเล็กๆ หรือเขต
address_lines[]

string

บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายที่อยู่ในระดับล่าง

เนื่องจากค่าใน address_lines ไม่มีข้อมูลประเภทและบางครั้งอาจมีหลายค่าในช่องเดียว (เช่น "Austin, TX") คุณจึงควรจัดเรียงบรรทัดให้ชัดเจน ลําดับบรรทัดที่อยู่ควรเป็น "ลําดับของซองจดหมาย" สําหรับประเทศหรือภูมิภาคของที่อยู่ ในที่ที่การเรียงลําดับอาจแตกต่างกัน (เช่น ญี่ปุ่น) ระบบจะใช้ address_language เพื่อระบุให้ชัดเจน (เช่น "ja" สําหรับการเรียงลําดับจากใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สําหรับการเรียงลําดับจากเล็กไปใหญ่) วิธีนี้ช่วยให้คุณเลือกบรรทัดที่อยู่เฉพาะเจาะจงที่สุดตามภาษาได้

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

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

string

ไม่บังคับ ผู้รับที่อยู่ที่ระบุ ช่องนี้อาจมีข้อมูลหลายบรรทัดในบางกรณี เช่น อาจมีข้อมูล "รับพัสดุแทน"
organization

string

ไม่บังคับ ชื่อองค์กรที่อยู่ที่ระบุ