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	按从上车点到乘客目的地的预计驾车时间（ETA）从高到低排序。仅当设置了目的地且 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 与地点关联的文本字段的语言代码。例如“name”和“address”。
address	Address 地点的地址。
geometry	Geometry 地点的几何图形。
types[]	string 此结果的一组类型标记。例如，“政治”和“行政区划”。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 和目的地后，系统会为请求的每种非步行出行方式计算从上车点到目的地的预计驾车时间。行车预计到达时间根据路况计算，不受交通拥堵限制。
traffic_restriction	TrafficRestriction 适用于相应出行方式的限制。

TravelModeEnums

可用于前往某个地点的出行方式列表。

TravelMode

出行方式的值。

枚举
TRAVEL_MODE_UNSPECIFIED	未指定出行方式。
WALKING	步行，适用于行人。
DRIVING	驾车，适用于乘用车。
TWO_WHEELER	机动两轮车（例如摩托车或助力车）。

WiFiAccessPoint

Wi-Fi 接入点信息。

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