Places Widgets

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Autocomplete

google.maps.places.Autocomplete

根据用户的文本输入提供地点预测的微件。它会附加到 text 类型的输入元素,并监听该字段中的文本输入。预测结果列表会以下拉列表的形式显示,并且会在文本输入时更新。

此类扩展了 MVCObject

需要提供 &libraries=places 网址参数。请参阅 Maps JavaScript API 中的库

Autocomplete
Autocomplete(inputField[, opts])
参数
创建一个使用指定选项附加到指定输入文本字段的 Autocomplete 新实例。
getBounds
getBounds()
参数:无
返回值LatLngBounds|undefined 偏差范围。
返回预测偏差的边界。
getFields
getFields()
参数:无
返回值Array<string>|undefined
成功检索详情后,返回要在详情响应中为相应地点添加的字段。如需查看字段列表,请参阅 PlaceResult
getPlace
getPlace()
参数:无
返回值PlaceResult用户选择的地点。
如果成功检索到详细信息,则返回用户所选择的地点的详细信息。否则,返回存根地点对象,并将 name 属性设置为输入字段的当前值。
setBounds
setBounds(bounds)
参数
返回值:无
设置要返回地点结果的首选区域。结果偏向于但不限于此区域。
setComponentRestrictions
setComponentRestrictions(restrictions)
参数
返回值:无
设置组件限制。组件限制用于将预测结果限制为仅父组件内的联想查询。例如,国家/地区。
setFields
setFields(fields)
参数
  • fieldsArray<string> optional
返回值:无
设置成功检索详情后要添加到详情响应中的字段。如需查看字段列表,请参阅 PlaceResult
setOptions
setOptions(options)
参数
返回值:无
setTypes
setTypes(types)
参数
  • typesArray<string> optional要包含的预测类型。
返回值:无
设置要返回的预测结果类型。如需了解支持的类型,请参阅开发者指南。如果未指定任何类型,则会返回所有类型。
继承addListenerbindTogetnotifysetsetValuesunbindunbindAll
place_changed
function()
参数:None
在用户选择的地点有可用的 PlaceResult 时会触发此事件。
如果用户输入控件未建议的地点的名称,然后按 Enter 键,或者如果“地点详情”请求失败,PlaceResult 会在 name 属性中包含用户输入,并且不会定义其他属性。

AutocompleteOptions 接口

google.maps.places.AutocompleteOptions接口

可在 Autocomplete 对象上设置的选项。

需要提供 &libraries=places 网址参数。请参阅 Maps JavaScript API 中的库

bounds optional
搜索地点的区域。
componentRestrictions optional
类型ComponentRestrictions optional
组件限制。组件限制用于将预测结果限制为仅父组件内的联想查询。例如,国家/地区。
fields optional
类型Array<string> optional
成功检索到详情后将添加到详情响应中的字段(将收取费用)。如果传入 ['ALL'],则会返回所有可用字段并支付相应费用(不建议用于生产部署)。如需查看字段列表,请参阅 PlaceResult。可以使用点路径(例如 "geometry.location")指定嵌套字段。默认值为 ['ALL']
placeIdOnly optional
类型boolean optional
是否只检索地点 ID。触发 place_change 事件时提供的 PlaceResult 将只包含 place_id、类型和名称字段,以及自动补全服务返回的 place_id、类型和说明。默认情况下,该环境处于停用状态。
strictBounds optional
类型boolean optional
布尔值,指明自动补全微件应仅在发送查询时返回自动补全微件边界内的那些地点。将 strictBounds 设置为 false(默认设置)会使结果偏向于(但不限于)边界内包含的地点。
types optional
类型Array<string> optional
要返回的预测类型。如需了解支持的类型,请参阅开发者指南。如果未指定任何类型,则会返回所有类型。

google.maps.places.SearchBox

此微件可根据用户的文本输入提供查询预测。它会附加到 text 类型的输入元素,并监听该字段中的文本输入。预测结果列表会以下拉列表的形式显示,并且会在文本输入时更新。

此类扩展了 MVCObject

需要提供 &libraries=places 网址参数。请参阅 Maps JavaScript API 中的库

SearchBox
SearchBox(inputField[, opts])
参数
创建一个使用指定选项附加到指定输入文本字段的 SearchBox 新实例。
getBounds
getBounds()
参数:无
返回值LatLngBounds|undefined
返回查询偏差所偏向的边界。
getPlaces
getPlaces()
参数:无
返回值Array<PlaceResult>|undefined
返回用户要用于 places_changed 事件的查询。
setBounds
setBounds(bounds)
参数
返回值:无
设置用于偏向查询预测的区域。搜索结果只会偏向于此区域,而不会完全局限于此区域。
继承addListenerbindTogetnotifysetsetValuesunbindunbindAll
places_changed
function()
参数:None
用户选择查询后会触发此事件,应使用 getPlaces 来获取新的地点。

SearchBoxOptions 接口

google.maps.places.SearchBoxOptions接口

可在 SearchBox 对象上设置的选项。

需要提供 &libraries=places 网址参数。请参阅 Maps JavaScript API 中的库

bounds optional
偏向查询预测的区域。预测结果偏向于(但不限于)定位到这些边界的查询。