Autocomplete Data (new)

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

Phương thức tĩnh

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Tham số:  autocompleteRequest:  AutocompleteRequest Giá trị trả về:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Tìm nạp danh sách AutocompleteSuggestions. Nếu AutocompleteRequest.sessionToken được cung cấp trong yêu cầu, thì mã thông báo phiên đó sẽ tự động được đưa vào khi gọi Place.fetchFields lần đầu tiên, trên mỗi Place do PlacePrediction.toPlace trả về trên PlacePredictions kết quả.

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ở, đây thường là tên và địa chỉ của 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 một lệnh gọi đến PlacePrediction.toPlace trả về.

Giao diện AutocompleteRequest

google.maps.places.AutocompleteRequestgiao diện

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 "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ề.
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 tối đa 15 mã khu vực gồm 2 ký tự theo quy ước của 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 vùng giao nhau.
inputOffset optional	Loại:  number optional Độ lệch ký tự Unicode dựa trên mốc 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 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 của input.
language optional	Loại:  string optional Ngôn ngữ mà bạn muốn nhận 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ể bằng nhiều ngôn ngữ nếu ngôn ngữ được 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 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ẽ bị ảnh hưởng bởi đị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 ảnh hưởng.
locationRestriction optional	Loại:  LocationRestriction optional 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ẽ bị ảnh hưởng bởi đị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 ảnh hưởng.
origin optional	Loại:  LatLng|LatLngLiteral optional Điểm xuất phát để tính khoảng cách trắc địa đến đích đến (trả về dưới dạng PlacePrediction.distanceMeters). Nếu bạn bỏ qua giá trị này, khoảng cách trắc địa 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 CLDR gồm 2 ký tự. Đ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 những kết quả được trả về. Thao tá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 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, sau đó là một lệnh gọi fetchFields. Thông tin đăng nhập đượ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ệ; ứ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ã thông báo phiên, thì phiên sẽ bị tính phí như thể bạn không cung cấp mã thông báo phiên (mỗi yêu cầu sẽ được tính phí riêng). Khi mã thông báo phiên được cung cấp trong yêu cầu đến AutocompleteSuggestion.fetchAutocompleteSuggestions, mã thông báo đó sẽ tự động được đưa vào lệnh gọi đầu tiên đến fetchFields trên một Place do lệnh gọi PlacePrediction.toPlace trả về 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ả các lệnh gọi Place Autocomplete. Tạo một 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. Nếu bạn 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.

Lớp AutocompleteSessionToken

Lớp google.maps.places.AutocompleteSessionToken

Biểu thị một 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 Thư viện trong Maps JavaScript API.

Hàm dựng
AutocompleteSessionToken	AutocompleteSessionToken() Tham số:  Không có Tạo một phiên bản mới của AutocompleteSessionToken.

Lớp PlacePrediction

Lớp google.maps.places.PlacePrediction

Kết quả dự đoán cho một 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 bạn chỉ định origin.
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 riêng biệt của Địa điểm được đề xuất. Bạn có thể 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 bổ sung giúp phân biệt (chẳng hạn như thành phố hoặc khu vực) để 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 kết quả về cơ sở, đây thường là tên và địa chỉ của doanh nghiệp. text là lựa chọn nên dùng cho những nhà phát triển muốn hiển thị một thành phần duy nhất trên giao diện người dùng. Những nhà phát triển muốn hiển thị 2 phần tử riêng biệt nhưng có liên quan trên giao diện người dùng có thể muố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 tại https://developers.google.com/maps/documentation/places/web-service/place-types.

Phương thức
fetchAddressValidation	Lưu ý: Chỉ có trong kênh v=beta. fetchAddressValidation(request) Tham số:  request:  AddressValidationRequest Giá trị trả về:  Không có Gửi một yêu cầu Xác thực địa chỉ được liên kết với phiên tự động hoàn thành này (nội bộ điền sẵn yêu cầu bằng mã thông báo phiên tự động hoàn thành). Không có thông tin nào về địa điểm từ PlacePrediction được tự động đưa vào – đây là một phương thức thuận tiện giúp quản lý phiên tự động hoàn thành.
toPlace	toPlace() Tham số:  Không có Giá trị trả về:  Place Trả về một Place biểu thị PlacePrediction này. Bạn cần gọi Place.fetchFields sau đó để nhận được thông tin chi tiết đầy đủ về Địa điểm. Nếu AutocompleteRequest.sessionToken được cung cấp trong AutocompleteRequest dùng để tìm nạp PlacePrediction này, thì mã thông báo tương tự sẽ tự động được đưa vào khi gọi fetchFields. Ngoài ra, khi sử dụng PlaceAutocompleteElement, lệnh gọi đầu tiên đến Place.fetchFields trên Place do PlacePrediction.toPlace trả về sẽ tự động bao gồm mã thông báo phiên.

Lớp StringRange

Lớp google.maps.places.StringRange

Xác định một 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 Độ lệch dựa trên 0 của ký tự Unicode cuối cùng trong chuỗi con (loại trừ).
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).

Lớp FormattableText

Lớp google.maps.places.FormattableText

Văn bản đại diện cho một đề xuất về Địa điểm. Bạn có thể sử dụng văn bản nguyên trạng hoặc định dạng văn bản.

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> Một danh sách các dải ô chuỗi xác định vị trí mà yêu cầu đầu vào khớp trong FormattableText.text. Bạn có thể dùng các dải ô này để định dạng các phần cụ thể của text. Các chuỗi con có thể không khớp chính xác với AutocompleteRequest.input nếu tiêu chí khớp không phải là tiêu chí khớp chuỗi (ví dụ: sửa lỗi chính tả hoặc chuyển tự). Đây là các giá trị bù ký tự Unicode của FormattableText.text. Các dải này được đảm bảo sắp xếp theo thứ tự tăng dần của các giá trị khoảng cá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.