Biểu thị địa chỉ bưu điện, ví dụ: địa chỉ giao hàng hoặc địa chỉ thanh toán. Khi cung cấp địa chỉ bưu chính, dịch vụ bưu chính có thể giao các mặt hàng đến cơ sở, P.O. Box hoặc tương tự. Ứng dụng này không được lập mô hình các vị trí địa lý (đường, thị trấn, núi).
Thông thường, đị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ỉ có sẵn i18n như https://github.com/google/libaddressinput) – Người dùng không nên nhìn thấ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 những quốc gia mà trường đó được sử dụng.
Để được hướng dẫn thêm về cách sử dụng mã schema này, vui lòng 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 } |
|
| Các 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ỉ. Điều này không bao giờ được suy ra và người dùng có thể đảm bảo giá trị chính xác. Truy cập vào http://cldr.unicode.org/ và http://www.unicode.org/cldr/Charts/30/supplemental/lãnh thổ.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 liệu hoặc dự kiến khớp với một trong các ngôn ngữ được sử dụng trong địa chỉ\39; quốc gia/khu vực hoặc phiên bản tương đương được chuyển tự của các ngôn ngữ đó. Điều này có thể ảnh hưởng đến định dạng ở một số quốc gia nhất định, 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ỳ 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 được giá trị này, thì bạn nên bỏ qua giá trị này (thay vì chỉ định giá trị mặc định có thể không chính xác). Ví dụ: "zh-Hant", "ja", "ja-Latn", "vi" |
postalCode |
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 ở nơi sử dụng, các quốc gia đó 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/zip ở Hoa Kỳ). |
sortingCode |
Không bắt buộc. Mã sắp xếp bổ sung, theo quốc gia cụ thể. Thông tin này không được sử dụng ở hầu hết các khu vực. Trong trường hợp sử dụng, giá trị sẽ là một chuỗi như "CEDEX" (không bắt buộc) theo sau là một số (ví dụ: "CEDEX 7"), hoặc chỉ một số, đại diện cho "sector code" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo văn phòng> 9; 3; Áo; |
administrativeArea |
Không bắt buộc. Phân mục 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ụ: đó có thể là một tiểu bang, một tỉnh, một quận 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 trong địa chỉ bưu điện. Ví dụ: Ở Thụy Sĩ, bạn không nên để trống dữ liệu này. |
locality |
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ấn CNTT, thị trấn bưu điện Vương quốc Anh. Ở những khu vực trên thế giới, cá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 cụm địa phương và sử dụng các dòng địa chỉ. |
sublocality |
Không bắt buộc. Địa chỉ phụ của địa chỉ. Ví dụ: đó có thể là các khu phố, thị xã, quận. |
addressLines[] |
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ỉ. 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"), nên điều quan trọng là thứ tự dòng phải rõ ràng. Thứ tự của các dòng địa chỉ phải là "envelope order" cho quốc gia/khu vực của địa chỉ. Ở những nơi mà giá trị này có thể khác nhau (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 lớn đến nhỏ và "ja-Latn" hoặc "vi" cho kích thước 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ữ. Bản trình bày cấu trúc được phép tối thiểu 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 địa chỉ như vậy rất gần đúng mà không cần mã hoá địa lý, nhưng không thể có 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 chỉ nên tạo một địa chỉ có chứa mã vùng và địa chỉ. Sau đó, bạn nên xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì phỏng đoán những phần nào trong địa chỉ là khu vực địa phương hoặc khu vực hành chính). |
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ụ: Đường liên kết có thể chứa thông tin "care of". |
organization |
Không bắt buộc. Tên của tổ chức tại địa chỉ. |