Places Widgets

PlaceCompleteElement lớp

Lớp google.maps.places.PlaceAutocompleteElement

Triển khai Tự động xem cho API Địa điểm

Lớp này triển khai PlaceAutocompleteElementOptions.

Truy cập bằng cách gọi const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). Xem Thư viện trong API JavaScript của Maps.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Thông số: 
element optional
Loại:  HTMLElement|SVGElement optional
Trường này là trường chỉ đọc. Phần tử DOM hỗ trợ chế độ xem.
inputElement
Phần tử đầu vào để hiển thị cụm từ tự động hoàn thành.
Kế thừa: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
Thông số: 
  • eventName:  string
  • handler:  Function
Giá trị trả về:  MapsEventListener
Thêm hàm trình nghe đã cho vào tên sự kiện đã cho.
gmp-placeselect
function(place)
Đối số: 
Sự kiện này được kích hoạt khi người dùng chọn một gợi ý địa điểm. Trả về một đối tượng địa điểm.
gmp-requesterror
function()
Đối số: Không có
Sự kiện này được kích hoạt khi yêu cầu phụ trợ bị từ chối (ví dụ: khóa API không chính xác). Sự kiện này không tạo bong bóng trò chuyện.

Giao diện PlaceRenderingElementOptions

Giao diện google.maps.places.PlaceAutocompleteElementOptions

Các tuỳ chọn để tạo một Trình tự động hoàn thành địa điểm.
inputElement
Phần tử đầu vào để hiển thị cụm từ tự động hoàn thành.
componentRestrictions optional
Loại:  ComponentRestrictions optional
Các hạn chế về thành phần. Giới hạn thành phần chỉ giới hạn truy vấn dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
element optional
Loại:  HTMLElement|SVGElement optional
Trường này là trường chỉ đọc. Phần tử DOM hỗ trợ chế độ xem.
locationBias optional
Loại:  LocationBias optional
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
Các ràng buộc giới hạn kết quả tìm kiếm.
requestedLanguage 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 đề xuất không bị giới hạn ở ngôn ngữ này. Xem danh sách các ngôn ngữ được hỗ trợ.
requestedRegion optional
Loại:  string optional
Mã vùng dùng để định dạng kết quả và lọc kết quả. Thông tin 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 giá trị 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, 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").
types optional
Loại:  Array<string> optional
Loại dự đoán sẽ được trả về. Đối với các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, tất cả các loại sẽ được trả về.

Tự động hoàn thành

Lớp google.maps.places.Autocomplete

Tiện ích cung cấp dự đoán địa điểm dựa trên văn bản mà người dùng nhập vào. Hàm này sẽ đí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 cập nhật khi văn bản được nhập vào.

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

Truy cập bằng cách gọi const {Autocomplete} = await google.maps.importLibrary("places"). Xem Thư viện trong API JavaScript của Maps.
Autocomplete
Autocomplete(inputField[, opts])
Thông số: 
Tạo một thực thể mới của Autocomplete đính kèm vào trường văn bản nhập đã chỉ định với các tuỳ chọn cho sẵn.
getBounds
getBounds()
Thông số: Không có
Giá trị trả về:  LatLngBounds|undefined Các giới hạn xu hướng.
Trả về giới hạn mà các dự đoán có xu hướng.
getFields
getFields()
Thông số: Không có
Giá trị trả về:  Array<string>|undefined
Trả về các trường được bao gồm cho Địa điểm trong phản hồi chi tiết khi các chi tiết được truy lục thành công. Để xem danh sách 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 do 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, sẽ trả về một đối tượng Place giả lập, trong đó 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ả lại: Không có
Đặt khu vực ưa thích trong đó có thể 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ả lại: Không có
Đặt giới hạn cho thành phần. Giới hạn thành phần chỉ giới hạn truy vấn dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
setFields
setFields(fields)
Thông số: 
  • fields:  Array<string> optional
Giá trị trả lại: Không có
Đặt các trường được bao gồm cho Địa điểm trong phản hồi chi tiết khi các chi tiết được truy xuất thành công. Để xem danh sách trường, hãy xem PlaceResult.
setOptions
setOptions(options)
Thông số: 
Giá trị trả lại: Không có
setTypes
setTypes(types)
Thông số: 
  • types:  Array<string> optional Các loại cụm từ gợi ý cần đưa vào.
Giá trị trả lại: Không có
Đặt các loại dự đoán được trả về. Đối với các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, tất cả các loại sẽ được trả về.
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 do chế độ đ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 người dùng Tự động hoàn thành

Giao diện google.maps.places.AutocompleteOptions

Các tuỳ chọn có thể được đặt trên đối tượng Autocomplete.
bounds optional
Khu vực cần tìm kiếm địa điểm.
componentRestrictions optional
Loại:  ComponentRestrictions optional
Các hạn chế về thành phần. Giới hạn thành phần chỉ giới hạn truy vấn dự đoán trong thành phần mẹ. Ví dụ: quốc gia.
fields optional
Loại:  Array<string> optional
Các trường cần bao gồm cho Địa điểm trong phản hồi chi tiết khi chi tiết được truy lục thành công, sẽ được lập hóa đơn cho. Nếu ['ALL'] được chuyển vào, tất cả các trường có sẵn sẽ được trả về và thanh toán (điều này không được khuyến nghị cho triển khai sản xuất). Để xem danh sách 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 ID địa điểm hay không. PlaceResult được cung cấp khi sự kiện Place_Thay đổi được kích hoạt sẽ chỉ chứa các trường Place_id, type và name, trong đó place_id, các loại và thông tin 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
Một giá trị boolean, cho biết rằng tiện ích Tự động hoàn thành chỉ nên trả về những vị trí nằm trong ranh giới của tiện ích Tự động hoàn thành tại thời điểm truy vấn được gửi. Khi đặt nghiêm ngặt Bounds thành false (giá trị mặc định), kết quả sẽ được ưu tiên, nhưng không giới hạn ở các vị trí nằm trong giới hạn.
types optional
Loại:  Array<string> optional
Loại dự đoán sẽ được trả về. Đối với các loại được hỗ trợ, hãy xem hướng dẫn dành cho nhà phát triển. Nếu không có loại nào được chỉ định, tất cả các loại sẽ được trả về.

Lớp google.maps.places.SearchBox

Tiện ích cung cấp truy vấn dự đoán dựa trên nội dung nhập của người dùng. Hàm này sẽ đí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 cập nhật khi văn bản được nhập vào.

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

Truy cập bằng cách gọi const {SearchBox} = await google.maps.importLibrary("places"). Xem Thư viện trong API JavaScript của Maps.
SearchBox
SearchBox(inputField[, opts])
Thông số: 
Tạo một thực thể mới của SearchBox đính kèm vào trường văn bản nhập đã chỉ định với các tuỳ chọn cho sẵn.
getBounds
getBounds()
Thông số: Không có
Giá trị trả về:  LatLngBounds|undefined
Trả về giới hạn mà các truy vấn dự đoán trong truy vấn bị sai.
getPlaces
getPlaces()
Thông số: Không có
Giá trị trả về:  Array<PlaceResult>|undefined
Trả về truy vấn do 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ả lại: Không có
Đặt vùng để 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à sẽ không bị hạn chế hoàn toàn.
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, nên sử dụng getPlaces để nhận các địa điểm mới.

SearchBoxOptions

Giao diện google.maps.places.SearchBoxOptions

Các tuỳ chọn có thể được đặt trên đối tượng SearchBox.
bounds optional
Vùng hướng tới truy vấn dự đoán thiên vị. Các truy vấn dự đoán được thiên về, nhưng không giới hạn, các truy vấn nhắm mục tiêu các giới hạn này.