แสดงที่อยู่ไปรษณีย์ เช่น สำหรับการจัดส่งทางไปรษณีย์หรือที่อยู่สำหรับการชำระเงิน เมื่อมีที่อยู่ไปรษณีย์ บริการไปรษณีย์จะสามารถนำส่งพัสดุไปยังสถานที่ ตู้ ปณ. หรือที่อื่นๆ ที่คล้ายกันได้ ที่อยู่ทางไปรษณีย์ไม่ได้มีไว้เพื่อจำลองสถานที่ตั้งทางภูมิศาสตร์ เช่น ถนน เมือง หรือภูเขา
ในการใช้งานทั่วไป ระบบจะสร้างที่อยู่โดยการป้อนข้อมูลของผู้ใช้หรือจากการนำเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ
คำแนะนำเกี่ยวกับการป้อนหรือแก้ไขที่อยู่
- ใช้วิดเจ็ตที่อยู่ซึ่งพร้อมสำหรับการปรับให้เข้ากับภาษาต่างๆ เช่น 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 ของประเทศ/ภูมิภาคของที่อยู่ ระบบจะไม่คาดคะเนค่านี้ และผู้ใช้ต้องตรวจสอบว่าค่าถูกต้อง ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สำหรับสวิตเซอร์แลนด์ |
languageCode |
ไม่บังคับ รหัสภาษา BCP-47 ของเนื้อหาของที่อยู่นี้ (หากทราบ) ซึ่งมักจะเป็นภาษา UI ของแบบฟอร์มป้อนข้อมูลหรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือการทับศัพท์ที่เทียบเท่า ซึ่งอาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สำคัญต่อความถูกต้องของข้อมูล และจะไม่ส่งผลต่อการตรวจสอบหรือการดำเนินการอื่นๆ ที่ไม่เกี่ยวข้องกับการจัดรูปแบบ หากไม่ทราบค่านี้ คุณควรละเว้นค่านี้ (แทนที่จะระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง) ตัวอย่าง: "zh-Hant", "ja", "ja-Latn", "en" |
postalCode |
ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศไม่ได้ใช้หรือกำหนดให้ต้องระบุรหัสไปรษณีย์ แต่ในประเทศที่ใช้รหัสไปรษณีย์ อาจมีการตรวจสอบความถูกต้องเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบความถูกต้องของรัฐหรือรหัสไปรษณีย์ในสหรัฐอเมริกา) |
sortingCode |
ไม่บังคับ รหัส Sort เพิ่มเติมเฉพาะประเทศ ซึ่งไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ในกรณีที่ใช้ ค่าจะเป็นสตริง เช่น "CEDEX" ตามด้วยตัวเลข (เช่น "CEDEX 7") หรือตัวเลขเพียงอย่างเดียว ซึ่งแสดงถึง "รหัสภาคส่วน" (จาเมกา) "ตัวบ่งชี้พื้นที่นำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (โกตดิวัวร์) |
administrativeArea |
ไม่บังคับ เขตการปกครองย่อยระดับสูงสุดที่ใช้สำหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด แคว้น หรือจังหวัด สำหรับสเปน ข้อมูลนี้คือจังหวัด ไม่ใช่ชุมชนปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ไปรษณีย์ ตัวอย่างเช่น ในสวิตเซอร์แลนด์ คุณควรปล่อยช่องนี้ว่างไว้ |
locality |
ไม่บังคับ โดยทั่วไปจะหมายถึงส่วนที่เป็นเมืองหรือเทศบาลของที่อยู่ ตัวอย่าง: เมืองในสหรัฐอเมริกา, เขตเทศบาลในอิตาลี, เมืองไปรษณีย์ในสหราชอาณาจักร ในภูมิภาคต่างๆ ของโลกที่ไม่ได้กำหนดท้องถิ่นไว้อย่างชัดเจนหรือไม่สอดคล้องกับโครงสร้างนี้ ให้เว้น |
sublocality |
ไม่บังคับ ท้องถิ่นย่อยของที่อยู่ เช่น ย่าน เขต หรืออำเภอ |
addressLines[] |
บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายระดับที่ต่ำกว่าของที่อยู่ เนื่องจากค่าใน การแสดงโครงสร้างที่อยู่ขั้นต่ำที่อนุญาตประกอบด้วย การสร้างที่อยู่ที่มีเพียง |
recipients[] |
ไม่บังคับ ผู้รับตามที่อยู่ ในบางกรณี ช่องนี้อาจมีข้อมูลหลายบรรทัด เช่น อาจมีข้อมูล "ในความดูแลของ" |
organization |
ไม่บังคับ ชื่อองค์กรตามที่อยู่ |