Thể hiện địa chỉ gửi thư, ví dụ: đối với địa chỉ gửi thư 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 hàng đến một cơ sở, P.O. Box hoặc tương tự. Tác phẩm này không nhằm lập mô hình vị trí địa lý (đường, thị trấn, núi).
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ó, tùy 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 i18n như https://github.com/google/libaddressinput) - Không nên hiển thị người dùng các thành phần giao diện người dùng cho việc nhập hoặc chỉnh sửa các trường bên ngoài trường nơi sử dụng trường đó.
Để được hướng dẫn thêm về cách sử dụng giản đồ 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ả 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 trong địa chỉ. Giá trị 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ị chính xác hay không. Xem http://cldr.unicode.org/ và http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html để biết chi tiết. Ví dụ: "CH" cho Thụy Sĩ. |
languageCode |
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 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 giá trị tương đương chuyển ngữ của 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ông liên quan đến định dạng khác. Nếu giá trị này không xác định thì phải 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 |
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 ở những nơi được sử dụng, các quốc gia đó có thể kích hoạt 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ã phân loại bổ sung, cụ thể theo quốc gia. Tính năng 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ị là một chuỗi như "CEDEX", theo sau là số (ví dụ: "CEDEX 7") hoặc chỉ một số, đại diện cho "mã khu vực" (Jamaica), "chỉ báo khu vực giao hàng" (Malawi) hoặc "chỉ báo bưu điện" (ví dụ: Côte d'Ivoire). |
administrativeArea |
Không bắt buộc. Phân khu hành chính cao nhất được sử dụng cho các địa chỉ bưu điện 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 trong địa chỉ bưu điện. Ví dụ: ở Thụy Sĩ, thông tin này không nên được điền sẵn. |
locality |
Không bắt buộc. Nói chung đề cập đến phần thành phố/thị trấn trong địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, Cộng đồng CNTT, thị trấn có bưu điện Vương quốc Anh. Ở các 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 địa phương và sử dụng addressLines. |
sublocality |
Không bắt buộc. Cụm dân cư của địa chỉ. Ví dụ: đó có thể là các vùng lân cận, thị xã, quậ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 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"), đ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à "đơn đặt hàng phong bì" cho quốc gia/vùng của địa chỉ. Ở những vị trí có thể thay đổi địa chỉ này (ví dụ: Nhật Bản), address_language được dùng để thể hiện rõ ràng (ví dụ: "ja" cho từ lớn đến nhỏ và "ja-Latn" hoặc "en" cho từ nhỏ đến lớn). Bằng cách này, dòng địa chỉ cụ thể nhất có thể được chọn dựa trên ngôn ngữ. Phần trình bày có cấu trúc tối thiểu về địa chỉ được phép 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ã hóa địa lý, nhưng không thể lý luận ngữ nghĩa về 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. Tạo địa chỉ chỉ chứa mã vùng và dòng địa chỉ, sau đó mã hóa địa lý là cách được đề xuất để xử lý các địa chỉ hoàn toàn không có cấu trúc (trái với việc đoán xem phần nào của địa chỉ phải là đị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 đường. Ví dụ: trang có thể chứa thông tin "chăm sóc". |
organization |
Không bắt buộc. Tên của tổ chức tại địa chỉ. |