Places Service

PlacesService 类

google.maps.places.PlacesService 类

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

通过调用 const {PlacesService} = await google.maps.importLibrary("places") 进行访问。
请参阅 Maps JavaScript API 中的库。
PlacesService
PlacesService(attrContainer)
参数： 
创建 PlacesService 的新实例，该实例可在指定容器中呈现提供方信息。
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
参数： 
返回值：无
根据电话号码检索地点列表。在大多数情况下，结果列表中应该只有一个项，但如果请求不明确，则可能会返回多个结果。传递给回调的 PlaceResult 是完整 PlaceResult 的子集。您的应用可以通过调用 PlacesService.getDetails 并传递所需地点的 PlaceResult.place_id，获取每个地点的更详细的 PlaceResult。
findPlaceFromQuery
findPlaceFromQuery(request, callback)
参数： 
返回值：无
根据查询字符串检索地点列表。在大多数情况下，结果列表中应该只有一个项，但如果请求不明确，则可能会返回多个结果。传递给回调的 PlaceResult 是完整 PlaceResult 的子集。您的应用可以通过调用 PlacesService.getDetails 并传递所需地点的 PlaceResult.place_id，获取每个地点的更详细的 PlaceResult。
getDetails
getDetails(request, callback)
参数： 
返回值：无
检索由给定 placeId 标识的地点详情。
nearbySearch
nearbySearch(request, callback)
参数： 
返回值：无
根据关键字或类型检索特定位置附近的地点列表。必须始终指定位置，方法是传递 LatLngBounds 或 location 和 radius 参数。传递给回调的 PlaceResult 是完整 PlaceResult 的子集。您的应用可以通过发送地点详情请求来获取每个地点的更详细的 PlaceResult，并传递所需地点的 PlaceResult.place_id。PlaceSearchPagination 对象可用于提取其他结果页面（如果这是最后一个结果页面或只有一个结果页面，则为 null）。
textSearch
textSearch(request, callback)
参数： 
返回值：无
根据查询字符串（例如“北京烤鸭”或“南京附近的鞋店”）检索地点列表。位置参数是可选的；指定位置后，结果只会偏向于附近的地点，而不会仅限于该区域内的地点。如果您想使用任意字符串搜索地点，并且不想将搜索结果限制在特定位置，请使用 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 的通过文本搜索查找地点的请求。