Places Autocomplete Service

Lớp AutofillService

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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

AutocompleteService
AutocompleteService()
Thông số: Không có
Tạo một bản sao mới của AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Thông số:
Giá trị trả về: Promise<AutocompleteResponse>
Truy xuất giá trị dự đoán tự động hoàn thành 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 được cung cấp.

Giao diện AutocompleteRequest

Giao diện google.maps.places.AutocompletionRequest

Yêu cầu Tự động hoàn thành sẽ được gửi đến AutocompleteService.getPlacePredictions.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

input
Loại: string
Người dùng đã nhập chuỗi đầu vào.
bounds optional
Ranh giới cho xu hướng dự đoán. Các cụm từ gợi ý sẽ thiên về nhưng không giới hạn ở bounds nhất định. Cả locationradius đề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 tuỳ chọn hạn chế thành phần chỉ dùng để hạn chế cụm từ gợi ý 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ả trong 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 các ngôn ngữ được hỗ trợ.
location optional
Loại: LatLng optional
Vị trí của xu hướng dự đoán. Các dự đoán sẽ thiên về locationradius nhất định. 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).
origin optional
Loại: LatLng|LatLngLiteral optional
radius optional
Loại: number optional
Bán kính của khu vực dùng để xu hướng dự đoán. radius được chỉ định theo mét và phải luôn đi kèm với một 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 dùng để định dạng kết quả và lọc kết quả. Việc này không hạn chế các đề xuất đối với quốc gia này. Mã vùng chấp nhận một giá trị hai ký tự gồm 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, 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à pháp nhân "Vương quốc Anh và Bắc Ireland".
sessionToken optional
Loại: AutocompleteSessionToken optional
Tệp đối chiếu duy nhất dùng để nhóm từng yêu cầu thành các phiên.
types optional
Loại: Array<string> optional
Các 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ì hệ thống sẽ trả về mọi loại.

Giao diện AutofillResponse

Giao diện google.maps.places.AutocompleteResponse

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

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

predictions

Giao diện QueryAutoAutofillRequest

Giao diện google.maps.places.QueryAutocompletionRequest

Yêu cầu Truy vấn tự động hoàn thành sẽ được gửi đến QueryAutocompleteService.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

input
Loại: string
Người dùng đã nhập chuỗi đầu vào.
bounds optional
Ranh giới cho xu hướng dự đoán. Các cụm từ gợi ý sẽ thiên về nhưng không giới hạn ở bounds nhất định. Cả locationradius đều sẽ bị bỏ qua nếu bạn đặt bounds.
location optional
Loại: LatLng optional
Vị trí của xu hướng dự đoán. Các dự đoán sẽ thiên về locationradius nhất định. 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 để xu hướng dự đoán. radius được chỉ định theo mét và phải luôn đi kèm với một thuộc tính location. Ngoài ra, bạn có thể sử dụng bounds.

Lớp AutofillSessionToken

Lớp google.maps.places.AutocompleteSessionToken

Biểu thị một 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 loạt các lệnh gọi AutocompleteService.getPlacePredictions theo sau là một lệnh gọi PlacesService.getDetails.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

AutocompleteSessionToken
AutocompleteSessionToken()
Thông số: Không có
Tạo một bản sao mới của AutocompleteSessionToken.

Giao diện ComponentIdentifier

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.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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

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

Giao diện google.maps.places.AutocompletePrediction

Đại diện cho một cụm từ gợi ý của tính năng tự động hoàn thành.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

description
Loại: string
Đây là phiên bản chưa được đị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 chuỗi con trong nội dung mô tả về đị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à 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 để truy xuất thông tin chi tiết về địa điểm này bằng dịch vụ 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à một văn bản phụ, bao gồm một mảng chuỗi con phù hợp từ thông tin đầu vào tự động hoàn thành, đượ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 thuật ngữ trong phần mô tả ở trên, từ nhiều nhất đến ít cụ thể nhất. Ví dụ: "Taco Bell", "Willitis" và "CA"
types
Loại: Array<string>
Một loạt các loại cụm từ gợi ý, chẳng hạn như '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ính từ AutocompletionRequest.origin.

Giao diện QueryTự động dự đoá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 duy nhất.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

description
Loại: string
Đây là phiên bản chưa được đị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 chuỗi con trong nội dung mô tả về đị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à một độ dài, được biểu thị bằng các ký tự unicode.
terms
Thông tin về từng thuật ngữ trong phần mô tả ở trên. Thuật ngữ danh mục sẽ được xếp trước (ví dụ: "nhà&"). Các cụm từ địa chỉ xuất hiện theo thứ tự từ cao đến thấp. Ví dụ: "San Francisco" và "CA"
place_id optional
Loại: string optional
Chỉ có sẵn nếu 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ụ 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 ý.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

offset
Loại: number
Mức chênh lệch, bằng các ký tự unicode, bắt đầu từ cụm từ này trong phần 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

Giao diện google.maps.places.PredictionSubstring

Đại diện cho một chuỗi con dự đoán.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

length
Loại: number
Độ dài của chuỗi con.
offset
Loại: number
Mức chênh lệch đối với chuỗi con bắt đầu trong chuỗi mô tả.

Giao diện có định dạng có cấu trúc

Giao diện google.maps.places.StructuredFormatting

Chứa thông tin có cấu trúc về nội dung mô tả về địa điểm, được chia thành văn bản chính và một văn bản phụ, bao gồm một mảng các chuỗi con phù hợp từ thông tin đầu vào tự động hoàn thành, được xác định bằng một khoảng bù và độ dài, được biểu thị bằng các ký tự unicode.

Yêu cầu tham số URL &libraries=places. Hãy xem phần Thư viện trong API JavaScript của Maps.

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 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à 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 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 thì đó là vị trí của địa điểm.