PostalAddress

Thể hiện địa chỉ bưu điện, ví dụ: cho địa chỉ giao hàng hoặc thanh toán qua bưu điện. Khi cung cấp địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến địa điểm, hộp thư bưu điện hoặc các dịch vụ tương tự. Hệ thống này không nhằm mục đích lập mô hình các vị trí địa lý (đường bộ, thị trấn, núi).

Trong trường hợp sử dụng thông thường, một địa chỉ sẽ được tạo thông qua hoạt động đầu vào của người dùng hoặc từ việc nhập dữ liệu hiện có, tuỳ thuộc vào loại quy trình.

Lời khuyên về nhập / chỉnh sửa địa chỉ: - Sử dụng tiện ích địa chỉ sẵn sàng quốc tế hóa như https://github.com/google/libaddressinput) - Người dùng không được trình bày các thành phần giao diện người dùng để nhập hoặc chỉnh sửa các trường bên ngoài quốc gia sử dụng trường đó.

Để xem thêm hướng dẫn về cách sử dụng mã schema này, vui lòng truy cập vào: https://support.google.com/business/answer/6397478

Biểu diễn dưới dạng JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Các trường
revision

integer

Bản sửa đổi giản đồ của PostalAddress. Đây phải là giá trị được đặt thành 0, đây là bản sửa đổi mới nhất.

Tất cả các bản sửa đổi mới phải tương thích ngược với các bản sửa đổi cũ.
regionCode

string

Bắt buộc. Mã vùng CLDR của quốc gia/khu vực của địa chỉ này. Điều này không bao giờ được suy luận và người dùng có trách nhiệm đảm bảo giá trị này chính xác. Hãy truy cập https://cldr.unicode.org/ và https://www.unicode.org/cldr/Charts/30/supplemental/lãnh thổ thông tin.html để biết chi tiết. Ví dụ: "CH" cho Thuỵ Sĩ.
languageCode

string

Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung của địa chỉ này (nếu biết). Đây thường là ngôn ngữ giao diện người dùng của biểu mẫu nhập hoặc dự kiến sẽ khớp với một trong các ngôn ngữ được sử dụng ở quốc gia/khu vực của địa chỉ hoặc các ngôn ngữ tương đương được chuyển tự. Điều này có thể ảnh hưởng đến việc định dạng ở một số quốc gia, nhưng không quan trọng đối với tính chính xác của dữ liệu và sẽ không bao giờ ảnh hưởng đến bất kỳ hoạt động xác thực nào hoặc các hoạt động khác không liên quan đến định dạng.

Nếu không xác định, giá trị này sẽ bị bỏ qua (thay vì chỉ định giá trị mặc định có thể không chính xác).

Ví dụ: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

Không bắt buộc. Mã bưu chính của địa chỉ. Không phải tất cả các quốc gia đều sử dụng hoặc yêu cầu phải có mã bưu chính, nhưng khi sử dụng mã bưu chính, họ có thể kích hoạt thêm quy trình xác thực cùng với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang/mã zip ở Hoa Kỳ).
sortingCode

string

Không bắt buộc. Mã sắp xếp bổ sung, cụ thể theo quốc gia. Thông tin này không được sử dụng ở hầu hết các khu vực. Khi được sử dụng, giá trị có thể là một chuỗi như "CEDEX", theo sau là một số (ví dụ: "CEDEX 7") hoặc chỉ một số, đại diện cho "mã vùng" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "bưu điện bưu điện" (ví dụ: Bờ Biển Ngà).
administrativeArea

string

Không bắt buộc. Phân khu hành chính cao nhất dùng cho các địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: đó có thể là một tiểu bang, một tỉnh, một vùng hoặc tỉnh. Cụ thể, đối với Tây Ban Nha, đây là tỉnh chứ không phải cộng đồng tự trị (ví dụ: "Barcelona" chứ không phải "Catalonia"). Nhiều quốc gia không sử dụng khu vực hành chính vào địa chỉ bưu chính. Ví dụ: Ở Thuỵ Sĩ không được điền thông tin này.
locality

string

Không bắt buộc. Thường đề cập đến phần thành phố/thị trấn. Ví dụ: Thành phố ở Hoa Kỳ, thị trường CNTT, bưu điện Vương quốc Anh. Ở những khu vực trên thế giới có địa phương không được xác định rõ hoặc không phù hợp với cấu trúc này, hãy để trống địa phương và sử dụng địa chỉ.
sublocality

string

Không bắt buộc. Thành phố nhỏ của địa chỉ. Ví dụ: đó có thể là các vùng lân cận, thị xã, quận.
addressLines[]

string

Dòng địa chỉ không có cấu trúc mô tả cấp thấp hơn của một địa chỉ.

Do các giá trị trong addressLines không có thông tin loại và đôi khi có thể chứa nhiều giá trị trong một trường duy nhất (ví dụ: "Austin, TX"), điều quan trọng là thứ tự dòng phải rõ ràng. Thứ tự của dòng địa chỉ phải là "đơn đặt hàng phong phú" cho quốc gia/khu vực của địa chỉ. Ở những nơi mà tên này có thể thay đổi (ví dụ: Nhật Bản), address_language được sử dụng để thể hiện rõ ràng (ví dụ: "ja" cho đơn đặt hàng từ lớn đến nhỏ và "ja-Latn" hoặc "en" cho từ nhỏ đến lớn). Bằng cách này, bạn có thể chọn dòng địa chỉ cụ thể nhất dựa trên ngôn ngữ.

Địa chỉ cấu trúc tối thiểu được cho phép của một địa chỉ bao gồm mã vùng với tất cả thông tin còn lại được đặt trong addressLines. Có thể định dạng như vậy một địa chỉ như vậy mà không cần mã hoá địa lý, nhưng không thể lý giải ngữ nghĩa cho bất kỳ thành phần địa chỉ nào cho đến khi địa chỉ ít nhất được giải quyết một phần.

Bạn chỉ nên tạo một địa chỉ vùng, mã địa chỉ và mã địa chỉ, sau đó mã hoá địa lý là phương pháp được đề xuất để xử lý các địa chỉ hoàn toàn không có cấu trúc (trái ngược với việc đoán phần nào trong địa chỉ là địa phương hoặc khu vực hành chính).
recipients[]

string

Không bắt buộc. Người nhận tại địa chỉ. Trong một số trường hợp, trường này có thể chứa thông tin nhiều dòng. Ví dụ: trang này có thể chứa thông tin "chăm sóc".
organization

string

Không bắt buộc. Tên của tổ chức tại địa chỉ đó.