Package google.maps.locationselection.v1beta

索引

• LocationSelectionBeta（接口）
• Address（消息）
• AddressComponent（消息）
• Compound（消息）
• CompoundTypeEnums（消息）
• CompoundTypeEnums.CompoundType（枚举）
• Entrance（消息）
• FindNearbyPlacesRequest（消息）
• FindNearbyPlacesResponse（消息）
• FindPickupPointsForLocationRequest（消息）
• FindPickupPointsForLocationResponse（消息）
• FindPickupPointsForPlaceRequest（消息）
• FindPickupPointsForPlaceResponse（消息）
• FormattedAddress（消息）
• Geometry（消息）
• LocalizationPreferences（消息）
• PickupPoint（消息）
• PickupPointOrderEnums（消息）
• PickupPointOrderEnums.PickupPointOrder（枚举）
• PickupPointResult（消息）
• Place（消息）
• PlacePickupPointResult（消息）
• PlaceResult（消息）
• TrafficRestrictionEnums（消息）
• TrafficRestrictionEnums.TrafficRestriction（枚举）
• TravelDetail（消息）
• TravelModeEnums（消息）
• TravelModeEnums.TravelMode（枚举）
• WiFiAccessPoint（消息）

LocationSelectionBeta

用于获取附近地点和关联的上车点和下车点的服务。

FindNearbyPlaces
rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse) 查找指定位置附近的地点。

FindPickupPointsForLocation
rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse) 查找指定地点的上车点。

FindPickupPointsForPlace
rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse) 查找指定地点的上车点。

地址

地点的地址。

字段
formatted_address	FormattedAddress 此地点的直观易懂的完整地址。
address_components[]	AddressComponent 地址组成部分的列表。

AddressComponent

描述地址一部分的地址组成部分。

字段
component_text	string 此组件的名称，用于描述地址的一部分。例如，“California”（加利福尼亚州）、“Amphitheatre Parkway”。
component_text_short_form	string 组件文本的简短形式。例如，“CA”表示“加利福尼亚州”，“US”表示“美国”。
types[]	string 此组成部分的类型，用于描述地址的一部分。如需查看支持的类型的列表，请参阅 https://developers.google.com/places/web-service/supported_types#table2

建筑

与地点相关的建筑群。

字段
type	CompoundType 化合物的类型。
geometry	Geometry 与化合物关联的几何图形。
entrances[]	Entrance 与相应化合物相关的进入次数列表。

CompoundTypeEnums

化合物的类型

CompoundType

复合类型的值。

枚举
COMPOUND_TYPE_UNSPECIFIED	复合类型未知。
SECTION	复合部分。https://support.google.com/mapskb/answer/7054299
BUILDING	复合建筑。https://support.google.com/mapskb/answer/7013011
GROUNDS	复合场地。https://support.google.com/mapskb/answer/7046859

入口

地点的入口。

字段
location	LatLng 入口的位置。

FindNearbyPlacesRequest

“查找附近的地点”请求消息。

字段
localization_preferences	LocalizationPreferences 必需。用于对回复中的文本进行本地化的偏好设置，例如姓名和地址。
search_location	LatLng 必需。需要查找地点的位置。
max_results	int32 必需。要返回的结果数上限。必须大于 0。
wifi_access_points[]	WiFiAccessPoint 请求位置周围的 Wi-Fi 接入点。用于提供更优质的搜索结果。

FindNearbyPlacesResponse

针对给定位置响应消息查找附近的地点。

字段
place_results[]	PlaceResult 已找到的已排序地点列表。如果在请求位置周围未找到地点，则此字段可能为空。排序基于可能性和距离的组合。

FindPickupPointsForLocationRequest

FindPickupPointsForLocation 请求消息。

字段
localization_preferences	LocalizationPreferences 必需。用于对回复中的文本进行本地化的偏好设置，例如姓名和地址。
search_location	LatLng 必需。用于搜索上车点、计算距离以及到上车点的预计到达时间的位置。
order_by	PickupPointOrder 必需。返回结果时使用的排序。
destination	LatLng 客户的预期目标位置。在请求按目的地预计到达时间排序的上车点时设置。
max_results	int32 必需。要返回的结果数上限。必须大于 0。
travel_modes[]	TravelMode 必需。只返回至少支持一种指定出行方式的上车点。支持的出行方式：DRIVING 和 TWO_WHEELER。必须至少指定一种模式。
compute_walking_eta	bool 如果为 true，则计算从搜索位置到上车点的步行预计到达时间。
compute_driving_eta	bool 如果为 true 且指定了目的地，则计算从上车点到目的地的驾车预计到达时间。
wifi_access_points[]	WiFiAccessPoint 搜索位置周围的 Wi-Fi 接入点。用于提供更优质的搜索结果。

FindPickupPointsForLocationResponse

为位置响应消息查找上车点。

字段
place_pickup_point_results[]	PlacePickupPointResult 附近有关联地点 ID 的取货点。此列表中的结果将根据请求中指定的条件进行排序。“place_pickup_point_results”的结果数可能会超过“place_results”的结果数。
place_results[]	PlaceResult 与附近取货点关联的地点的详细信息。此列表中的结果未排序。

FindPickupPointsForPlaceRequest

FindPickupPointsForPlace 请求消息。

字段
place_id	string 必需。请求取件点的地点的地点 ID。
localization_preferences	LocalizationPreferences 必需。用于对回复中的文本进行本地化的偏好设置，例如姓名和地址。
search_location	LatLng 用于搜索上车点、计算距离以及到上车点的预计到达时间的位置。如果未设置，则使用与指定地点 ID 相关联的地点的位置。
order_by	PickupPointOrder 必需。返回结果时使用的排序。
destination	LatLng 客户的预期目标位置。如果请求按目的地预计到达时间订购取货点，请设置。
max_results	int32 必需。要返回的结果数上限。必须大于 0。
travel_modes[]	TravelMode 必需。只返回至少支持一种指定出行方式的上车点。支持的出行方式：DRIVING 和 TWO_WHEELER。必须至少指定一种模式。
compute_walking_eta	bool 如果为 true，则计算从搜索位置到上车点的步行预计到达时间。
compute_driving_eta	bool 如果为 true 且指定了目的地，则计算从上车点到目的地的驾车预计到达时间。

FindPickupPointsForPlaceResponse

查找地点响应消息的上车点。

字段
pickup_point_results[]	PickupPointResult 与请求条件相符的上车点。如果没有与请求条件相符的取货点，则此字段可能为空。
place_result	PlaceResult 请求中与指定地点 ID 关联的地点。

FormattedAddress

包含此消息的实体的人类可读完整地址。

字段
lines[]	string 描述地址的文本行。其中必须至少有一行。

几何图形

地点的几何图形。

字段
location	LatLng 包含此消息的实体的中心点。
viewport	Viewport 适合在平均大小的地图上显示地点的视口。
display_boundary	Struct 使用 GeoJSON 多边形格式指定多边形

LocalizationPreferences

包含此消息的实体的人类可读完整地址。

字段
language_code	string 必需。用于本地化文本的 BCP-47 语言标记。语言标记的示例包括“en-US”“hi-IN”“fr-CA”等。
region_code	string 必需。发起请求的地点的 Unicode 国家/地区代码 (CLDR)，例如“US”和“419”。 如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#unicode_region_subtag。

PickupPoint

上车点或下车点的详细信息。

字段
id	string 取车点的唯一 ID。必须包含。
display_name	string 上车点的简短易懂名称。已根据请求中提供的偏好设置进行了本地化。
address	Address 上车点地址。
description	string 对上车点的详细说明，其中可能包括如何前往相应地点的内容。
location	LatLng 上车点的位置；乘客或接收者与司机会面的位置。必须包含。

PickupPointOrderEnums

用于指定匹配取货点的排序顺序的一组值。

PickupPointOrder

自提点订单的值。

枚举
PICKUP_POINT_ORDER_UNSPECIFIED	未指定自提点顺序。默认值为 DISTANCE_FROM_Origin。
DISTANCE_FROM_SEARCH_LOCATION	从搜索地点到返回的上车点的直线距离升序。
WALKING_ETA_FROM_SEARCH_LOCATION	按消费者从搜索位置到自提点的步行时间升序排列。
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION	按预计到达时间从自提点到达消费者目的地，升序订单。仅当已设置目的地且 compute_driving_eta 为 true 时，才能使用此模式。当请求中提供了多个 travel_mode 时，系统会根据请求中的第一个 travel_mode 进行排序。

PickupPointResult

有关上车点搜索结果的详细信息。

字段
pickup_point	PickupPoint 与请求匹配的实际上车点。
distance_meters	float 从此上车点到请求中指定的 search_location 的直线距离。
travel_details[]	TravelDetail 针对每个请求的出行方式，与从该上车点往返的行程相关的详细信息。

地点

某个地点的详细信息。

字段
place_id	string 地点的地点 ID。地点 ID 是唯一标识地点的文本。https://developers.google.com/places/web-service/place-id
display_name	string 已本地化的地点的名称。已根据请求中提供的偏好设置进行了本地化。
language_code	string 与地点相关联的文本字段的语言代码。例如，“姓名”和“地址”。
address	Address 地点的地址。
geometry	Geometry 地点的几何图形。
types[]	string 此结果的一组类型标记。例如，“political”和“locality”。https://developers.google.com/places/web-service/supported_types
associated_compounds[]	Compound 与该地点相关的化合物。

PlacePickupPointResult

具有关联地点 ID 的上车点。

字段
pickup_point_result	PickupPointResult 上车点的详细信息。必须包含。
associated_place_id	string 关联地点的地点 ID。

PlaceResult

关于地点搜索结果的详细信息。

字段
place	Place 某个地点的详细信息。
distance_meters	float 从搜索位置到地点几何图形或中心中心的直线距离。

TrafficRestrictionEnums

营业地点的路况限制类型。

TrafficRestriction

流量限制的值。

枚举
TRAFFIC_RESTRICTION_UNSPECIFIED	未指定限制。
NO_RESTRICTION	系统不会应用任何流量限制。
OTHER_RESTRICTION	可能会有一些交通限制，例如道路为私人所有，或者前往相关地点需要付费。

TravelDetail

与此次旅行相关的详细信息。

字段
travel_mode	TravelMode 用于计算预计到达时间的出行方式。
estimated_arrival_time	Timestamp 预计到达时间。在请求中设置了 compute_walking_eta 后，系统会计算从搜索位置到上车点位置的步行预计到达时间。在请求中设置了 compute_driving_eta 和 destination 的情况下，对于请求的每个非行人出行方式，系统会计算从上车点位置到目的地的驾车预计到达时间。行车预计到达时间是根据路况计算的，不受交通拥堵限制。
traffic_restriction	TrafficRestriction 适用于出行方式的限制。

TravelModeEnums

前往某地的出行方式适用的出行方式列表。

TravelMode

出行方式的值。

枚举
TRAVEL_MODE_UNSPECIFIED	未指定出行方式。
WALKING	步行，用于行人。
DRIVING	驾驶，用于载客汽车。
TWO_WHEELER	电动双轮机动车（例如摩托车或轻便摩托车）。

WiFiAccessPoint

Wi-Fi 接入点信息。

字段
mac_address	int64 接入点的 MAC 地址。
strength_dbm	sint32 接入点的信号强度（以 dBm 为单位）。