Chỉ mục
PostalAddress(thông báo)
PostalAddress
Đại diện cho địa chỉ bưu chính, ví dụ: địa chỉ giao hàng hoặc thanh toán qua bưu điện. Khi có địa chỉ bưu chính, dịch vụ bưu chính có thể giao hàng đến tận nhà, hộp thư bưu điện hoặc những thứ tương tự. Bố cục này không nhằm lập mô hình vị trí địa lý (đường, thị trấn, núi).
Trong cách sử dụng thông thường, địa chỉ sẽ được tạo qua hoạt động đầu vào của người dùng 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ề việc nhập / chỉnh sửa địa chỉ: – Sử dụng tiện ích địa chỉ sẵn sàng quốc tế hoá như https://github.com/google/libaddressinput) – Không nên cung cấp cho người dùng 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 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
| 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 bản sửa đổi cũ. |
region_code |
Bắt buộc. Mã vùng CLDR của quốc gia/khu vực trên địa chỉ. Đ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ị chính xác. Hãy truy cập vào 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ĩ. |
language_code |
Không bắt buộc. Mã ngôn ngữ BCP-47 của nội dung đị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ữ dùng tại 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ất định, nhưng không quan trọng đối với độ chính xác của dữ liệu và sẽ không bao giờ ảnh hưởng đến bất kỳ thao tác xác thực hay hoạt động nào khác liên quan đến việc không định dạng. Nếu không xác định được giá trị này, 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", "en". |
postal_code |
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 bắt buộc phải có mã bưu chính. Tuy nhiên, ở những nơi sử dụng mã bưu chính, mã bưu chính 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/mã bưu chính ở Hoa Kỳ). |
sorting_code |
Không bắt buộc. Mã phân loại bổ sung theo quốc gia. Chế độ 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ị có thể là một chuỗi như "CEDEX", tuỳ ý 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" (ví dụ: Côte d'Ivoire). |
administrative_area |
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ụ: đó có thể là một tiểu bang, một tỉnh, một vùng hoặc một 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ụ: ở Thuỵ Sĩ, bạn nên bỏ trống mã này. |
locality |
Không bắt buộc. Thường có nghĩa là phần thành phố/thị trấn trong địa chỉ. Ví dụ: Thành phố ở Hoa Kỳ, khu CNTT, thị trấn có bưu điện ở Vương quốc Anh. Ở những khu vực trên thế giới nơi thành phố 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 local và sử dụng address_lines. |
sublocality |
Không bắt buộc. Cụm dân cư của địa chỉ. Ví dụ: đây có thể là vùng lân cận, thị xã, quận. |
address_lines[] |
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ỉ. Do các giá trị trong address_lines 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 điều quan trọng là thứ tự hàng phải rõ ràng. Thứ tự của các dòng địa chỉ phải là "phong bì đơn đặt hàng" cho quốc gia/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 để thể hiện rõ ràng (ví dụ: "ja" cho thứ tự 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 theo 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 một mã khu vực (region_code) với tất cả thông tin còn lại được đặt trong các dòng địa chỉ. Có thể định dạng địa chỉ như vậy rất gần mà không cần mã hoá địa lý, nhưng không thể đưa ra lý luận ngữ nghĩa nào 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 một địa chỉ chỉ chứa mã vùng và địa chỉ, sau đó mã hoá địa lý là cách được khuyên dùng để xử lý các địa chỉ hoàn toàn không có cấu trúc (trái ngược với đoán phần nào của địa chỉ nên 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 nhất định, trường này có thể chứa thông tin nhiều dòng. Ví dụ: tài liệu này 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ỉ. |