Places Autocomplete Service

Lớp AutocompleteService

Lớp google.maps.places.AutocompleteService

Chứa các phương thức liên quan đến việc truy xuất cụm từ gợi ý Tự động hoàn thành.

Truy cập bằng cách gọi const {AutocompleteService} = await google.maps.importLibrary("places"). Xem Thư viện trong API JavaScript Maps.
AutocompleteService
AutocompleteService()
Tham số: Không có
Tạo một thực thể mới của AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Các thông số: 
  • request:  AutocompletionRequest Yêu cầu tự động hoàn thành.
  • callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional Một lệnh gọi lại chấp nhận một mảng các đối tượng Dự đoán tự động hoàn thành và một giá trị PlacesServiceStatus làm đối số.
Giá trị trả về:  Promise<AutocompleteResponse>
Truy xuất các đề xuất tự động hoàn thành địa điểm dựa trên yêu cầu tự động hoàn thành được cung cấp.
getQueryPredictions
getQueryPredictions(request, callback)
Các thông số: 
Giá trị trả lại hàng: Không có
Truy xuất các cụm từ gợi ý tự động hoàn thành truy vấn dựa trên yêu cầu tự động hoàn thành truy vấn đã cung cấp.

Giao diện AutocompletionRequest

Giao diện google.maps.places.AutocompletionRequest

Yêu cầu tự động hoàn thành sẽ được gửi đến AutocompleteService.getPlacePredictions.
input
Loại:  string
Người dùng đã nhập chuỗi dữ liệu đầu vào.
bounds optional
Giới hạn cho xu hướng dự đoán. Thông tin dự đoán sẽ được thiên vị, nhưng không giới hạn ở bounds đã cho. Cả location và radius đều sẽ bị bỏ qua nếu bạn đặt bounds.
componentRestrictions optional
Loại:  ComponentRestrictions optional
Các hạn chế về thành phần. Các hạn chế về thành phần dùng để hạn chế các cụm từ gợi ý chỉ ở những thành phần trong thành phần mẹ. Ví dụ: quốc gia.
language optional
Loại:  string optional
Giá trị nhận dạng ngôn ngữ của ngôn ngữ mà kết quả trả về, nếu có thể. Kết quả bằng ngôn ngữ đã chọn có thể được xếp hạng cao hơn, nhưng các đề xuất không bị hạn chế ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ.
location optional
Loại:  LatLng optional
Vị trí cho xu hướng dự đoán. Thông tin dự đoán sẽ sai lệch so với location và radius đã cho. Ngoài ra, bạn có thể sử dụng bounds.
locationBias optional
Loại:  LocationBias optional
Ranh giới hoặc gợi ý mềm để sử dụng khi tìm kiếm địa điểm.
locationRestriction optional
Loại:  LocationRestriction optional
Các giới hạn để ràng buộc kết quả tìm kiếm.
offset optional
Loại:  number optional
Vị trí ký tự trong thuật ngữ nhập mà dịch vụ sử dụng văn bản để dự đoán (vị trí của con trỏ trong trường nhập dữ liệu).
origin optional
Loại:  LatLng|LatLngLiteral optional
Vị trí tính AutocompletePrediction.distance_meters.
radius optional
Loại:  number optional
Bán kính của khu vực được dùng để dự đoán xu hướng. radius được chỉ định bằng mét và phải luôn đi kèm với thuộc tính location. Ngoài ra, bạn có thể sử dụng bounds.
region optional
Loại:  string optional
Mã vùng được dùng để định dạng và lọc kết quả. Không hạn chế đề xuất cho quốc gia này. Mã vùng chấp nhận giá trị hai ký tự của ccTLD ("miền cấp cao nhất"). Hầu hết các mã ccTLD (miền cấp cao nhất theo mã quốc gia) đều giống với mã ISO 3166-1, trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD (miền cấp cao nhất theo mã quốc gia) của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 của quốc gia này là "gb" (về mặt kỹ thuật, tên này là "Vương quốc Anh và Bắc Ireland").
sessionToken optional
Loại:  AutocompleteSessionToken optional
Tệp đối chiếu duy nhất được dùng để nhóm các yêu cầu riêng lẻ thành các phiên.
types optional
Loại:  Array<string> optional
Các loại cụm từ gợi ý sẽ được trả về. Để biết các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, thì hàm sẽ trả về tất cả các loại.

Giao diện AutocompleteResponse (Tự động hoàn thành)

Giao diện google.maps.places.AutocompleteResponse

Một phản hồi Tự động hoàn thành được lệnh gọi đến AutocompleteService.getPlacePredictions trả về, có chứa danh sách AutocompletePrediction.
predictions
Danh sách AutocompletePrediction.

Giao diện QueryAutocompletionRequest

Giao diện google.maps.places.QueryAutocompletionRequest

Yêu cầu tự động hoàn thành Truy vấn sẽ được gửi đến QueryAutocompleteService.
input
Loại:  string
Người dùng đã nhập chuỗi dữ liệu đầu vào.
bounds optional
Giới hạn cho xu hướng dự đoán. Thông tin dự đoán sẽ được thiên vị, nhưng không giới hạn ở bounds đã cho. Cả location và radius đều sẽ bị bỏ qua nếu bạn đặt bounds.
location optional
Loại:  LatLng optional
Vị trí cho xu hướng dự đoán. Thông tin dự đoán sẽ sai lệch so với location và radius đã cho. Ngoài ra, bạn có thể sử dụng bounds.
offset optional
Loại:  number optional
Vị trí ký tự trong thuật ngữ nhập mà dịch vụ sử dụng văn bản để dự đoán (vị trí của con trỏ trong trường nhập dữ liệu).
radius optional
Loại:  number optional
Bán kính của khu vực được dùng để dự đoán xu hướng. radius được chỉ định bằng mét và phải luôn đi kèm với thuộc tính location. Ngoài ra, bạn có thể sử dụng bounds.

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, có thể là một chuỗi các lệnh gọi AutocompleteService.getPlacePredictions, sau đó là một lệnh gọi PlacesService.getDetails.

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

Giao diện ComponentRestrictions (Hạn chế)

Giao diện google.maps.places.ComponentRestrictions

Xác định các quy tắc hạn chế về thành phần có thể dùng với dịch vụ tự động hoàn thành.
country optional
Loại:  string|Array<string> optional
Hạn chế dự đoán ở quốc gia được chỉ định (mã quốc gia ISO 3166-1 Alpha-2, không phân biệt chữ hoa chữ thường). Ví dụ: 'us', 'br' hoặc 'au'. Bạn có thể cung cấp một chuỗi duy nhất hoặc một mảng gồm tối đa năm chuỗi mã quốc gia.

Giao diện AutocompletePrediction

Giao diện google.maps.places.AutocompletePrediction

Đại diện cho một cụm từ gợi ý tự động hoàn thành.
description
Loại:  string
Đây là phiên bản chưa được định dạng của truy vấn được dịch vụ Địa điểm đề xuất.
matched_substrings
Một tập hợp chuỗi con trong phần mô tả về địa điểm khớp với các phần tử trong thông tin mà người dùng nhập, phù hợp để sử dụng để làm nổi bật các chuỗi con đó. Mỗi chuỗi con được xác định bằng một độ lệch và một độ dài, được biểu thị bằng các ký tự unicode.
place_id
Loại:  string
Mã địa điểm có thể dùng để lấy thông tin chi tiết về địa điểm này bằng dịch vụ thông tin chi tiết về địa điểm (xem PlacesService.getDetails).
structured_formatting
Thông tin có cấu trúc về nội dung mô tả địa điểm, được chia thành một văn bản chính và một văn bản phụ, bao gồm một mảng chuỗi con trùng khớp với thông tin được nhập vào tự động hoàn thành. Các thông tin này được xác định bằng độ lệch và độ dài, được biểu thị bằng các ký tự unicode.
terms
Thông tin về từng cụm từ trong nội dung mô tả ở trên, từ cụ thể nhất đến ít cụ thể nhất. Ví dụ: "Taco Bell", "Will xóa" và "CA".
types
Loại:  Array<string>
Một mảng các loại chứa cụm từ gợi ý, ví dụ: 'establishment' hoặc 'geocode'.
distance_meters optional
Loại:  number optional
Khoảng cách tính bằng mét của địa điểm từ AutocompletionRequest.origin.

Giao diện QueryAutocompletePrediction (Dự đoán tự động hoàn thành truy vấn)

Giao diện google.maps.places.QueryAutocompletePrediction

Đại diện cho một dự đoán Tự động hoàn thành truy vấn.
description
Loại:  string
Đây là phiên bản chưa được định dạng của truy vấn được dịch vụ Địa điểm đề xuất.
matched_substrings
Một tập hợp chuỗi con trong phần mô tả về địa điểm khớp với các phần tử trong thông tin mà người dùng nhập, phù hợp để sử dụng để làm nổi bật các chuỗi con đó. Mỗi chuỗi con được xác định bằng một độ lệch và một độ dài, được biểu thị bằng các ký tự unicode.
terms
Thông tin về từng cụm từ trong phần mô tả ở trên. Các cụm từ mang tính chất tuyệt đối được ưu tiên hàng đầu (ví dụ: "nhà hàng"). Cụm từ địa chỉ xuất hiện theo thứ tự từ cụ thể nhất đến ít cụ thể nhất. Ví dụ: "San Francisco" và "CA".
place_id optional
Loại:  string optional
Chỉ khả dụng nếu cụm từ gợi ý là một địa điểm. Mã địa điểm có thể dùng để lấy thông tin chi tiết về địa điểm này bằng dịch vụ thông tin chi tiết về địa điểm (xem PlacesService.getDetails).

Giao diện PredictionTerm

Giao diện google.maps.places.PredictionTerm

Đại diện cho cụm từ dự đoán.
offset
Loại:  number
Độ lệch, bằng các ký tự unicode, của đầu cụm từ này trong nội dung mô tả về địa điểm.
value
Loại:  string
Giá trị của từ khoá này (ví dụ: "Taco Bell").

Giao diện PredictionSubstring

Giao diện google.maps.places.PredictionSubstring

Đại diện cho một chuỗi con dự đoán.
length
Loại:  number
Độ dài của chuỗi con.
offset
Loại:  number
Giá trị bù trừ cho phần đầu của chuỗi con trong chuỗi mô tả.

Giao diện StructuredFormatting

Giao diện google.maps.places.StructuredFormatting

Chứa thông tin có cấu trúc về nội dung mô tả địa điểm, được chia thành văn bản chính và văn bản phụ, bao gồm một mảng chuỗi con trùng khớp từ thông tin nhập tự động hoàn thành. Các chuỗi con này được xác định bằng độ lệch và độ dài, được biểu thị bằng ký tự unicode.
main_text
Loại:  string
Đây là phần văn bản chính của mô tả chưa được định dạng về địa điểm được dịch vụ Địa điểm đề xuất. Thường là tên của địa điểm.
main_text_matched_substrings
Tập hợp chuỗi con trong văn bản chính khớp với các phần tử trong nội dung mà người dùng nhập, phù hợp để sử dụng để làm nổi bật các chuỗi con đó. Mỗi chuỗi con được xác định bằng một độ lệch và một độ dài, được biểu thị bằng các ký tự unicode.
secondary_text
Loại:  string
Đây là phần văn bản phụ của mô tả chưa được định dạng về địa điểm được dịch vụ Địa điểm đề xuất. Thường là vị trí của địa điểm.