Đại diện cho địa chỉ bưu chính, chẳng hạn như địa chỉ thanh toán hoặc địa chỉ giao hàng qua bưu điện. Với đị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 điểm tương tự. Địa chỉ bưu chính không nhằm mục đích mô hình hoá các vị trí địa lý như đường, thị trấn hoặc núi.
Trong trường hợp sử dụng thông thường, địa chỉ sẽ được tạo bằng thông tin do người dùng nhập hoặc bằng cách nhập dữ liệu hiện có, tuỳ thuộc vào loại quy trình.
Lời khuyên 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 nhìn thấy các phần tử 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 nơi trường đó được sử dụ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 |
Bản sửa đổi giản đồ của 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 |
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 |
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 ngôn ngữ dự kiến 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 ngôn ngữ chuyển tự tương đương. Đ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 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 hoặc hoạt động nào khác không liên quan đến định dạng. Nếu không biết giá trị này, bạn nên bỏ qua (thay vì chỉ định một giá trị mặc định có thể không chính xác). Ví dụ: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
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 mã bưu chính, nhưng ở những quốc gia có 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 |
Không bắt buộc. Mã ngân hàng bổ sung, theo quốc gia cụ thể. Mật độ 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", có thể theo sau 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 giao hàng" (Malawi) hoặc "chỉ báo bưu điện" (Côte d'Ivoire). |
administrativeArea |
Không bắt buộc. Phân khu hành chính cao nhất được 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, tỉnh bang 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 |
Không bắt buộc. Thường là phần thành phố hoặc thị trấn của địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, xã ở Ý, 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õ hoặc không phù hợp với cấu trúc này, hãy để trống |
sublocality |
Không bắt buộc. Địa phương phụ của địa chỉ. Ví dụ: đây có thể là khu lân cận, quận hoặc huyện. |
addressLines[] |
Các dòng địa chỉ không có cấu trúc mô tả các cấp thấp hơn của một địa chỉ. Vì các giá trị trong Cấu trúc tối thiểu được phép của một địa chỉ bao gồm một Bạn nên tạo một địa chỉ chỉ chứa |
recipients[] |
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ụ: địa chỉ có thể chứa thông tin "nhờ chuyển". |
organization |
Không bắt buộc. Tên của tổ chức tại địa chỉ đó. |