Autocomplete Data

Chứa tên mà con người có thể đọc được cho kết quả được trả về. Đối với kết quả về cơ sở kinh doanh, đây thường là tên và địa chỉ doanh nghiệp.

Nếu AutocompleteRequest.sessionToken được cung cấp trong AutocompleteRequest dùng để tìm nạp AutocompleteSuggestion này, thì mã thông báo tương tự sẽ tự động được đưa vào khi gọi Place.fetchFields lần đầu tiên trên Place do lệnh gọi đến PlacePrediction.toPlace trả về.

Chuỗi văn bản cần tìm kiếm.

Bao gồm các cụm từ gợi ý về địa điểm cho những doanh nghiệp chưa mở cửa nhưng dự kiến sẽ mở cửa trong tương lai.

Loại địa điểm chính được đưa vào (ví dụ: "nhà hàng" hoặc "trạm xăng").

Địa điểm chỉ được trả về nếu loại chính của địa điểm đó có trong danh sách này. Bạn có thể chỉ định tối đa 5 giá trị. Nếu bạn không chỉ định loại nào, thì tất cả các loại Địa điểm sẽ được trả về.

Chỉ bao gồm kết quả ở các khu vực được chỉ định, được chỉ định tối đa 15 mã khu vực gồm hai ký tự CLDR. Một tập hợp trống sẽ không hạn chế kết quả. Nếu bạn đặt cả locationRestriction và includedRegionCodes, thì kết quả sẽ nằm trong khu vực giao nhau.

Độ lệch ký tự Unicode dựa trên số 0 của input cho biết vị trí con trỏ trong input. Vị trí con trỏ có thể ảnh hưởng đến cụm từ gợi ý được trả về. Nếu không được chỉ định, giá trị mặc định sẽ là độ dài của input.

Giá trị nhận dạng dùng để phân bổ lệnh gọi cho các gói hoặc thư viện OSS cụ thể.

Ngôn ngữ để trả về kết quả. Ngôn ngữ mặc định sẽ là ngôn ngữ ưu tiên của trình duyệt. Kết quả có thể bằng nhiều ngôn ngữ nếu ngôn ngữ dùng trong input khác với language hoặc nếu Địa điểm được trả về không có bản dịch từ ngôn ngữ địa phương sang language.

Thiên vị kết quả cho một vị trí cụ thể.

Bạn chỉ nên đặt tối đa một trong hai thuộc tính locationBias hoặc locationRestriction. Nếu bạn không đặt cả hai, kết quả sẽ được thiên vị theo địa chỉ IP, nghĩa là địa chỉ IP sẽ được liên kết với một vị trí không chính xác và được dùng làm tín hiệu thiên vị.

Giới hạn kết quả ở một vị trí cụ thể.

Bạn chỉ nên đặt tối đa một trong hai thuộc tính locationBias hoặc locationRestriction. Nếu bạn không đặt cả hai, kết quả sẽ được thiên vị theo địa chỉ IP, nghĩa là địa chỉ IP sẽ được liên kết với một vị trí không chính xác và được dùng làm tín hiệu thiên vị.

Điểm xuất phát để tính khoảng cách trắc địa đến điểm đến (được trả về dưới dạng PlacePrediction.distanceMeters). Nếu bạn bỏ qua giá trị này, thì khoảng cách trắc địa sẽ không được trả về.

Bao gồm các doanh nghiệp chỉ cung cấp dịch vụ tại cơ sở khách hàng nếu trường này được đặt thành true. Doanh nghiệp chỉ phục vụ tận nơi là doanh nghiệp trực tiếp cung cấp dịch vụ tận nơi hoặc giao hàng cho khách hàng, nhưng không phục vụ khách hàng tại địa chỉ doanh nghiệp. Ví dụ: Những doanh nghiệp cung cấp dịch vụ vệ sinh hoặc sửa ống nước có thể không có địa chỉ hoặc địa điểm thực tế trên Google Maps.

Mã khu vực, được chỉ định dưới dạng mã khu vực gồm hai ký tự CLDR. Điều này ảnh hưởng đến định dạng địa chỉ, thứ hạng kết quả và có thể ảnh hưởng đến kết quả được trả về. Điều này không giới hạn kết quả ở khu vực được chỉ định.

Mã thông báo xác định phiên Tự động hoàn thành cho mục đích thanh toán. Tạo mã thông báo phiên mới thông qua AutocompleteSessionToken.

Phiên bắt đầu khi người dùng bắt đầu nhập một cụm từ tìm kiếm và kết thúc khi họ chọn một địa điểm rồi gọi Place.fetchFields. Mỗi phiên có thể có nhiều truy vấn, theo sau là một lệnh gọi fetchFields. Thông tin xác thực dùng cho mỗi yêu cầu trong một phiên phải thuộc về cùng một dự án trên Google Cloud Console. Sau khi phiên kết thúc, mã thông báo sẽ không còn hợp lệ; ứng dụng của bạn phải tạo một mã thông báo mới cho mỗi phiên. Nếu bạn bỏ qua tham số sessionToken hoặc nếu bạn sử dụng lại mã phiên, thì phiên đó sẽ được tính phí như thể không có mã phiên nào được cung cấp (mỗi yêu cầu được tính phí riêng).

Khi mã phiên được cung cấp trong yêu cầu đến AutocompleteSuggestion.fetchAutocompleteSuggestions, mã đó sẽ tự động được đưa vào lệnh gọi đầu tiên đến fetchFields trên Place được trả về bằng cách gọi PlacePrediction.toPlace trên một trong các AutocompleteSuggestion kết quả.

Bạn nên làm theo các nguyên tắc sau:

• Sử dụng mã thông báo phiên cho tất cả lệnh gọi Place Autocomplete.
• Tạo mã thông báo mới cho mỗi phiên.
• Hãy nhớ truyền một mã thông báo phiên riêng biệt cho mỗi phiên mới. Nếu bạn sử dụng cùng một mã thông báo cho nhiều phiên, thì mỗi yêu cầu sẽ được tính phí riêng.

Chiều dài của đường trắc địa tính bằng mét từ origin nếu origin được chỉ định.

Đại diện cho tên của Địa điểm.

Giá trị nhận dạng riêng biệt của Địa điểm được đề xuất. Bạn có thể sử dụng giá trị nhận dạng này trong các API khác chấp nhận Mã địa điểm.

Biểu thị các tính năng phân định bổ sung (chẳng hạn như thành phố hoặc khu vực) để xác định rõ hơn Địa điểm.

Chứa tên mà con người có thể đọc được cho kết quả được trả về. Đối với kết quả về cơ sở kinh doanh, đây thường là tên và địa chỉ doanh nghiệp.

text được đề xuất cho những nhà phát triển muốn hiển thị một thành phần giao diện người dùng duy nhất. Nhà phát triển muốn hiển thị hai phần tử trên giao diện người dùng riêng biệt nhưng có liên quan có thể sử dụng PlacePrediction.mainText và PlacePrediction.secondaryText.

Danh sách các loại áp dụng cho Địa điểm này trong Bảng A hoặc Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types.

Phần bù trừ dựa trên số 0 của ký tự Unicode cuối cùng của chuỗi con (không bao gồm).

Giá trị bù trừ dựa trên số 0 của ký tự Unicode đầu tiên của chuỗi con (bao gồm).

Danh sách các dải ô chuỗi xác định vị trí yêu cầu đầu vào khớp trong FormattableText.text. Bạn có thể dùng các dải ô để định dạng các phần cụ thể của text. Chuỗi con có thể không khớp chính xác với AutocompleteRequest.input nếu kết quả trùng khớp được xác định theo tiêu chí khác ngoài việc so khớp chuỗi (ví dụ: sửa lỗi chính tả hoặc chuyển tự). Các giá trị này là độ lệch ký tự Unicode của FormattableText.text. Các dải ô được đảm bảo sắp xếp theo thứ tự giá trị bù trừ tăng dần.

Văn bản có thể được sử dụng nguyên trạng hoặc được định dạng bằng FormattableText.matches.