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

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

administrativeArea

string

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

locality

string

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

sublocality

string

ไม่บังคับ ท้องถิ่นย่อยของที่อยู่ เช่น ย่าน เขต หรืออำเภอ

addressLines[]

string

บรรทัดที่อยู่ที่ไม่มีโครงสร้างซึ่งอธิบายระดับที่ต่ำกว่าของที่อยู่

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

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

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

recipients[]

string

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

organization

string

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