索引
DestinationService
(接口)Destination
(消息)Entrance
(消息)Entrance.Tag
(枚举)Landmark
(消息)Landmark.Tag
(枚举)NavigationPoint
(消息)NavigationPoint.TravelMode
(枚举)NavigationPoint.Usage
(枚举)PlaceView
(消息)PlaceView.StructureType
(枚举)SearchDestinationsRequest
(消息)SearchDestinationsRequest.AddressQuery
(消息)SearchDestinationsRequest.LocationQuery
(消息)SearchDestinationsResponse
(消息)
DestinationService
用于检索目的地的服务。
目的地提供有关地点的分层上下文,例如,您可以查找大型公寓楼内的公寓楼,反之亦然。它还提供适合拼车或送货等使用情形的导航点。
SearchDestinations |
---|
此方法会执行目的地查找并返回目的地列表。
|
目的地
目的地。这包括主要地点、相关地点、入口和导航点。
字段 | |
---|---|
primary |
请求中由 |
containing_places[] |
包含主要位置的精度较低的位置。例如,包含此建筑物的公寓楼群。 |
sub_destinations[] |
主要地点的更精确的子目的地。例如,建筑物中包含的单元。 注意:与 Places API 返回的 SubDestination 相比,此子目的地列表更详尽,并且每个子目的地都包含更多信息。 |
landmarks[] |
可用于指示目的地位置或帮助到达目的地的地标。 |
entrances[] |
相应目的地的入口。 |
navigation_points[] |
相应目的地的导航点。 |
入口
入口是指单个纬度/经度坐标对,用于定义某个地点的入口和出口位置。
字段 | |
---|---|
location |
入口的位置。 |
tags[] |
描述入口的标记列表。 |
place |
入口所在的实体的结构,采用 |
标记
描述入口的特征。
枚举 | |
---|---|
TAG_UNSPECIFIED |
未使用。 |
PREFERRED |
入口可能提供对返回的目的地中主要地点的实际访问权限。一个地点可以有多个首选入口。如果某个入口没有此标记,则表示该入口在实体上与主要场所位于同一建筑物内,但不一定能通往该场所。 例如,如果主要地点是商业街中的一家餐厅,“首选”入口很可能是通往餐厅本身的入口,而返回的其他入口则是该建筑物的其他入口,例如通往商业街中其他餐厅的入口。 如果主要地点本身就是建筑物,则 注意: |
地标
地标用于指示目的地所在的位置,或帮助您到达目的地。
字段 | |
---|---|
tags[] |
用于描述地标在目的地背景下的用途的标记。 |
联合字段 landmark 。地标。landmark 只能是下列其中一项: |
|
place |
表示相应地标的地点。 |
标记
描述如何在目的地背景下使用地标的所有可能标记的列表。
如果某个地址同时具有 ADDRESS
和 ARRIVAL
标记,则表示该地标在本地非常显眼,并且靠近目的地。
枚举 | |
---|---|
TAG_UNSPECIFIED |
未使用。 |
ADDRESS |
可用于确定目的地大致位置的当地著名地点。通常在目的地几百米范围内。这些地标类似于 Geocoding API 的地址描述符功能返回的地标:https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors。 |
ARRIVAL |
可用于帮助到达目的地的地点。当您接近目的地时,此功能可用于导航。例如,此地标可能是目的地对面的一处地点。带有此标记的地标通常比带有 ADDRESS 标记的地标更靠近目的地。 |
PlaceView
表示 Places API 中 Place 的视图。它还提供特定于目的地的其他信息,例如结构类型和显示多边形。
在某些情况下,具有相同地点 ID 的 PlaceView
可能与 Places API 针对 types
和 display_name
字段返回的内容不同。
字段 | |
---|---|
place |
相应地点的资源名称,格式为 |
display_name |
人类可读的地点说明。例如,“B 门”“麦当劳” |
primary_type |
相应地点的主要地点类型。如需查看可能的值的列表,请访问 https://developers.google.com/maps/documentation/places/web-service/place-types。 注意:此字段并非始终填充内容。请准备好在这些情况下使用 |
types[] |
相应地点的所有关联地点类型。如需查看可能的值的列表,请访问 https://developers.google.com/maps/documentation/places/web-service/place-types。 |
formatted_address |
单行地址。 |
postal_address |
结构化地址。 |
structure_type |
与相应地点对应的结构类型。 |
location |
相应地点的位置。对于具有显示多边形的地点,这可能表示在地图上放置标记的好位置。 |
display_polygon |
采用 GeoJSON 格式的地点多边形轮廓,使用 RFC 7946 格式:https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6。 注意:RFC 7946 格式支持 MultiPolygon,因此一个 |
StructureType
相应地点所代表的结构类型。
枚举 | |
---|---|
STRUCTURE_TYPE_UNSPECIFIED |
未使用。 |
POINT |
点状位置。 |
SECTION |
建筑物的子部分。 |
BUILDING |
建筑物。 |
GROUNDS |
通常包含多栋建筑的大型区域,例如大学校园、公寓楼群或购物中心。 |
SearchDestinationsRequest
针对 DestinationService.SearchDestinations 的请求消息。
字段 | |
---|---|
travel_modes[] |
可选。用于过滤导航点的出行方式。这会影响响应中返回的 |
language_code |
可选。应返回结果所用的语言。 |
region_code |
可选。区域代码。地区代码,以 ccTLD(“顶级域名”)双字符值的形式指定。此参数会根据适用法律影响结果。此参数还会影响但不会完全限制服务中的结果。 |
联合字段 目标是围绕指定的主查询构建的。 注意:仅支持可作为导航目的地的地点和地址。例如,表示住宅或公寓楼的地点可用作主要查询,但表示地点或行政区域的地点不能用作主要查询。 |
|
place |
地点的资源名称,格式为 |
address_query |
街道地址。 |
location_query |
确切位置。 |
AddressQuery
您要搜索的街道地址。按照相关国家全国邮政服务使用的格式指定地址
字段 | |
---|---|
联合字段 kind 。地址查询。kind 只能是下列其中一项: |
|
address |
邮政地址格式的街道地址。 |
address_query |
格式为单行的街道地址。 |
LocationQuery
用于识别附近主要目的地的位置查询。
注意:如果位置查询是在包含子场所的建筑物内进行的,则返回的主要场所可能是子场所。在这些情况下,containing_places 字段将包含相应建筑物。
字段 | |
---|---|
联合字段 kind 。位置信息查询。kind 只能是下列其中一项: |
|
location |
精确的 LatLng 位置。 |
SearchDestinationsResponse
针对 DestinationService.SearchDestinations 的响应消息。
字段 | |
---|---|
destinations[] |
目的地列表。 如果可以从主要查询中明确识别出主要目的地,则服务会返回一个结果。否则,该服务可能会返回多个结果以消除歧义,也可能不返回任何结果。 |