แสดงที่อยู่ทางไปรษณีย์ เช่น ที่อยู่สําหรับจัดส่งทางไปรษณีย์หรือการชําระเงิน ที่อยู่ทางไปรษณีย์จะช่วยให้บริการไปรษณีย์นําสินค้าไปส่งที่ตู้ไปรษณีย์ ตู้ไปรษณีย์ หรือตู้อื่นๆ ที่คล้ายกันได้ ไม่ได้มีจุดมุ่งหมายให้สร้างแบบจําลองสถานที่ตั้งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)
ในการใช้งานทั่วไป ระบบจะสร้างที่อยู่ที่ผู้ใช้ป้อนหรือนําเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ
คําแนะนําเกี่ยวกับการป้อนข้อมูล/การแก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ 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/Chars/30/supplemental/territory_information.html ตัวอย่าง: "CH" สําหรับสวิตเซอร์แลนด์ |
languageCode |
ไม่บังคับ รหัสภาษาของ BCP-47 ของที่อยู่นี้ (หากทราบ) ซึ่งมักเป็นภาษา UI ของแบบฟอร์มอินพุตหรือต้องไม่ตรงกับภาษาใดภาษาหนึ่งที่ใช้ในที่อยู่' ประเทศ/ภูมิภาค หรือคําใกล้เคียงที่ทับศัพท์ การดําเนินการนี้อาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่สําคัญต่อความถูกต้องของข้อมูล และจะไม่ส่งผลต่อการตรวจสอบความถูกต้องหรือการดําเนินการอื่นๆ ที่เกี่ยวข้องกับการจัดรูปแบบ หากไม่ทราบค่านี้ คุณควรละเว้นค่านี้ (แทนการระบุเริ่มต้นที่ไม่ถูกต้อง) ตัวอย่างเช่น: "zh-Hant", "ja", "ja-Latn", "en" |
postalCode |
ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ บางประเทศอาจไม่ได้ใช้หรือกําหนดให้ต้องมีรหัสไปรษณีย์แสดง แต่จะนําไปใช้ที่ไหน ประเทศเหล่านี้อาจเรียกใช้การตรวจสอบเพิ่มเติมกับส่วนอื่นๆ ของที่อยู่ (เช่น การตรวจสอบความถูกต้องของรัฐ/รหัสไปรษณีย์ในสหรัฐอเมริกา) |
sortingCode |
ไม่บังคับ รหัสการจัดเรียง รหัสเฉพาะในแต่ละประเทศ ซึ่งไม่ได้ใช้ในภูมิภาคส่วนใหญ่ เมื่อใช้งาน ค่าจะเป็นสตริง เช่น "CEDEX" (ไม่บังคับ) ตามด้วยตัวเลข (เช่น "CEDEX 7") หรือเป็นตัวเลขเพียงอย่างเดียว โดยแสดงถึง "sector โค้ด" (จาเมกา) "ดัชนีพื้นที่นําส่ง" (Malawi) หรือ &reti;หมายเลขกํากับสํานักงาน&&;"ข้อความ หมายเลขกํากับ; |
administrativeArea |
ไม่บังคับ เขตการปกครองที่สูงที่สุด ซึ่งใช้สําหรับที่อยู่ทางไปรษณีย์ของประเทศหรือภูมิภาค ซึ่งอาจเป็นรัฐ จังหวัด แคว้น หรือจังหวัด สําหรับสเปน นี่คือจังหวัดและไม่ใช่ชุมชนปกครองตนเอง (เช่น "Barcelona" และไม่ใช่ "Catalonia") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ทางไปรษณีย์ เช่น ในสวิตเซอร์แลนด์ไม่ควรเลือกตัวเลือกนี้ |
locality |
ไม่บังคับ โดยทั่วไปหมายถึงชื่อเมืองส่วนของเมืองของที่อยู่ ตัวอย่าง: เมืองของสหรัฐฯ, เทศบาลด้านไอที, เมืองตามเขตไปรษณีย์ของสหราชอาณาจักร ในภูมิภาคต่างๆ ในโลกที่พื้นที่ไม่เข้ากับพื้นที่หรือไม่ค่อยอยู่ในโครงสร้างนี้ ให้เว้นย่านไว้และใช้ที่อยู่ |
sublocality |
ไม่บังคับ ที่อยู่ย่อยของที่อยู่ ตัวอย่างเช่น อาจเป็นละแวก เขตเมือง หรือเขต |
addressLines[] |
บรรทัดที่ไม่มีโครงสร้างซึ่งอธิบายระดับต่างๆ ของที่อยู่ เนื่องจากค่าใน addresslines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") จึงเป็นสิ่งสําคัญที่ลําดับจะต้องชัดเจน ลําดับของบรรทัดที่อยู่ควรเป็น "ลําดับซองจดหมาย" สําหรับประเทศ/ภูมิภาคของที่อยู่นั้น ในที่ที่สามารถเปลี่ยนแปลงได้ (เช่น ญี่ปุ่น) address_language จะใช้เพื่อทําให้มีความโจ่งแจ้ง (เช่น "ja" สําหรับการจัดเรียงจากมากไปน้อยและ "ja-Latn" หรือ "en" สําหรับธุรกิจขนาดเล็กถึงใหญ่) วิธีนี้จะทําให้ระบบเลือกบรรทัดที่เจาะจงมากที่สุดของที่อยู่ตามภาษาได้ การแสดงโครงสร้างที่ได้รับอนุญาตน้อยที่สุดของที่อยู่ต้องประกอบด้วยรหัสภูมิภาคซึ่งมีข้อมูลส่วนที่เหลือทั้งหมดอยู่ในบรรทัดที่อยู่ คุณสามารถจัดรูปแบบที่อยู่ดังกล่าวโดยประมาณได้มากโดยไม่ต้องมีการกําหนดพิกัดทางภูมิศาสตร์ แต่ก็ไม่อาจให้เหตุผลทางอรรถศาสตร์เกี่ยวกับองค์ประกอบของที่อยู่ได้จนกว่าจะได้รับการแก้ไขบางส่วนเป็นอย่างน้อย การสร้างที่อยู่ที่มีภูมิภาค codeCode และ addressLine เท่านั้น แล้วแนะนําให้ใช้การเข้ารหัสพิกัดเพื่อจัดการกับที่อยู่ที่ไม่มีโครงสร้างโดยสมบูรณ์ (ซึ่งต่างจากการคาดเดาว่าที่อยู่ส่วนไหนควรเป็นย่านท้องถิ่นหรือพื้นที่บริหาร) |
recipients[] |
ไม่บังคับ ผู้รับตามที่อยู่ ช่องนี้อาจมีข้อมูลหลายบรรทัดในบางกรณี เช่น อาจมี&"การดูแลรักษา" ข้อมูล |
organization |
ไม่บังคับ ชื่อองค์กรของที่อยู่ |