Places Autocomplete Service

AutocompleteService

google.maps.places.AutocompleteService

包含与检索自动补全预测结果相关的方法。

通过调用 const {AutocompleteService} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库

AutocompleteService
AutocompleteService()
参数:无
创建 AutocompleteService 的新实例。
getPlacePredictions
getPlacePredictions(request[, callback])
参数
根据提供的自动补全请求检索地点自动补全预测结果。
getQueryPredictions
getQueryPredictions(request, callback)
参数
返回值:无
根据提供的查询自动补全请求检索查询自动补全预测结果。

Auto completionRequest 接口

google.maps.places.AutocompletionRequest 接口

要发送给AutocompleteService.getPlacePredictions的自动补全请求。

input
类型string
用户输入的字符串。
bounds optional
预测偏差调整的边界。预测结果将偏向于(但不限于)给定的bounds。如果设置了 bounds,系统会忽略 locationradius
componentRestrictions optional
类型ComponentRestrictions optional
组件限制。组件限制用于将预测结果限制为仅包含父组件内的预测结果。例如,国家/地区。
language optional
类型string optional
返回结果所用语言(如果可能)的语言标识符。所选语言的结果可能会获得较高的排名,但建议并不仅限于此语言。请参阅支持的语言列表
location optional
类型LatLng optional
用于预测自定义调整的位置。预测结果将偏向于给定的 locationradius。或者,您也可以使用 bounds
locationBias optional
类型LocationBias optional
搜索地点时使用的软边界或提示。
locationRestriction optional
类型LocationRestriction optional
用于限制搜索结果的边界。
offset optional
类型number optional
输入字词中的字符位置,服务会在该位置使用文本进行预测(光标在输入字段中的位置)。
origin optional
类型LatLng|LatLngLiteral optional
radius optional
类型number optional
用于预测自定义调整的区域的半径。radius 以米为单位,必须始终附带 location 属性。或者,您也可以使用 bounds
region optional
类型string optional
区域代码,用于结果格式设置和结果过滤。系统不会将建议仅应用于此国家/地区。地区代码接受 ccTLD(“顶级域名”)双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同,但也有一些需要注意的例外情况。例如,英国的 ccTLD 为“uk”(.co.uk),而其 ISO 3166-1 代码为“gb”(特指“大不列颠及北爱尔兰联合王国”)。
sessionToken optional
类型AutocompleteSessionToken optional
用于将各个请求捆绑到会话中的唯一参考。
types optional
类型Array<string> optional
要返回的预测结果类型。如需了解支持的类型,请参阅 开发者指南。如果未指定任何类型,系统将返回所有类型。

AutocompleteResponse 接口

google.maps.places.AutocompleteResponse 接口

调用 AutocompleteService.getPlacePredictions 返回的自动补全响应,其中包含 AutocompletePrediction 列表。

predictions

QueryAuto completionRequest 接口

google.maps.places.QueryAutocompletionRequest 接口

要发送到 QueryAutocompleteService 的查询自动补全请求。

input
类型string
用户输入的字符串。
bounds optional
预测偏差调整的边界。预测结果将偏向于(但不限于)给定的bounds。如果设置了 bounds,系统会忽略 locationradius
location optional
类型LatLng optional
用于预测自定义调整的位置。预测结果将偏向于给定的 locationradius。或者,您也可以使用 bounds
offset optional
类型number optional
输入字词中的字符位置,服务会在该位置使用文本进行预测(光标在输入字段中的位置)。
radius optional
类型number optional
用于预测自定义调整的区域的半径。radius 以米为单位,必须始终附带 location 属性。或者,您也可以使用 bounds

AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken

表示用于跟踪自动补全会话的会话令牌,可以是一系列 AutocompleteService.getPlacePredictions 调用,后跟一个 PlacesService.getDetails 调用。

通过调用 const {AutocompleteSessionToken} = await google.maps.importLibrary("places") 进行访问。请参阅 Maps JavaScript API 中的库

AutocompleteSessionToken
AutocompleteSessionToken()
参数:无
创建 AutocompleteSessionToken 的新实例。

ComponentRestrictions 接口

google.maps.places.ComponentRestrictions 接口

定义可与自动补全服务搭配使用的组件限制。

country optional
类型string|Array<string> optional
将预测结果限制为指定国家/地区(ISO 3166-1 Alpha-2 国家/地区代码,不区分大小写)。例如,'us''br''au'。您可以提供单个国家/地区字符串,也可提供包含最多五个国家/地区代码字符串的数组。

AutocompletePrediction 接口

google.maps.places.AutocompletePrediction 接口

表示单个自动补全预测结果。

description
类型string
这是地点服务建议的未格式化查询版本。
matched_substrings
地点说明中的一组子字符串,与用户输入中的元素相匹配,适合用于突出显示这些子字符串。每个子字符串都由偏移量和长度标识(以 Unicode 字符表示)。
place_id
类型string
地点 ID,可用于使用地点详情服务检索此地点的详细信息(请参阅 PlacesService.getDetails)。
structured_formatting
地点说明的结构化信息,分为主要文本和辅助文本,包括来自自动填充输入的匹配子字符串数组(通过 Unicode 字符表示)。
terms
上述说明中有关各个字词的信息,从最具体到最不具体。例如:“塔可钟”、“威利蒂斯”和“加拿大”。
types
类型Array<string>
预测结果所属的类型数组,例如 'establishment''geocode'
distance_meters optional
类型number optional
地点与 AutocompletionRequest.origin 的距离(以米为单位)。

QueryAutocompletePrediction 接口

google.maps.places.QueryAutocompletePrediction 接口

表示单个查询自动补全预测结果。

description
类型string
这是地点服务建议的未格式化查询版本。
matched_substrings
地点说明中的一组子字符串,与用户输入中的元素相匹配,适合用于突出显示这些子字符串。每个子字符串都由偏移量和长度标识(以 Unicode 字符表示)。
terms
上述说明中各个字词的相关信息。分类字词排在最前面(例如,“餐馆”)。系统会按从高到低的顺序显示地址字词。例如,“旧金山”和“加拿大”。
place_id optional
类型string optional
仅在预测结果为地点时可用。地点 ID,可用于使用地点详情服务检索此地点的详细信息(请参阅 PlacesService.getDetails)。

Predictionterm 接口

google.maps.places.PredictionTerm 接口

表示预测字词。

offset
类型number
地点说明中此字词开始的偏移量(以 Unicode 字符表示)。
value
类型string
此字词的值,例如“塔可钟”。

PredictionSubstring 接口

google.maps.places.PredictionSubstring 接口

表示预测子字符串。

length
类型number
子字符串的长度。
offset
类型number
到说明字符串中子字符串开始的偏移量。

StructuredFormat 接口

google.maps.places.StructuredFormatting 接口

包含地点说明的结构化信息,分为主要文本和辅助文本,包括来自自动补全输入的匹配子字符串数组(通过 Unicode 字符来表示)。

main_text
类型string
这是地点服务所建议的地点格式有误的主要说明部分。通常是地点的名称。
main_text_matched_substrings
主文本中的一组子字符串,与用户输入中的元素相匹配,适合突出显示这些子字符串。每个子字符串都由偏移量和长度标识(以 Unicode 字符表示)。
secondary_text
类型string
这是地点服务建议的地点格式不正确的辅助文本部分。通常是地点的位置。