PostalAddress

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

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

Mẹo về cách nhập hoặc chỉnh sửa địa chỉ: – Sử dụng tiện ích địa chỉ sẵn sàng cho quốc tế hoá, chẳng hạn như https://github.com/google/libaddressinput. – Người dùng không được thấy các thành phần trê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 đó.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, hãy xem: 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
}
Trường
revision

integer

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

Tất 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ỉ. Giá trị này không bao giờ được suy luận và người dùng phải đảm bảo giá trị này là chính xác. Hãy xem https://cldr.unicode.org/ và https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết thông tin 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 trong địa chỉ này (nếu có). Đâ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 định dạng ở một số quốc gia, nhưng không ảnh hưởng đến độ 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 hoặc hoạt động nào khác không liên quan đến định dạng.

Nếu không xác định được giá trị này, bạn nên bỏ qua giá trị đó (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 quốc gia nào cũng sử dụng hoặc yêu cầu phải có mã bưu chính, nhưng ở những quốc gia sử dụng mã bưu chính, mã này có thể kích hoạt quy trình xác thực bổ sung với các phần khác của địa chỉ (ví dụ: xác thực tiểu bang hoặc mã zip ở Hoa Kỳ).
sortingCode

string

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

string

Không bắt buộc. Phân khu hành chính cao nhất dùng cho địa chỉ bưu chính của một quốc gia hoặc khu vực. Ví dụ: đây có thể là tiểu bang, tỉnh, oblast hoặc tỉnh. Đố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 trong địa chỉ bưu chính. Ví dụ: ở Thuỵ Sĩ, bạn không nên đ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ố hoặc thị trấn trong địa chỉ. Ví dụ: thành phố ở Hoa Kỳ, comune ở Ý, thị trấn bưu chính ở Vương quốc Anh. Ở những khu vực trên thế giới mà địa phương không được xác định rõ ràng hoặc không phù hợp với cấu trúc này, hãy để trống locality và sử dụng addressLines.
sublocality

string

Không bắt buộc. Khu vực phụ của địa chỉ. Ví dụ: khu vực này có thể là một khu dân cư, quận hoặc huyện.
addressLines[]

string

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

Vì 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 (ví dụ: "Austin, TX"), nên bạn cần phải sắp xếp thứ tự dòng một cách rõ ràng. Thứ tự các dòng địa chỉ phải là "thứ tự trên phong bì" đối với quốc gia hoặc khu vực của địa chỉ. Ở những nơi có thể khác nhau (ví dụ: Nhật Bản), address_language được dùng để làm rõ (ví dụ: "ja" để sắp xếp từ lớn đến nhỏ và "ja-Latn" hoặc "en" để sắp xếp từ nhỏ đến lớn). Bằng cách này, bạn có thể chọn dòng cụ thể nhất của địa chỉ dựa trên ngôn ngữ.

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

Bạn nên tạo một địa chỉ chỉ chứa regionCode và addressLines, sau đó mã hoá địa lý để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán xem phần nào của đị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ụ: thông tin này có thể chứa thông tin "người nhận thay mặt".
organization

string

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