แสดงที่อยู่ไปรษณีย์ เช่น สำหรับที่อยู่ไปรษณีย์หรือที่อยู่การชำระเงิน หากใช้ที่อยู่ไปรษณีย์ บริการไปรษณีย์จะนำส่งสินค้าไปยังสถานที่ตั้งของ P.O ได้ กล่องหรือสิ่งอื่นที่คล้ายกัน ไม่ได้มีไว้เพื่อสร้างแบบจำลองตำแหน่งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)
ในการใช้งานโดยทั่วไป ที่อยู่จะสร้างขึ้นผ่านข้อมูลจากผู้ใช้หรือจากการนำเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ
คําแนะนําเกี่ยวกับการป้อน / การแก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ที่พร้อมใช้งาน i18n เช่น https://github.com/google/libaddressinput) - ผู้ใช้ไม่ควรแสดงองค์ประกอบ UI สําหรับการป้อนข้อมูลหรือแก้ไขช่องนอกประเทศที่ใช้ช่องดังกล่าว
ดูคำแนะนำเพิ่มเติมเกี่ยวกับวิธีใช้สคีมานี้ได้ที่ https://support.google.com/business/answer/6397478
การแสดง JSON | |
---|---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
ช่อง | |
---|---|
revision |
การแก้ไขสคีมาของ การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับการแก้ไขเก่า |
regionCode |
ต้องระบุ รหัสภูมิภาค CLDR ของประเทศ/ภูมิภาคของที่อยู่ ข้อมูลนี้ไม่ได้มีการอนุมานแต่อย่างใด และขึ้นอยู่กับผู้ใช้ที่จะตรวจสอบว่าค่าถูกต้อง ดูรายละเอียดได้ที่ http://cldr.unicode.org/ และ http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์ |
languageCode |
ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาในที่อยู่นี้ (หากทราบ) ภาษานี้มักเป็นภาษา UI ของแบบฟอร์มการป้อนข้อมูล หรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือภาษาที่เทียบเท่าซึ่งถอดเสียง ซึ่งอาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สำคัญต่อความถูกต้องของข้อมูลและจะไม่ส่งผลต่อการตรวจสอบหรือการดําเนินการอื่นๆ ที่ไม่เกี่ยวข้องกับการจัดรูปแบบ หากไม่ทราบค่านี้ ก็ควรละเว้น (แทนที่จะระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง) เช่น "zh-Hant", "ja", "ja-Latn", "en" |
postalCode |
ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศอาจไม่ได้ใช้หรือกำหนดให้มีการแสดงรหัสไปรษณีย์ แต่ประเทศที่ใช้รหัสเหล่านี้อาจทำให้มีการตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา) |
sortingCode |
ไม่บังคับ รหัสการจัดเรียงเพิ่มเติม รหัสเฉพาะประเทศ ซึ่งไม่มีใช้ในภูมิภาคส่วนใหญ่ ในที่ที่ใช้ ค่าอาจเป็นสตริง เช่น "CEDEX" ซึ่งอาจจะตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นเพียงตัวเลขเพียงอย่างเดียวซึ่งเป็นตัวแทนของ "รหัสเซกเตอร์" (จาเมกา), "ดัชนีพื้นที่นำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (เช่น โกตดิวัวร์) |
administrativeArea |
ไม่บังคับ เขตการปกครองสูงสุด ซึ่งใช้สำหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค ตัวอย่างเช่น อาจเป็นรัฐ จังหวัด แคว้น หรือจังหวัด สำหรับสเปนโดยเฉพาะ ข้อมูลนี้หมายถึงจังหวัด ไม่ใช่แคว้นปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ คุณควรปล่อยฟิลด์นี้ว่างไว้ |
locality |
ไม่บังคับ โดยทั่วไปหมายถึงส่วนเมืองของที่อยู่ เช่น เมืองในสหรัฐอเมริกา เขตไอที เมืองตามเขตไปรษณีย์ของสหราชอาณาจักร ในภูมิภาคของโลกที่ไม่มีการกำหนดพื้นที่ไว้อย่างดีหรือไม่เหมาะสมกับโครงสร้างนี้ ให้ปล่อยย่านนั้นว่างไว้และใช้บรรทัดที่อยู่ |
sublocality |
ไม่บังคับ สถานที่ตั้งย่อยของที่อยู่ ตัวอย่างเช่น ย่านใกล้เคียง เขตเมือง เขตต่างๆ |
addressLines[] |
บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายถึงระดับที่ต่ำกว่าของที่อยู่ เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภทและบางครั้งอาจมีหลายค่าในช่องเดียว (เช่น "Austin, TX") คุณจึงควรจัดเรียงบรรทัดให้ชัดเจน ลำดับของบรรทัดที่อยู่ควรเป็น "ลำดับเอนเวโลป" สำหรับประเทศ/ภูมิภาคของที่อยู่ ในพื้นที่ที่อาจแตกต่างกันไป (เช่น ญี่ปุ่น) ระบบจะใช้ address_language เพื่อทำให้ชัดเจน (เช่น "ja" สำหรับการสั่งซื้อจากใหญ่ไปเล็ก และ "ja-Latn" หรือ "en" สำหรับเล็กไปใหญ่) ด้วยวิธีนี้คุณสามารถเลือกบรรทัดของที่อยู่ที่เจาะจงที่สุดตามภาษาได้ การแสดงโครงสร้างต่ำสุดที่ได้รับอนุญาตของที่อยู่ประกอบด้วยรหัสภูมิภาคพร้อมกับข้อมูลที่เหลืออยู่ทั้งหมดในบรรทัดที่อยู่ รูปแบบที่อยู่เช่นนี้สามารถทำได้อย่างคร่าวๆ โดยไม่ต้องมีการเข้ารหัสพิกัดภูมิศาสตร์ แต่ไม่มีการให้เหตุผลเชิงความหมายเกี่ยวกับองค์ประกอบที่อยู่ใดๆ จนกว่าจะได้รับการแก้ไขบางส่วนเป็นอย่างน้อย การสร้างที่อยู่ที่มีเพียงรหัสภูมิภาคและบรรทัดที่อยู่ การใช้รหัสพิกัดภูมิศาสตร์เป็นวิธีที่แนะนำในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสิ้นเชิง (แทนที่จะคาดเดาว่าส่วนใดของที่อยู่ควรเป็นย่านหรือเขตบริหาร) |
recipients[] |
ไม่บังคับ ผู้รับในที่อยู่ ในบางกรณี ช่องนี้อาจมีข้อมูลหลายบรรทัด เช่น อาจมีคำว่า "ดูแล" |
organization |
ไม่บังคับ ชื่อองค์กรที่อยู่ที่ระบุ |