Places Widgets

Lớp Tự động hoàn thành

Lớp google.maps.places.Autocomplete

Một tiện ích cung cấp tính năng gợi ý địa điểm dựa trên nội dung văn bản của người dùng. Tệp này đính kèm vào một phần tử đầu vào thuộc loại text và lắng nghe mục nhập văn bản trong trường đó. Danh sách gợi ý được trình bày dưới dạng danh sách thả xuống và cập nhật khi văn bản được nhập vào.

Lớp này mở rộng MVCObject.

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

Autocomplete
Autocomplete(inputField[, opts])
Thông số:
Tạo một bản sao mới của Autocomplete đính kèm vào trường văn bản nhập được chỉ định với các tùy chọn nhất định.
getBounds
getBounds()
Thông số: Không có
Giá trị trả về: LatLngBounds|undefined Giới hạn xu hướng.
Trả về ranh giới của các dự đoán sai lệch.
getFields
getFields()
Thông số: Không có
Giá trị trả về: Array<string>|undefined
Trả về các trường cần đưa vào Địa điểm trong phản hồi chi tiết khi truy xuất chi tiết thành công. Để xem danh sách các trường, hãy xem PlaceResult.
getPlace
getPlace()
Thông số: Không có
Giá trị trả về: PlaceResult Địa điểm do người dùng chọn.
Trả về thông tin chi tiết của Địa điểm mà người dùng đã chọn nếu thông tin chi tiết được truy xuất thành công. Nếu không, hàm này sẽ trả về đối tượng mã giả lập Place, với thuộc tính name được đặt thành giá trị hiện tại của trường nhập dữ liệu.
setBounds
setBounds(bounds)
Thông số:
Giá trị trả về: Không có
Đặt khu vực ưu tiên để trả về kết quả Địa điểm. Kết quả thiên về khu vực này, nhưng không giới hạn ở khu vực này.
setComponentRestrictions
setComponentRestrictions(restrictions)
Thông số:
Giá trị trả về: Không có
Đặt giới hạn 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.
setFields
setFields(fields)
Thông số:
  • fields: Array<string> optional
Giá trị trả về: Không có
Đặt các trường cần đưa vào Địa điểm trong phản hồi chi tiết khi thông tin chi tiết được truy xuất thành công. Để xem danh sách các trường, hãy xem PlaceResult.
setOptions
setOptions(options)
Thông số:
Giá trị trả về: Không có
setTypes
setTypes(types)
Thông số:
  • typesArray<string> optional Các loại cụm từ gợi ý cần đưa vào.
Giá trị trả về: Không có
Đặt 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.
Đã kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi PlaceResult được cung cấp cho một Địa điểm mà người dùng đã chọn.
Nếu người dùng nhập tên của Địa điểm không được điều khiển đề xuất và nhấn phím Enter hoặc nếu yêu cầu Thông tin chi tiết về địa điểm không thành công, thì PlaceResult sẽ chứa thông tin đầu vào của người dùng trong thuộc tính name mà không có thuộc tính nào khác được xác định.

Giao diện AutofillOptions

Giao diện google.maps.places.AutocompleteOptions

Bạn có thể đặt các tùy chọn trên đối tượng Autocomplete.

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

bounds optional
Khu vực nơi để tìm kiếm địa điểm.
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.
fields optional
Loại: Array<string> optional
Các trường được bao gồm cho Địa điểm trong phản hồi chi tiết khi chi tiết được truy xuất thành công, sẽ được lập hóa đơn cho. Nếu ['ALL'] được chuyển, tất cả các trường có sẵn sẽ được trả về và lập hóa đơn (không nên triển khai việc này). Để xem danh sách các trường, hãy xem PlaceResult. Bạn có thể chỉ định các trường lồng nhau bằng các đường dẫn dấu chấm (ví dụ: "geometry.location"). Mặc định là ['ALL'].
placeIdOnly optional
Loại: boolean optional
Có chỉ truy xuất Mã địa điểm hay không. PlaceResult được cung cấp khi sự kiện place_Changed được kích hoạt sẽ chỉ có các trường place_id, type và name, trong đó place_id, các loại và mô tả được dịch vụ Tự động hoàn thành trả về. Tắt theo mặc định.
strictBounds optional
Loại: boolean optional
Giá trị boolean, cho biết tiện ích Tự động hoàn thành chỉ trả về những địa điểm nằm trong giới hạn của tiện ích Tự động hoàn thành tại thời điểm truy vấn được gửi. Việc đặt nghiêm ngặt các giá trị thành false (mặc định) sẽ làm cho kết quả thiên về, nhưng không bị giới hạn, các địa điểm nằm trong ranh giới đó.
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.

Lớp google.maps.places.SearchBox

Một tiện ích cung cấp tính năng dự đoán cụm từ tìm kiếm dựa trên hoạt động nhập văn bản của người dùng. Tệp này đính kèm vào một phần tử đầu vào thuộc loại text và lắng nghe mục nhập văn bản trong trường đó. Danh sách gợi ý được trình bày dưới dạng danh sách thả xuống và cập nhật khi văn bản được nhập vào.

Lớp này mở rộng MVCObject.

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

SearchBox
SearchBox(inputField[, opts])
Thông số:
Tạo một bản sao mới của SearchBox đính kèm vào trường văn bản nhập được chỉ định với các tùy chọn nhất định.
getBounds
getBounds()
Thông số: Không có
Giá trị trả về: LatLngBounds|undefined
Trả về các giới hạn mà dự đoán truy vấn bị sai lệch.
getPlaces
getPlaces()
Thông số: Không có
Giá trị trả về: Array<PlaceResult>|undefined
Trả về truy vấn mà người dùng chọn để sử dụng với sự kiện places_changed.
setBounds
setBounds(bounds)
Thông số:
Giá trị trả về: Không có
Đặt khu vực để sử dụng cho các dự đoán truy vấn xu hướng. Kết quả sẽ chỉ thiên về khu vực này và không bị hạn chế hoàn toàn đối với khu vực này.
Đã kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Đối số: Không có
Sự kiện này được kích hoạt khi người dùng chọn một truy vấn, sử dụng getPlaces để nhận các địa điểm mới.

Giao diện SearchBoxOptions

Giao diện google.maps.places.SearchBoxOptions

Bạn có thể đặt các tùy chọn trên đối tượng SearchBox.

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

bounds optional
Khu vực hướng tới các truy vấn dự đoán độ chệch. Các cụm từ gợi ý có xu hướng nhưng không bị giới hạn ở những cụm từ tìm kiếm nhắm đến các giới hạn này.