Package google.type

Chỉ mục

• LatLng (thông báo)
• PostalAddress (thông báo)

LatLng

Một đối tượng đại diện cho cặp vĩ độ/kinh độ. Đây là một cặp số kép để biểu thị độ vĩ độ và độ kinh độ. Trừ phi có quy định khác, đối tượng này phải tuân thủ tiêu chuẩn WGS84. Giá trị phải nằm trong phạm vi chuẩn hoá.

Các trường
latitude	double Vĩ độ tính theo độ. Giá trị này phải nằm trong khoảng [-90,0, +90,0].
longitude	double Kinh độ theo độ. Giá trị này phải nằm trong khoảng [-180,0, +180,0].

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	int32 Bản sửa đổi giản đồ của PostalAddress. Bất kỳ giá trị nào khác 0 đều sẽ khiến API trả về lỗi INVALID_ARGUMENT.
region_code	string Không bắt buộc. Mã vùng CLDR của quốc gia/khu vực trên địa chỉ. 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ĩ. Nếu bạn không cung cấp mã vùng, hệ thống sẽ suy ra mã vùng từ địa chỉ. Để đạt được hiệu suất tốt nhất, bạn nên thêm mã vùng nếu biết mã vùng. Việc có các khu vực không nhất quán hoặc lặp lại có thể dẫn đến hiệu suất kém. Ví dụ: nếu address_lines đã bao gồm khu vực, thì đừng cung cấp lại mã vùng trong trường này. Bạn có thể xem các khu vực được hỗ trợ trong phần Câu hỏi thường gặp.
language_code	string Mã ngôn ngữ trong địa chỉ nhập được dành riêng để sử dụng trong tương lai và sẽ bị bỏ qua vào hôm nay. API trả về địa chỉ bằng ngôn ngữ thích hợp cho nơi đặt địa chỉ đó.
postal_code	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 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	string 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	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ụ: đó 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	string 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	string 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[]	string Bắt buộ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 address_lines không có thông tin về 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ỉ. Thành phần trình bày cấu trúc tối thiểu được phép của một địa chỉ bao gồm tất cả thông tin có trong address_lines. Nếu bạn không cung cấp region_code, thì khu vực sẽ được suy ra từ các dòng địa chỉ. Tạo địa chỉ chỉ chứa address_lines, sau đó mã hoá đị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 (thay vì đoán phần nào của địa chỉ sẽ là địa phương hoặc khu vực hành chính).
recipients[]	string Vui lòng tránh đặt trường này. API xác thực địa chỉ hiện không sử dụng. Mặc dù tại thời điểm này, API sẽ không từ chối các yêu cầu có nhóm trường này, nhưng thông tin sẽ bị loại bỏ và sẽ không được trả về trong phản hồi.
organization	string Vui lòng tránh đặt trường này. API xác thực địa chỉ hiện không sử dụng. Mặc dù tại thời điểm này, API sẽ không từ chối các yêu cầu có nhóm trường này, nhưng thông tin sẽ bị loại bỏ và sẽ không được trả về trong phản hồi.