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 ý 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 Thư viện trong Maps JavaScript API.
AutocompleteService
AutocompleteService()
Tham số:  Không có
Tạo một phiên bản mới của AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Tham số: 
Giá trị trả về:  Promise<AutocompleteResponse>
Truy xuất các cụm từ gợi ý của tính năng 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)
Tham số: 
Giá trị trả về:  Không có
Truy xuất các 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 được cung cấp.

Giao diện AutocompletionRequest

google.maps.places.AutocompletionRequestgiao diện

Yêu cầu Tự động hoàn thành sẽ được gửi đến AutocompleteService.getPlacePredictions.
input
Loại:  string
Chuỗi đầu vào do người dùng nhập.
bounds optional
Các ngưỡng để dự đoán độ lệch. Các 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ế đối với thành phần. Bạn có thể dùng các quy tắc hạn chế thành phần để chỉ giới hạn những dự đoá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ể). 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ị 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í để điều chỉnh độ lệch dự đoán. Các 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
Một 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
Ranh giới để hạn chế kết quả tìm kiếm.
offset optional
Loại:  number optional
Vị trí ký tự trong cụm từ tìm kiếm 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 để điều chỉnh dự đoán. 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ả. Chế độ này không giới hạn các đề xuất ở quốc gia này. Mã khu vực chấp nhận giá trị gồm 2 ký tự ccTLD ("miền cấp cao nhất"). Hầu hết mã ccTLD đều giống với mã ISO 3166-1, ngoại trừ một số trường hợp đáng chú ý. Ví dụ: ccTLD 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 là cho thực thể "Vương quốc Anh và Bắc Ireland").
sessionToken optional
Loại:  AutocompleteSessionToken optional
Giá trị tham chiếu duy nhất 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 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, thì tất cả các loại sẽ được trả về.

Giao diện AutocompleteResponse

google.maps.places.AutocompleteResponsegiao diện

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

Giao diện QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequestgiao diện

Yêu cầu QueryAutocompletion sẽ được gửi đến QueryAutocompleteService.
input
Loại:  string
Chuỗi đầu vào do người dùng nhập.
bounds optional
Các ngưỡng để dự đoán độ lệch. Các 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í để điều chỉnh độ lệch dự đoán. Các 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ừ tìm kiếm 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 để điều chỉnh dự đoán. 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

google.maps.places.ComponentRestrictionsgiao diện

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
Giới hạn kết quả 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 hoặc một mảng gồm tối đa 5 chuỗi mã quốc gia.

Giao diện AutocompletePrediction

google.maps.places.AutocompletePredictiongiao diện

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 được định dạng của cụm từ tìm kiếm do dịch vụ Places đề 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 độ lệch và độ dài, được biểu thị bằng các ký tự unicode.
place_id
Loại:  string
Một 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 khớp với nội dung đầu vào tự động hoàn thành, được xác định bằng độ lệch và độ dài, thể hiện bằng các 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 mà cụm từ gợi ý 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) từ địa điểm đến AutocompletionRequest.origin.

Giao diện QueryAutocompletePrediction

google.maps.places.QueryAutocompletePredictiongiao diện

Đạ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 được định dạng của cụm từ tìm kiếm do dịch vụ Places đề 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 độ lệch và độ dài, được biểu thị bằng các 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 sẽ xuất hiện trước (ví dụ: "nhà hàng"). Các cụm từ về địa chỉ xuất hiện 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 cụm từ gợi ý là một địa điểm. Một 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

google.maps.places.PredictionTermgiao diện

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

Giao diện PredictionSubstring

google.maps.places.PredictionSubstringgiao diện

Đạ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
Độ lệch đến vị trí bắt đầu của chuỗi con trong chuỗi nội dung mô tả.

Giao diện StructuredFormatting

google.maps.places.StructuredFormattinggiao diện

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 trùng khớp từ dữ liệu đầu vào của tính năng tự động hoàn thành, được xác định bằng độ lệch và độ dài, thể hiện bằng các ký tự unicode.
main_text
Loại:  string
Đây là phần văn bản chính trong nội dung mô tả chưa được định dạng của địa điểm do dịch vụ Places đề 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 độ lệch và độ 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ụ trong nội dung mô tả chưa được định dạng của địa điểm do dịch vụ Places đề xuất. Thường là vị trí của địa điểm.