Autocomplete Data (new)

Giao diện AutocompleteRequest

Giao diện google.maps.places.AutocompleteRequest

Giao diện yêu cầu cho AutocompleteSuggestion.fetchAutocompleteSuggestions.

Thuộc tính
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.

Hàm dựng
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.

Phương thức tĩnh
fetchAutocompleteSuggestions	fetchAutocompleteSuggestions(autocompleteRequest) Thông số:  autocompleteRequest:  AutocompleteRequest Giá trị trả về:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Tìm nạp một danh sách tự động hoàn thành.

Thuộc tí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.

Thuộc tính
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.

Phương thức
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.

Thuộc tính
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.

Thuộc tính
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.