PostalAddress

การแสดง JSON

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

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

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

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