PostalAddress

แสดงที่อยู่ไปรษณีย์ เช่น ที่อยู่สําหรับจัดส่งทางไปรษณีย์หรือที่อยู่การชําระเงิน เนื่องจากที่อยู่ไปรษณีย์ บริการไปรษณีย์จะจัดส่งสินค้าไปยังตู้ไปรษณีย์หรือตู้ไปรษณีย์ที่คล้ายกันได้ ไม่ได้ใช้เพื่อสร้างแบบจําลองสถานที่ตั้งทางภูมิศาสตร์ (ถนน เมือง ภูเขา)

ในการใช้งานทั่วไป ระบบจะสร้างที่อยู่ผ่านการป้อนข้อมูลของผู้ใช้หรือการนําเข้าข้อมูลที่มีอยู่ ทั้งนี้ขึ้นอยู่กับประเภทของกระบวนการ

คําแนะนําเกี่ยวกับการป้อนข้อมูล/การแก้ไขที่อยู่: - ใช้วิดเจ็ตที่อยู่ระดับสากล เช่น 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

integer

การแก้ไขสคีมาของ PostalAddress ซึ่งต้องตั้งค่าเป็น 0 ซึ่งเป็นการแก้ไขล่าสุด

การแก้ไขใหม่ทั้งหมดต้องเข้ากันได้กับเวอร์ชันก่อนหน้า
regionCode

string

ต้องระบุ รหัสภูมิภาคของ CLDR ของประเทศ/ภูมิภาคของที่อยู่ วิธีการนี้ไม่ถือว่าอนุมานเลยและขึ้นอยู่กับผู้ใช้ว่าค่าถูกต้อง ดูรายละเอียดได้ที่ https://cldr.unicode.org/ และ https://www.unicode.org/cldr/chats/30/supplemental/territory_information.html ตัวอย่างเช่น "CH" สําหรับสวิตเซอร์แลนด์
languageCode

string

ไม่บังคับ รหัสภาษา BCP-47 ของที่อยู่นี้ (หากรู้จัก) ซึ่งมักจะเป็นภาษา UI ของแบบฟอร์มอินพุตหรือคาดว่าจะตรงกับภาษาใดภาษาหนึ่งที่ใช้ในประเทศ/ภูมิภาคของที่อยู่ หรือภาษาใกล้เคียง การดําเนินการนี้อาจส่งผลต่อการจัดรูปแบบในบางประเทศ แต่ไม่จําเป็นต่อความถูกต้องของข้อมูลและจะไม่ส่งผลกระทบต่อการตรวจสอบหรือการดําเนินการอื่นๆ ที่เกี่ยวข้องกับการจัดรูปแบบ

หากไม่ทราบค่านี้ ไม่ควรระบุค่าดังกล่าว (แทนการระบุค่าเริ่มต้นที่อาจไม่ถูกต้อง)

ตัวอย่างเช่น "zh-Hant", "ja", "ja-Latn", "en"
postalCode

string

ไม่บังคับ รหัสไปรษณีย์ของที่อยู่ ไม่ใช่ทุกประเทศที่ใช้หรือกําหนดให้มีรหัสไปรษณีย์ แต่สําหรับสถานที่ที่ใช้ ประเทศนั้นอาจใช้การตรวจสอบความถูกต้องของส่วนอื่นๆ ของที่อยู่ด้วย (เช่น รัฐ/รหัสไปรษณีย์ของสหรัฐอเมริกา)
sortingCode

string

ไม่บังคับ รหัสการจัดเรียงเฉพาะประเทศเพิ่มเติม โดยไม่ได้ใช้ในภูมิภาคส่วนใหญ่ ในการใช้ ค่าจะเป็นสตริง เช่น "CEDEX" โดยอาจตามด้วยตัวเลข (เช่น "CEDEX 7") หรือใช้เพียงตัวเลขเดียวที่แสดงถึง "รหัสภาค" (จาเมกา) "ตัวระบุพื้นที่นําส่ง" (มาลาวี) หรือ "ตัวระบุที่ทําการไปรษณีย์" (เช่น โกตดิวัวร์)
administrativeArea

string

ไม่บังคับ ส่วนย่อยของการดูแลระบบสูงสุด ซึ่งใช้สําหรับที่อยู่ไปรษณีย์ของประเทศหรือภูมิภาค เช่น รัฐ จังหวัด แคว้น หรือจังหวัด สําหรับสเปน นี่คือจังหวัดและไม่ใช่ชุมชนปกครองตนเอง (เช่น "บาร์เซโลนา" ไม่ใช่ "คาตาโลเนีย") หลายประเทศไม่ได้ใช้เขตบริหารในที่อยู่ทางไปรษณีย์ เช่น สวิตเซอร์แลนด์ ไม่ควรป้อนข้อมูลนี้
locality

string

ไม่บังคับ โดยทั่วไปหมายถึงส่วนของเมือง/เมืองของที่อยู่ เช่น เมืองในสหรัฐอเมริกา เทศบาลเมือง เมืองในสหราชอาณาจักร ในภูมิภาคต่างๆ ของโลกที่ไม่มีการกําหนดย่านท้องถิ่นหรือไม่เหมาะกับโครงสร้างนี้ ให้เว้นย่านว่างไว้และใช้ addressLines
sublocality

string

ไม่บังคับ ย่านย่อยของที่อยู่ ตัวอย่างเช่น เขตละแวก เขตเมือง เขต
addressLines[]

string

บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายที่อยู่ระดับล่าง

เนื่องจากค่าใน addressLines ไม่มีข้อมูลประเภท และบางครั้งอาจมีค่าหลายค่าในช่องเดียว (เช่น "Austin, TX") จึงต้องมีลําดับชัดเจน ลําดับของบรรทัดที่อยู่ควรเป็น "ลําดับเอนเวโลป" สําหรับประเทศ/ภูมิภาคของที่อยู่ ในที่อาจแตกต่างกัน (เช่น ญี่ปุ่น) address_language จะใช้เพื่อให้มีความโจ่งแจ้ง (เช่น "ja" สําหรับการสั่งซื้อขนาดใหญ่สู่ขนาดเล็ก และ "ja-Latn" หรือ "en" สําหรับขนาดเล็กถึงใหญ่) วิธีนี้จะทําให้เลือกบรรทัดที่เจาะจงที่สุดของที่อยู่ได้โดยอิงตามภาษา

การแสดงโครงสร้างทางที่อยู่ขั้นต่ําที่อนุญาตจะประกอบด้วยภูมิภาคของ CodeCode ซึ่งมีข้อมูลที่เหลืออยู่ทั้งหมดในแถบที่อยู่ คุณสามารถจัดรูปแบบที่อยู่ดังกล่าวโดยประมาณได้อย่างมากโดยไม่มีการกําหนดภูมิศาสตร์ แต่จะไม่มีการให้เหตุผลด้านความหมายเกี่ยวกับคอมโพเนนต์ของที่อยู่จนกว่าจะได้รับการแก้ไขบางส่วนเป็นอย่างน้อย

การสร้างที่อยู่ที่มีภูมิภาค CodeCode และ addressLines เท่านั้น แล้วตามด้วยการกําหนดภูมิศาสตร์ก็เป็นวิธีที่แนะนําในการจัดการที่อยู่ที่ไม่มีโครงสร้างโดยสมบูรณ์ (แทนที่จะคาดเดาว่าส่วนใดของที่อยู่นั้นเป็นพื้นที่ในท้องถิ่นหรือเขตบริหาร)
recipients[]

string

ไม่บังคับ ผู้รับในที่อยู่ ในบางกรณี ช่องนี้อาจมีข้อมูลหลายบรรทัด เช่น ไฟล์นี้อาจมีข้อมูล "การดูแล"
organization

string

ไม่บังคับ ชื่อองค์กรในที่อยู่