Places Autocomplete Service (deprecated)

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");
AutocompleteService
AutocompleteService()
Tham số: Không có
Tạo một thực thể mới của AutocompleteService.
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.

input
Loại: string
Chuỗi đầu vào do người dùng nhập.
bounds
không bắt buộc
Giớ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 optional
Cá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 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 chỉ giới hạn ở ngôn ngữ này. Xem danh sách ngôn ngữ được hỗ trợ.
location
không bắt buộc
Loại: LatLng optional
Vị 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 optional
Mộ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 optional
Ranh giới để ràng buộc kết quả tìm kiếm.
offset
không bắt buộc
Loại: number optional
Vị 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 optional
Vị trí dùng để tính AutocompletePrediction.distance_meters.
radius
không bắt buộc
Loại: number optional
Bá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 optional
Mã 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 optional
Giá 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> optional
Loạ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.

predictions

Giao diện QueryAutocompletionRequest

giao diện google.maps.places.QueryAutocompletionRequest

Yêu cầu QueryAutocompletion được gửi đến QueryAutocompleteService.

input
Loại: string
Chuỗi đầu vào do người dùng nhập.
bounds
không bắt buộc
Giớ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 optional
Vị 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 optional
Vị 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 optional
Bá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.

country
không bắt buộc
Loại: string|Array<string> optional
Giớ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.

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
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: 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ả đị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
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 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.

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
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
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 optional
Chỉ 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 ý.

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: 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

Đại diện cho một chuỗi con của cụm từ gợi ý.

length
Loại: number
Độ dài của chuỗi con.
offset
Loại: number
Phầ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.

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
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.