Autocomplete Data (new)

Giao diện AutocompleteRequest

Giao diện google.maps.places.AutocompleteRequest

Yêu cầu giao diện cho AutocompleteSuggestion.fetchAutocompleteSuggestions.

Thuộc tính
input	Loại:  string Chuỗi văn bản cần tìm kiếm.
includedPrimaryTypes optional	Loại:  Array<string> optional Đã thêm Loại địa điểm chính (ví dụ: "nhà_hàng" hoặc "trạm_xăng"). Hệ thống chỉ trả về Địa điểm 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, hệ thống sẽ trả về tất cả các loại Địa điểm.
includedRegionCodes optional	Loại:  Array<string> optional Chỉ bao gồm kết quả ở các khu vực được chỉ định, được chỉ định dưới dạng tối đa 15 mã khu vực gồm hai ký tự theo quy ước của CLDR. 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 vùng giao nhau.
inputOffset optional	Loại:  number optional Độ dời 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 nội dung dự đoán được trả về. Nếu không được chỉ định, giá trị mặc định sẽ là độ dài input.
language optional	Loại:  string optional Ngôn ngữ dùng để trả về kết quả. Sẽ được đặt mặc định theo lựa chọn 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 Chuyển hướng kết quả đến một vị trí đã chỉ định. 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 giá trị cho cả hai, thì kết quả sẽ bị thiên lệch theo địa chỉ IP, tức 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 lệch.
locationRestriction optional	Loại:  LocationRestriction optional Hạn chế 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 giá trị cho cả hai, thì kết quả sẽ bị thiên lệch theo địa chỉ IP, tức 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 lệch.
origin optional	Loại:  LatLng|LatLngLiteral optional Điểm gốc để tính toán khoảng cách geodesic đến đích (được trả về dưới dạng PlacePrediction.distanceMeters). Nếu bạn bỏ qua giá trị này, thì khoảng cách geodesic sẽ không được trả về.
region optional	Loại:  string optional Mã vùng, được chỉ định dưới dạng mã vùng gồm hai ký tự theo CLDR. Điều này ảnh hưởng đến cách định dạng địa chỉ, thứ hạng kết quả và có thể ảnh hưởng đến kết quả được trả về. Việc này không giới hạn kết quả ở khu vự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 thông qua AutocompleteSessionToken. Phiên bắt đầu khi người dùng bắt đầu nhập truy vấn 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 xác thực dùng cho mỗi yêu cầu trong một phiên phải thuộc cùng một dự án trên Google Cloud Console. Sau khi một phiên kết thúc, mã thông báo sẽ không còn hợp lệ nữa; ứ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 thông số sessionToken hoặc sử dụng lại mã thông báo phiên, thì phiên sẽ bị 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 được tính phí riêng). 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 Tự động hoàn thành địa điểm. 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 duy nhất cho mỗi phiên mới. Việc sử dụng cùng một mã thông báo cho nhiều phiên sẽ khiến mỗi yêu cầu được tính phí riêng lẻ.

Lớp AutocompleteSessionToken

Lớp google.maps.places.AutocompleteSessionToken

Đại diện cho mã thông báo phiên dùng để theo dõi một 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 phần Thư viện trong API Maps JavaScript.

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 của tính năng Tự động hoàn thành.

Truy cập bằng cách gọi const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Xem phần Thư viện trong API Maps JavaScript.

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 danh sách AutocompleteSuggestions.

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 kết quả về cơ sở lưu trú, đây thường là tên và địa chỉ của cơ sở lưu trú.

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 phần Thư viện trong API Maps JavaScript.

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 Biểu thị 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ể 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.
secondaryText	Loại:  FormattableText optional Biểu thị các đặc điểm khác giúp phân biệt (chẳng hạn như thành phố hoặc khu vực) để xác định rõ hơn Đị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 kết quả về cơ sở lưu trú, đây thường là tên và địa chỉ của cơ sở lưu trú. text được đề xuất cho những 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à phát triển muốn hiển thị hai thành phần trên giao diện người dùng riêng biệt nhưng có liên quan với nhau có thể 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 tại 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 Place đại diện cho PlacePrediction này. Bạn cần thực hiện một lệnh gọi tiếp theo đến Place.fetchFields để nhận thông tin chi tiết đầy đủ về Địa điểm.

Lớp StringRange

Lớp google.maps.places.StringRange

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

Truy cập bằng cách gọi const {StringRange} = await google.maps.importLibrary("places"). Xem phần Thư viện trong API Maps JavaScript.

Thuộc tính
endOffset	Loại:  number Độ dời dựa trên 0 của ký tự Unicode cuối cùng của chuỗi con (không bao gồm).
startOffset	Loại:  number Độ lệch dựa trên 0 của ký tự Unicode đầu tiên trong chuỗi con (bao gồm cả ký tự đó).

Lớp FormattableText

Lớp google.maps.places.FormattableText

Văn bản đại diện cho một cụm từ gợi ý về Địa điểm. Bạn có thể sử dụng văn bản 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 phần Thư viện trong API Maps JavaScript.

Thuộc tính
matches	Loại:  Array<StringRange> 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 việc so khớp được xác định theo các 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 phiên âm). Các giá trị này là độ dời ký tự Unicode của FormattableText.text. Các dải ô được đảm bảo được sắp xếp theo thứ tự tăng dần của giá trị chênh lệch.
text	Loại:  string Văn bản có thể được sử dụng nguyên trạng hoặc được định dạng bằng FormattableText.matches.