Lớp AutocompleteService
lớp
google.maps.places.AutocompleteService
thư viện "places"
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.
const {AutocompleteService} = await google.maps.importLibrary("places");
Hàm dựng | |
|---|---|
AutocompleteService |
AutocompleteService()Tham số: Không có
Tạo một thực thể mới của AutocompleteService. |
Phương thức | |
|---|---|
getPlacePredictions |
getPlacePredictions(request[, callback])Tham số:
Giá trị trả về:
Promise<AutocompleteResponse>Truy xuất 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ụ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
giao diện
google.maps.places.AutocompletionRequest
Yêu cầu Tự động hoàn thành sẽ được gửi đến AutocompleteService.getPlacePredictions.
Thuộc tính | |
|---|---|
input |
Loại:
stringChuỗi đầu vào do người dùng nhập. |
không bắt buộc |
Loại:
LatLngBounds|LatLngBoundsLiteral optionalGiới hạn cho độ lệch của dự đoán. Các cụm từ gợi ý sẽ thiên về bounds đã cho, nhưng không chỉ giới hạn ở đó. Cả location và radius sẽ bị bỏ qua nếu bạn đặt bounds. |
componentRestrictions
không bắt buộc |
Loại:
ComponentRestrictions optionalCác quy định hạn chế đối với thành phần. Các quy định hạn chế về thành phần được dùng để chỉ đưa ra kết quả dự đoán trong thành phần mẹ. Ví dụ: quốc gia. |
language
không bắt buộc |
Loại:
string optionalGiá 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 chỉ giới hạn ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ. |
không bắt buộc |
Loại:
LatLng optionalVị trí để thiên vị dự đoán. Nội dung dự đoán sẽ thiên về location và radius đã cho. Ngoài ra, bạn có thể sử dụng bounds. |
locationBias
không bắt buộc |
Loại:
LocationBias optionalMột ranh giới hoặc gợi ý không bắt buộc để sử dụng khi tìm kiếm địa điểm. |
locationRestriction
không bắt buộc |
Loại:
LocationRestriction optionalRanh giới để ràng buộc kết quả tìm kiếm. |
offset
không bắt buộc |
Loại:
number optionalVị trí ký tự trong cụm từ nhập vào mà dịch vụ sử dụng văn bản để đưa ra cụm từ gợi ý (vị trí của con trỏ trong trường nhập dữ liệu). |
origin
không bắt buộc |
Loại:
LatLng|LatLngLiteral optionalVị trí dùng để tính AutocompletePrediction.distance_meters. |
không bắt buộc |
Loại:
number optionalBán kính của khu vực dùng để thiên vị 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
không bắt buộc |
Loại:
string optionalMã vùng dùng để định dạng và lọc kết quả. Tham số này không hạn chế các đề xuất cho 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 các mã ccTLD đều 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 của quốc gia này là "gb" (về mặt kỹ thuật là cho thực thể "Vương quốc Liên hiệp Anh và Bắc Ireland"). |
sessionToken
không bắt buộc |
Loại:
AutocompleteSessionToken optionalGiá trị tham chiếu duy nhất dùng để gộp các yêu cầu riêng lẻ thành phiên. |
types
không bắt buộc |
Loại:
Array<string> optionalLoại cụm từ gợi ý cần 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
giao diện
google.maps.places.AutocompleteResponse
Phản hồi của tính năng Tự động hoàn thành do lệnh gọi đến AutocompleteService.getPlacePredictions trả về, chứa danh sách AutocompletePrediction.
Thuộc tính | |
|---|---|
predictions |
Loại:
Array<AutocompletePrediction>Danh sách AutocompletePrediction. |
Giao diện QueryAutocompletionRequest
giao diện
google.maps.places.QueryAutocompletionRequest
Yêu cầu QueryAutocompletion được gửi đến QueryAutocompleteService.
Thuộc tính | |
|---|---|
input |
Loại:
stringChuỗi đầu vào do người dùng nhập. |
bounds
không bắt buộc |
Loại:
LatLngBounds|LatLngBoundsLiteral optionalGiới hạn cho độ lệch của dự đoán. Các cụm từ gợi ý sẽ thiên về bounds đã cho, nhưng không chỉ giới hạn ở đó. Cả location và radius sẽ bị bỏ qua nếu bạn đặt bounds. |
location
không bắt buộc |
Loại:
LatLng optionalVị trí để thiên vị dự đoán. Nội dung dự đoán sẽ thiên về location và radius đã cho. Ngoài ra, bạn có thể sử dụng bounds. |
offset
không bắt buộc |
Loại:
number optionalVị trí ký tự trong cụm từ nhập vào mà dịch vụ sử dụng văn bản để đưa ra cụm từ gợi ý (vị trí của con trỏ trong trường nhập dữ liệu). |
radius
không bắt buộc |
Loại:
number optionalBán kính của khu vực dùng để thiên vị 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
giao diện
google.maps.places.ComponentRestrictions
Xác định các quy định hạn chế về thành phần có thể dùng với dịch vụ tự động hoàn thành.
Thuộc tính | |
|---|---|
country
không bắt buộc |
Loại:
string|Array<string> optionalGiới hạn cụm từ gợi ý cho 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
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.
Thuộc tí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ụ Địa điểm đề xuất. |
matched_substrings |
Loại:
Array<PredictionSubstring>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 độ lệch và độ dài, được biểu thị bằng ký tự unicode. |
place_id |
Loại:
stringMã đị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 |
Loại:
StructuredFormattingThô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 các chuỗi con khớp từ dữ liệu đầu vào tự động hoàn thành, được xác định bằng độ lệch và độ dài, được biểu thị bằng ký tự unicode. |
terms |
Loại:
Array<PredictionTerm>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
không bắt buộc |
Loại:
number optionalKhoả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.
Thuộc tí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ụ Địa điểm đề xuất. |
matched_substrings |
Loại:
Array<PredictionSubstring>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 độ lệch và độ dài, được biểu thị bằng ký tự unicode. |
terms |
Loại:
Array<PredictionTerm>Thông tin về từng điều khoản trong nội dung mô tả ở trên. Cụm từ phân loại xuất hiện trước (ví dụ: "nhà hàng"). Các cụm từ trong đị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
không bắt buộc |
Loại:
string optionalChỉ có sẵn nếu cụm từ gợi ý 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
Đại diện cho một cụm từ gợi ý.
Thuộc tính | |
|---|---|
offset |
Loại:
numberĐộ lệch (tính theo ký tự unicode) của điểm bắt đầu của cụm từ này trong nội dung mô tả địa điểm. |
value |
Loại:
stringGiá trị của cụm từ 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 của cụm từ gợi ý.
Thuộc tính | |
|---|---|
length |
Loại:
numberĐộ dài của chuỗi con. |
offset |
Loại:
numberPhần bù trừ cho phần 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 khớp từ dữ liệu đầu vào tự động hoàn thành, được xác định bằng độ lệch và độ dài, được biểu thị bằng ký tự unicode.
Thuộc tính | |
|---|---|
main_text |
Loại:
stringĐây là phần văn bản chính của nội dung mô tả chưa được đị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 |
Loại:
Array<PredictionSubstring>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 độ lệch và độ 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 được đị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. |