此页面由 Cloud Translation API 翻译。

Places Service

PlacesService 类

google.maps.places.PlacesService 类

包含与搜索地点和检索地点详细信息相关的方法。

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

构造函数
`PlacesService`	`PlacesService(attrContainer)` 参数： `attrContainer`：`HTMLDivElement\|Map` 创建 `PlacesService` 的新实例，该实例可在指定容器中呈现提供方信息。

方法
`findPlaceFromPhoneNumber`	`findPlaceFromPhoneNumber(request, callback)` 参数： `request`：`FindPlaceFromPhoneNumberRequest` `callback`：`function(Array<PlaceResult> optional, PlacesServiceStatus): void` 返回值：无根据电话号码检索地点列表。在大多数情况下，结果列表中应该只有一个项，但如果请求不明确，则可能会返回多个结果。传递给回调的 `PlaceResult` 是完整 `PlaceResult` 的子集。您的应用可以通过调用 `PlacesService.getDetails` 并传递所需地点的 `PlaceResult.place_id`，获取每个地点的更详细的 `PlaceResult`。
`findPlaceFromQuery`	`findPlaceFromQuery(request, callback)` 参数： `request`：`FindPlaceFromQueryRequest` `callback`：`function(Array<PlaceResult> optional, PlacesServiceStatus): void` 返回值：无根据查询字符串检索地点列表。在大多数情况下，结果列表中应该只有一个项，但如果请求不明确，则可能会返回多个结果。传递给回调的 `PlaceResult` 是完整 `PlaceResult` 的子集。您的应用可以通过调用 `PlacesService.getDetails` 并传递所需地点的 `PlaceResult.place_id`，获取每个地点的更详细的 `PlaceResult`。
`getDetails`	`getDetails(request, callback)` 参数： `request`：`PlaceDetailsRequest` `callback`：`function(PlaceResult optional, PlacesServiceStatus): void` 返回值：无检索由给定 `placeId` 标识的地点详情。
`nearbySearch`	`nearbySearch(request, callback)` 参数： `request`：`PlaceSearchRequest` `callback`：`function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void` 返回值：无根据关键字或类型检索特定位置附近的地点列表。必须始终指定位置，方法是传递 `LatLngBounds` 或 `location` 和 `radius` 参数。传递给回调的 `PlaceResult` 是完整 `PlaceResult` 的子集。您的应用可以通过发送地点详情请求来获取每个地点的更详细的 `PlaceResult`，并传递所需地点的 `PlaceResult.place_id`。`PlaceSearchPagination` 对象可用于提取其他结果页面（如果这是最后一个结果页面或只有一个结果页面，则为 null）。
`textSearch`	`textSearch(request, callback)` 参数： `request`：`TextSearchRequest` `callback`：`function(Array<PlaceResult> optional, PlacesServiceStatus, PlaceSearchPagination optional): void` 返回值：无根据查询字符串（例如“北京烤鸭”或“南京附近的鞋店”）检索地点列表。位置参数是可选的；指定位置后，结果只会偏向于附近的地点，而不会仅限于该区域内的地点。如果您想使用任意字符串搜索地点，并且不想将搜索结果限制在特定位置，请使用 `textSearch`。`PlaceSearchPagination` 对象可用于提取其他结果页面（如果这是最后一个结果页面或只有一个结果页面，则为 null）。

PlaceDetailsRequest 接口

google.maps.places.PlaceDetailsRequest 接口

要发送到 PlacesService 的地点详情查询。

属性
`placeId`	类型： `string` 要为其请求详情的 Place 的 Place ID。
`fields optional`	类型： `Array<string> optional` 要包含在详情响应中的字段，这些字段将产生费用。如果未指定任何字段或传入的是 `['ALL']`，系统会返回所有可用字段并据此计费（不建议用于生产环境中的部署）。如需查看字段列表，请参阅 `PlaceResult`。可以使用点路径指定嵌套字段（例如 `"geometry.location"`）。
`language optional`	类型： `string optional` 一种语言标识符，用于指定应以哪种语言返回详细信息。请参阅支持的语言列表。
`region optional`	类型： `string optional` 用户所在地区的地区代码。这可能会影响返回的照片，还可能会影响其他方面。地区代码接受 ccTLD（“顶级域名”）双字符值。多数 ccTLD 代码都与 ISO 3166-1 代码相同，但也有一些需要注意的例外情况。例如，英国的 ccTLD 为“uk”(`.co.uk`)，而其 ISO 3166-1 代码为“gb”（从技术上讲，是指“大不列颠及北爱尔兰联合王国”这一实体）。
`sessionToken optional`	类型： `AutocompleteSessionToken optional` 用于将详情请求与自动补全会话捆绑在一起的唯一引用。

FindPlaceFromPhoneNumberRequest 接口

google.maps.places.FindPlaceFromPhoneNumberRequest 接口

要发送到 PlacesService.findPlaceFromPhoneNumber 的通过文本搜索查找地点的请求。

属性
`fields`	类型： `Array<string>` 要包含在响应中的字段，这些字段会产生费用。如果传入的是 `['ALL']`，系统会返回所有可用字段并据此计费（不建议用于生产环境中的部署）。如需查看字段列表，请参阅 `PlaceResult`。可以使用点路径指定嵌套字段（例如 `"geometry.location"`）。
`phoneNumber`	类型： `string` 要查找的场所的电话号码。格式必须为 E.164。
`language optional`	类型： `string optional` 一种语言标识符，用于指定应尽可能以哪种语言返回名称和地址。请参阅支持的语言列表。
`locationBias optional`	类型： `LocationBias optional` 搜索地点时使用的偏差。结果会偏向于（但不限于）给定的 `LocationBias`。

FindPlaceFromQueryRequest 接口

google.maps.places.FindPlaceFromQueryRequest 接口

要发送到 PlacesService.findPlaceFromQuery 的通过文本搜索查找地点的请求。

属性
`fields`	类型： `Array<string>` 要包含在响应中的字段，这些字段会产生费用。如果传入的是 `['ALL']`，系统会返回所有可用字段并据此计费（不建议用于生产环境中的部署）。如需查看字段列表，请参阅 `PlaceResult`。可以使用点路径指定嵌套字段（例如 `"geometry.location"`）。
`query`	类型： `string` 请求的查询。例如，地点的名称或地址。
`language optional`	类型： `string optional` 一种语言标识符，用于指定应尽可能以哪种语言返回名称和地址。请参阅支持的语言列表。
`locationBias optional`	类型： `LocationBias optional` 搜索地点时使用的偏差。结果会偏向于（但不限于）给定的 `LocationBias`。

PlaceSearchRequest 接口

google.maps.places.PlaceSearchRequest 接口

要发送到 PlacesService 的地点搜索查询。

属性
`bounds optional`	类型： `LatLngBounds\|LatLngBoundsLiteral optional` 要在其中搜索地点的边界。如果设置了 `bounds`，系统会忽略 `location` 和 `radius`。
`keyword optional`	类型： `string optional` 要与所有可用字段进行匹配的字词，包括但不限于名称、类型和地址，以及客户评价和其他第三方内容。
`language optional`	类型： `string optional` 一种语言标识符，用于指定应尽可能以哪种语言返回名称和地址。请参阅支持的语言列表。
`location optional`	类型： `LatLng\|LatLngLiteral optional` 要在其周边搜索地点的位置。
`maxPriceLevel optional`	类型： `number optional` 将结果限制为仅包含指定价位或更低价位的地点。有效值范围介于 0（最实惠）和 4（最昂贵）之间，包括 0 和 4。如果指定，则必须大于或等于 `minPrice` 。
`minPriceLevel optional`	类型： `number optional` 将结果限制为仅包含指定价位或更高价位的地点。有效值范围介于 0（最实惠）和 4（最昂贵）之间，包括 0 和 4。如果指定了值，则必须小于或等于 `maxPrice`。
`name optional`	已弃用：请改用 `keyword`。类型： `string optional` 等同于 `keyword`。此字段中的值会与 `keyword` 字段中的值合并，作为同一搜索字符串的一部分进行传递。
`openNow optional`	类型： `boolean optional` 将结果限制为仅包含当前营业的地点。
`radius optional`	类型： `number optional` 搜索地点的范围，以米为单位，即与指定位置之间的距离。允许的最大值为 50,000。
`rankBy optional`	类型： `RankBy optional` 默认值： `RankBy.PROMINENCE` 指定返回结果时要使用的排名方法。请注意，将 `rankBy` 设置为 `DISTANCE` 时，您必须指定 `location`，但不能指定 `radius` 或 `bounds`。
`type optional`	类型： `string optional` 搜索指定类型的地点。该类型会翻译为请求的目标位置的本地语言，并用作查询字符串。如果还提供了查询，则会将其与本地化的类型字符串串联起来。从响应中舍弃其他类型的结果。使用此字段可执行与语言和地区无关的分类搜索。如需查看有效类型，请点击此处。

TextSearchRequest 接口

google.maps.places.TextSearchRequest 接口

要发送到 PlacesService 的文本搜索请求。

属性
`bounds optional`	类型： `LatLngBounds\|`