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

Truy cập bằng cách gọi const {AutocompleteService} = await google.maps.importLibrary("places"). Xem phần Thư viện trong API Maps JavaScript.
AutocompleteService
AutocompleteService()
Thông số:  Không có
Tạo một thực thể mới của AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Thông số: 
Giá trị trả về:  Promise<AutocompleteResponse>
Truy xuất nội dung gợi ý tự động hoàn thành địa điểm dựa trên yêu cầu tự động hoàn thành đã cung cấp.
getQueryPredictions
getQueryPredictions(request, callback)
Thông số: 
Giá trị trả về:  Không có
Truy xuất cụm từ gợi ý của tính năng tự động hoàn thành cụm từ tìm kiếm dựa trên yêu cầu tự động hoàn thành cụm từ tìm kiếm đã 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 đầu vào.
bounds optional
Giới hạn cho độ lệch của dự đoán. Dự đoán sẽ thiên về, nhưng không giới hạn ở, bounds đã cho. Cả location và radius sẽ bị bỏ qua nếu bạn đặt bounds.
componentRestrictions optional
Loại:  ComponentRestrictions optional
Các quy định hạn chế về thành phần. Các quy tắc hạn chế thành phần được dùng để chỉ cho phép dự đoán 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ữ cho ngôn ngữ mà kết quả sẽ được trả về (nếu có thể). Các kết quả bằng ngôn ngữ đã chọn có thể được xếp hạng cao hơn, nhưng nội dung đề xuất không chỉ giới hạn ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ.
location optional
Loại:  LatLng optional
Vị trí để tạo độ lệch dự đoán. Kết quả dự đoán sẽ thiên về location và radius đã cho. Ngoài ra, bạn có thể sử dụng bounds.
locationBias optional
Loại:  LocationBias optional
Ranh giới mềm hoặc gợi ý để sử dụng khi tìm kiếm địa điểm.
locationRestriction optional
Loại:  LocationRestriction optional
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 cụm từ đầu vào 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).
origin optional
Loại:  LatLng|LatLngLiteral optional
Vị trí mà AutocompletePrediction.distance_meters được tính toán.
radius optional
Loại:  number optional
Bán kính của khu vực dùng để dự đoán độ lệch. 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ã khu vực dùng để định dạng kết quả và lọc kết quả. Điều này không giới hạn nội dung đề xuất ở quốc gia này. Mã khu vực chấp nhận giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD giống với mã ISO 3166-1, ngoại trừ một số trường hợp ngoại lệ đáng chú ý. Ví dụ: ccTLD của Vương quốc Anh là "uk" (.co.uk) trong khi mã ISO 3166-1 là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Anh và Bắc Ireland").
sessionToken optional
Loại:  AutocompleteSessionToken optional
Tham chiếu duy nhất dùng để gói các yêu cầu riêng lẻ thành phiên.
types optional
Loại:  Array<string> optional
Các loại dự đoán 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 bạn không chỉ định loại nào, tất cả các loại sẽ được trả về.

Giao diện AutocompleteResponse

Giao diện google.maps.places.AutocompleteResponse

Phản hồi Tự động hoàn thành do lệnh gọi đến AutocompleteService.getPlacePredictions trả về, trong đó 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 QueryAutocompletion sẽ được gửi đến QueryAutocompleteService.
input
Loại:  string
Người dùng đã nhập chuỗi đầu vào.
bounds optional
Giới hạn cho độ lệch của dự đoán. Dự đoán sẽ thiên về, nhưng không giới hạn ở, bounds đã cho. Cả location và radius sẽ bị bỏ qua nếu bạn đặt bounds.
location optional
Loại:  LatLng optional
Vị trí để tạo độ lệch dự đoán. Kết quả dự đoán sẽ thiên về 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 cụm từ đầu vào 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).
radius optional
Loại:  number optional
Bán kính của khu vực dùng để dự đoán độ lệch. 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.

Giao diện ComponentRestrictions

Giao diện google.maps.places.ComponentRestrictions

Xác định cá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ế nội dung dự đoán ở quốc gia được chỉ định (mã quốc gia theo chuẩn 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 mã hoặc một mảng gồm tối đa 5 chuỗi mã quốc gia.

Giao diện AutocompletePrediction

Giao diện google.maps.places.AutocompletePrediction

Biểu thị một cụm từ gợi ý của tính năng tự động hoàn thành.
description
Loại:  string
Đây là phiên bản chưa định dạng của truy vấn do dịch vụ Địa điểm đề xuất.
matched_substrings
Một tập hợp các chuỗi con trong nội dung mô tả của địa điểm khớp với các phần tử trong dữ liệu đầu vào của người dùng, phù hợp để sử dụng trong việc làm nổi bật các chuỗi con đó. Mỗi chuỗi con được xác định bằng một độ dời và một độ dài, được biểu thị bằng ký tự unicode.
place_id
Loại:  string
Mã địa điểm có thể dùng để truy xuất 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ả của đị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 các chuỗi con được so khớp từ dữ liệu đầu vào tự động hoàn thành, được xác định bằng độ dời và độ dài, được biểu thị bằng ký tự Unicode.
terms
Thông tin về từng thuật ngữ trong nội dung mô tả ở trên, từ cụ thể nhất đến ít cụ thể nhất. Ví dụ: "Taco Bell", "Willitis" và "CA".
types
Loại:  Array<string>
Một mảng các loại thuộc tính mà nội dung dự đoán thuộc về, 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

Giao diện google.maps.places.QueryAutocompletePrediction

Đại diện cho một cụm từ gợi ý của tính năng Tự động hoàn thành cụm từ tìm kiếm.
description
Loại:  string
Đây là phiên bản chưa định dạng của truy vấn do dịch vụ Địa điểm đề xuất.
matched_substrings
Một tập hợp các chuỗi con trong nội dung mô tả của địa điểm khớp với các phần tử trong dữ liệu đầu vào của người dùng, phù hợp để sử dụng trong việc làm nổi bật các chuỗi con đó. Mỗi chuỗi con được xác định bằng một độ dời và một độ dài, được biểu thị bằng ký tự unicode.
terms
Thông tin về từng thuật ngữ trong nội dung mô tả ở trên. Các cụm từ theo danh mục được đặt trước (ví dụ: "nhà hàng"). Các 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ỉ có sẵn nếu nội dung dự đoán là một địa điểm. Mã địa điểm có thể dùng để truy xuất 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

Biểu thị một thuật toán dự đoán.
offset
Loại:  number
Độ dời, tính bằng ký tự Unicode, của vị trí bắt đầu của cụm từ này trong nội dung mô tả địa điểm.
value
Loại:  string
Giá trị của cụm từ này, ví dụ: "Taco Bell".

Giao diện PredictionSubstring

Giao diện google.maps.places.PredictionSubstring

Biểu thị một chuỗi con dự đoán.
length
Loại:  number
Độ dài của chuỗi con.
offset
Loại:  number
Độ dời đến vị trí bắt đầ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ả của đị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 các chuỗi con được so khớp từ dữ liệu đầu vào tự động hoàn thành, được xác định bằng độ dời 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 nội dung mô tả chưa định dạng về địa điểm do dịch vụ Địa điểm đề xuất. Thường là tên của địa điểm.
main_text_matched_substrings
Một tập hợp các chuỗi con trong văn bản chính khớp với các phần tử trong dữ liệu đầu vào của người dùng, phù hợp để sử dụng trong việc làm nổi bật các chuỗi con đó. Mỗi chuỗi con được xác định bằng một độ dời và một độ dài, được biểu thị bằng ký tự unicode.
secondary_text
Loại:  string
Đây là phần văn bản phụ của nội dung mô tả chưa định dạng về địa điểm do dịch vụ Địa điểm đề xuất. Thường là vị trí của địa điểm.