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/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") หรือเป็นตัวเลขอย่างเดียว ซึ่งแสดงถึง "รหัสภาค" (จาเมกา) "ตัวบ่งชี้พื้นที่นำส่ง" (มาลาวี) หรือ "ตัวบ่งชี้ที่ทำการไปรษณีย์" (โกตดิวัวร์)
administrativeArea

string

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

string

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

string

ไม่บังคับ แขวงของที่อยู่ เช่น ย่าน เขต หรืออำเภอ
addressLines[]

string

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

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

การแสดงโครงสร้างที่อยู่ขั้นต่ำที่อนุญาตประกอบด้วย regionCode โดยมีข้อมูลที่เหลือทั้งหมดอยู่ใน addressLines คุณสามารถจัดรูปแบบที่อยู่ดังกล่าวได้โดยประมาณโดยไม่ต้องใช้ Geocoding แต่จะไม่มีการให้เหตุผลเชิงความหมายเกี่ยวกับองค์ประกอบของที่อยู่จนกว่าจะได้รับการแก้ไขอย่างน้อยบางส่วน

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

string

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

string

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