Package google.maps.isochrones.v1

索引

• IsochroneService（接口）
• GenerateIsochroneRequest（消息）
• GenerateIsochroneRequest.PolygonFidelity（枚举）
• GenerateIsochroneRequest.RoutingPreference（枚举）
• GenerateIsochroneRequest.TravelDirection（枚举）
• GenerateIsochroneRequest.TravelMode（枚举）
• GenerateIsochroneResponse（消息）
• Isochrone（消息）

IsochroneService

用于计算等时线的服务。等时圈是指从指定出发点出发，在指定行程时间内可到达的区域。

GenerateIsochrone
rpc GenerateIsochrone(GenerateIsochroneRequest) returns (GenerateIsochroneResponse) 计算并返回一组给定参数的单个等时线。

GenerateIsochroneRequest

生成单个等时线的请求。

字段
travel_duration	Duration 必需。等时线计算的行程时间。该值必须为正数，上限为 7200 秒（120 分钟）。对于 DRIVE 模式，允许的最大时长为 3600 秒（60 分钟）。
travel_mode	TravelMode 必需。交通方式。
travel_direction	TravelDirection 必需。出行方向。
routing_preference	RoutingPreference 可选。指定路由偏好设置。默认值为 TRAFFIC_UNAWARE。
enable_smoothing	bool 可选。指定是否平滑处理生成的等时面多边形的边缘。
polygon_fidelity	PolygonFidelity 可选。控制生成的多边形的精度。默认值为 POLYGON_FIDELITY_UNSPECIFIED。
联合字段 origin。必需。等时线计算的出发地。origin 只能是下列其中一项：
location	LatLng 以纬度/经度坐标表示的原点。
place	string 地点的资源名称，格式为 places/{place_id}。

PolygonFidelity

控制等时面多边形的详细程度。

枚举
POLYGON_FIDELITY_UNSPECIFIED	未指定多边形保真度。服务器将使用其默认值，该值基于出行时长。
LOW	精确度低。适合使用较少的顶点覆盖大面积区域。
MEDIUM	中等精度。细节和制品大小之间的平衡。
HIGH	高精确度。边缘保真度高，但在道路网络密度较低的区域，可能会在多边形中产生孔洞。

RoutingPreference

确定如何将路况信息纳入计算。

枚举
ROUTING_PREFERENCE_UNSPECIFIED	未指定任何路线偏好设置。服务器将使用其默认值 TRAFFIC_UNAWARE。
TRAFFIC_UNAWARE	计算时不会考虑路况信息。等时线将基于道路网和静态行程时间。这适用于路况不是影响因素的规划目的。
TRAFFIC_AWARE	计算时会考虑实时路况信息。

TravelDirection

指定等时线计算的出行方向。

枚举
TRAVEL_DIRECTION_UNSPECIFIED	未指定出行方向。
FROM	计算从原点可到达的区域的面积。示例：“从我的仓库出发，30 分钟内可以送达哪些地点？”
TO	计算从哪些区域出发可以到达原点。示例：“我的员工从哪些地方通勤可以在 30 分钟内到达办公室？”

TravelMode

定义等时线计算的交通方式。

枚举
TRAVEL_MODE_UNSPECIFIED	未指定出行方式。
DRIVE	乘坐客车出行。
BICYCLE	骑自行车出行。
WALK	步行出行。

GenerateIsochroneResponse

包含生成的等时线数据的响应。

字段
isochrone	Isochrone 仅限输出。生成的等时线。

等时线

等时圈计算结果，表示从起点在指定行程时间内可到达的区域。

字段
联合字段 geometry。等时线的几何表示形式。geometry 只能是下列其中一项：
geo_json	Struct 采用 GeoJSON 格式的等时线几何图形，使用 RFC 7946 格式：https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6。