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