Autocomplete Data (new)

Giao diện AutocompleteRequest

Giao diện google.maps.places.AutocompleteRequest

Giao diện yêu cầu cho AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Loại:  string
Chuỗi văn bản mà bạn muốn tìm kiếm.
includedPrimaryTypes optional
Loại:  Array<string> optional
Đã bao gồm Loại địa điểm chính (ví dụ: "nhà hàng" hoặc "gas_station").

Đị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 không có loại nào được chỉ định, hàm sẽ trả về tất cả Loại địa điểm.
includedRegionCodes optional
Loại:  Array<string> optional
Chỉ bao gồm kết quả ở những khu vực được chỉ định, được chỉ định là tối đa 15 mã vùng gồm hai ký tự CLDR. Một tập rỗ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 ở khu vực giao lộ.
inputOffset optional
Loại:  number optional
Độ lệch ký tự Unicode dựa trên 0 của input cho biết vị trí con trỏ trong input. Vị trí con trỏ có thể ảnh hưởng đến những cụm từ gợi ý được trả về. Nếu không được chỉ định, độ dài mặc định là input.
language optional
Loại:  string optional
Ngôn ngữ mà kết quả trả về. Chế độ mặc định sẽ là ngôn ngữ ưu tiên của trình duyệt. Kết quả có thể ở 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.
locationBias optional
Loại:  LocationBias optional
Kết quả sai lệch đến một vị trí được chỉ định.

Bạn phải đặt tối đa một trong số locationBias hoặc locationRestriction. Nếu bạn không đặt biểu tượng nào thì kết quả sẽ bị sai lệch theo địa chỉ IP, nghĩa là địa chỉ IP sẽ được ánh xạ tới một vị trí không chính xác và được dùng làm tín hiệu xu hướng.
locationRestriction optional
Loại:  LocationRestriction optional
Giới hạn kết quả ở một vị trí đã chỉ định.

Bạn phải đặt tối đa một trong số locationBias hoặc locationRestriction. Nếu bạn không đặt biểu tượng nào thì kết quả sẽ bị sai lệch theo địa chỉ IP, nghĩa là địa chỉ IP sẽ được ánh xạ tới một vị trí không chính xác và được dùng làm tín hiệu xu hướng.
origin optional
Loại:  LatLng|LatLngLiteral optional
Điểm gốc để 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, hàm sẽ không trả về khoảng cách trắc địa.
region optional
Loại:  string optional
Mã vùng, được chỉ định dưới dạng mã vùng gồm hai ký tự CLDR. Điều này ảnh hưởng đến việc định dạng địa chỉ, thứ hạng kết quả và có thể ảnh hưởng đến kết quả trả về. Việc này không giới hạn kết quả ở khu vực được chỉ định.
sessionToken optional
Loại:  AutocompleteSessionToken optional
Mã thông báo xác định một 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 qua AutocompleteSessionToken.

Phiên hoạt động bắt đầu khi người dùng bắt đầu nhập cụm từ tìm kiếm và kết thúc khi họ chọn một địa điểm và 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 đăng nhập dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án Google Cloud Console. Sau khi phiên kết thúc, mã thông báo không còn hợp lệ; ứng dụng của bạn phải tạo mã thông báo mới cho mỗi phiên. Nếu thông số sessionToken bị bỏ qua hoặc nếu bạn sử dụng lại mã thông báo phiên, thì phiên sẽ được tính phí như thể không có mã thông báo phiên nào được cung cấp (mỗi yêu cầu sẽ được tính phí riêng).

Bạn nên tuân thủ các nguyên tắc sau:
  • Sử dụng mã thông báo phiên cho tất cả các lệnh gọi Tự động hoàn thành địa điểm.
  • Tạo mã thông báo mới cho mỗi phiên hoạt động.
  • Hãy nhớ truyền một mã thông báo phiên duy nhấ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ẽ bị tính phí riêng.

Lớp AutocompleteSessionToken

Lớp google.maps.places.AutocompleteSessionToken

Đại diện cho mã thông báo phiên được dùng để theo dõi phiên tự động hoàn thành.

Truy cập bằng cách gọi const {AutocompleteSessionToken} = await google.maps.importLibrary("places"). Xem Thư viện trong Maps JavaScript API.
AutocompleteSessionToken
AutocompleteSessionToken()
Thông số: Không có
Tạo một thực thể mới của AutocompleteSessionToken.

Lớp AutocompleteSuggestion

Lớp google.maps.places.AutocompleteSuggestion

Kết quả đề xuất Tự động hoàn thành.

Truy cập bằng cách gọi const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Xem Thư viện trong Maps JavaScript API.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Thông số: 
Giá trị trả về:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
Tìm nạp một danh sách tự động hoàn thành.
placePrediction
Loại:  PlacePrediction optional
Chứa tên mà con người có thể đọc được cho kết quả được trả về. Đối với các kết quả thành lập, thông tin này thường là tên và địa chỉ của doanh nghiệp.

Lớp PlacePrediction

Lớp google.maps.places.PlacePrediction

Kết quả dự đoán cho cụm từ gợi ý của tính năng Tự động hoàn thành địa điểm.

Truy cập bằng cách gọi const {PlacePrediction} = await google.maps.importLibrary("places"). Xem Thư viện trong Maps JavaScript API.
distanceMeters
Loại:  number optional
Chiều dài của đường trắc địa tính bằng mét từ origin nếu origin được chỉ định.
mainText
Loại:  FormattableText optional
Đại diện cho tên của Địa điểm.
placeId
Loại:  string
Giá trị nhận dạng duy nhất của địa điểm được đề xuất. Bạn có thể dùng giá trị nhận dạng này trong những API khác chấp nhận Mã địa điểm.
secondaryText
Loại:  FormattableText optional
Thể hiện các đối tượng địa lý bổ sung dễ phân biệt (chẳng hạn như thành phố hoặc vùng) để xác định thêm Địa điểm.
text
Loại:  FormattableText
Chứa tên mà con người có thể đọc được cho kết quả được trả về. Đối với các kết quả thành lập, thông tin này thường là tên và địa chỉ của doanh nghiệp.

text phù hợp với các nhà phát triển muốn hiển thị một thành phần trên giao diện người dùng. Những nhà phát triển muốn hiển thị hai thành phần giao diện người dùng riêng biệt nhưng có liên quan với nhau nên sử dụng PlacePrediction.mainText và PlacePrediction.secondaryText.
types
Loại:  Array<string>
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 trên https://developers.google.com/maps/documentation/places/web-service/place-types.
toPlace
toPlace()
Thông số: Không có
Giá trị trả về:  Place
Trả về một đại diện Địa điểm của PlaceProjection này. Bạn cần thực hiện lệnh gọi tiếp theo tới Place.fetchFields để xem toàn bộ thông tin chi tiết về địa điểm.

Lớp StringRange

Lớp google.maps.places.StringRange

Xác định chuỗi con trong một văn bản đã cho.

Truy cập bằng cách gọi const {StringRange} = await google.maps.importLibrary("places"). Xem Thư viện trong Maps JavaScript API.
endOffset
Loại:  number
Mức chênh lệch từ 0 của ký tự Unicode cuối cùng của chuỗi con (không bao gồm).
startOffset
Loại:  number
Mức chênh lệch bằng 0 của ký tự Unicode đầu tiên của chuỗi con (bao gồm cả ký tự này).

Lớp FormattableText

Lớp google.maps.places.FormattableText

Văn bản thể hiện thông tin dự đoán về Địa điểm. Văn bản có thể được sử dụng nguyên trạng hoặc định dạng.

Truy cập bằng cách gọi const {FormattableText} = await google.maps.importLibrary("places"). Xem Thư viện trong Maps JavaScript API.
matches
Loại:  Array<StringRange>
Danh sách các dải chuỗi xác định vị trí khớp với yêu cầu đầu vào trong FormattableText.text. Bạn có thể dùng dải ô để định dạng các phần cụ thể của text. Chuỗi con có thể không phải là kết quả khớp chính xác của AutocompleteRequest.input nếu việc khớp được xác định bằng tiêu chí khác ngoài 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 được sắp xếp theo giá trị bù trừ tăng dần.
text
Loại:  string
Văn bản có thể được sử dụng nguyên trạng hoặc định dạng bằng FormattableText.matches.