Trang này được dịch bởi Cloud Translation API.

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 một cặp vĩ độ/kinh độ. Giá trị này được biểu thị dưới dạng một cặp số thực để thể hiện vĩ độ và kinh độ theo độ. 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á.

Trường

Trường
`latitude`	`double` Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].
`longitude`	`double` Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

latitude

double

Vĩ độ tính bằng độ. Giá trị này phải nằm trong khoảng [-90.0, +90.0].

longitude

double

Kinh độ tính bằng độ. Giá trị này phải nằm trong khoảng [-180.0, +180.0].

PostalAddress (Địa chỉ bưu điện)

Đại diện cho địa chỉ bưu chính, ví dụ như địa chỉ giao hàng qua đường bưu điện hoặc địa chỉ thanh toán. Khi có đị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 chính hoặc địa chỉ tương tự. Lớp này không dùng để mô hình hoá các vị trí địa lý (đường, thị trấn, núi).

Trong trường hợp sử dụng thông thường, địa chỉ sẽ được tạo thông qua dữ liệu do người dùng nhập 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ề 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á, chẳng hạn 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 đó.

Để biết thêm hướng dẫn về cách sử dụng giản đồ này, vui lòng xem: https://support.google.com/business/answer/6397478

Trường
`revision`	`int32` Bản sửa đổi giản đồ của `PostalAddress`. Bất kỳ giá trị nào khác 0 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 của địa chỉ. 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ĩ. Nếu bạn không cung cấp mã vùng thì mã đó sẽ được suy ra từ địa chỉ đó. Để đạt được hiệu suất cao nhất, bạn nên thêm mã khu vực nếu biết. 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ì bạn không nên cung cấp lại mã khu vực 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 sau này và sẽ bị bỏ qua hôm nay. API này trả về địa chỉ bằng ngôn ngữ thích hợp cho vị trí của đị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 yêu cầu phải có mã bưu chính, nhưng ở những quốc gia 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/mã zip ở Hoa Kỳ).
`sorting_code`	`string` Không bắt buộc. Mã sắp xếp bổ sung, dành riêng cho quốc gia. Mã này không được sử dụng ở hầu hết các khu vực. Khi giá trị được sử dụng, giá trị này có thể là một chuỗi như "CEDEX", 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'Côte d'iban).
`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ụ: bạn có thể nhập 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 không nên điền thông tin này.
`locality`	`string` Không bắt buộc. Thường đề cập đến phần thành phố/thị trấn của địa chỉ. Ví dụ: thành phố ở Hoa Kỳ, comune ở Ý, 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õ ràng 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 address_lines.
`sublocality`	`string` Không bắt buộc. Quận/phường của địa chỉ. Ví dụ: khu dân cư, quận, huyện.
`address_lines[]`	`string` Bắt buộc. Dòng địa chỉ phi 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 bạn cần phải sắp xếp thứ tự dòng một cách rõ ràng. Thứ tự của các dòng địa chỉ phải là "thứ tự phong bì" đối với quốc gia/khu vực của địa chỉ. Biểu diễn 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 đặt 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ỉ. Bạn nên tạo một địa chỉ chỉ chứa `address_lines`, sau đó mã hoá địa lý để xử lý các địa chỉ hoàn toàn không có cấu trúc (thay vì đoán xem phần nào của địa chỉ 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 thông tin này. 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à 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 API này. Mặc dù hiện tại API sẽ không từ chối các yêu cầu có trường này, nhưng thông tin sẽ bị loại bỏ và không được trả về trong phản hồi.