Package google.type

ดัชนี

• LatLng (ข้อความ)
• PostalAddress (ข้อความ)

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 ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมืองหรืออำเภอของที่อยู่ เช่น เมืองในสหรัฐอเมริกา เทศบาลในอิตาลี เมืองในสหราชอาณาจักร ในภูมิภาคของโลกที่ระบุสถานที่ตั้งไม่ชัดเจนหรือไม่เหมาะกับโครงสร้างนี้ ให้เว้นlocalityว่างไว้และใช้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 จะไม่ปฏิเสธคำขอที่มีการตั้งค่าช่องนี้ แต่ระบบจะทิ้งข้อมูลดังกล่าวและจะไม่แสดงในคำตอบ