使用折线

欧洲经济区 (EEA) 开发者

computeRoutes 方法会在响应中返回由多段线表示的路线。您可以请求两种类型的多段线:

  • 基本多段线(默认):表示路线,但多段线中未嵌入路况信息。返回基本多段线的请求按 Routes Basic 费率计费。 详细了解 Routes API 的结算。
  • 感知路况的多段线,包含沿途路况信息。路况信息以适用于多段线给定区间的速度类别(NORMAL、SLOW、TRAFFIC_JAM)表示。对感知路况的多段线的请求按 Routes Preferred 费率结算。 详细了解 Routes API 的结算。
  • 多模态多段线,包含公交详情以及路况信息。对多模态多段线的请求按 Routes Preferred 费率结算。 详细了解 Routes API 的结算。

基本多段线(默认)

多段线由 Polyline 对象表示;路径是 LatLngAltitude 坐标数组。 如需返回基本多段线,请调用 computeRoutes 方法,并将 fields 属性设置为 path,然后对路线实例调用 createPolylines 方法,以获取 Polyline 对象。

以下示例展示了如何请求基本多段线:

// Define a basic routes request.
const requestWithBasicPolyline = {
  origin: '155 Steuart St, San Francisco, CA 94105',
  destination: '450 Powell St, San Francisco, CA 94102',
  travelMode: 'WALKING',
  fields: ['path'],  // Request path field to get a polyline.
};
  

感知路况的多段线

如需请求获取考虑路况的多段线,请在请求中添加以下属性:

  1. 将 travelMode 属性设置为 DRIVING。
  2. 将 routingPreference 属性设置为 TRAFFIC_AWARE。
  3. 将 extraComputations 属性设置为 TRAFFIC_ON_POLYLINE。
  4. 指定 path、speedPaths 和 routeLabels 字段。

以下示例展示了如何请求考虑路况的多段线:

// Define a traffic aware routes request.
const requestWithTraffic = {
  origin: '200 King St San Francisco, CA 94107',
  destination: 'Pier 41, San Francisco, CA 94133',
  travelMode: 'DRIVING',
  routingPreference: 'TRAFFIC_AWARE',
  extraComputations: ['TRAFFIC_ON_POLYLINE'],
  fields: ['speedPaths'],
};
  

在地图上显示多段线

如需在地图上显示多段线,请对路线对象调用 createPolylines,然后使用 setMap 方法将多段线的地图设置为地图对象。地图对象用于在地图上显示多段线。

以下示例展示了如何在地图上显示多段线:

  // Call createPolylines to create polylines for the first route.
  mapPolylines = routes[0].createPolylines();
  // Add polylines to the map.
  mapPolylines.forEach((polyline) => polyline.setMap(map));
    

在 3D 地图上显示多段线

在 v=beta 渠道中,您可以通过添加 <gmp-route-3d> 子元素,在 <gmp-map-3d> 元素上以声明方式呈现路线多段线、起点和终点标记以及摘要弹出式窗口 - 请参阅在 3D 地图上显示路线。

如果您需要中间航点、自定义字段掩码或自定义多段线样式,请对 Route 实例调用 create3DPolylines,以创建 Polyline3DElement 对象并将其附加到 <gmp-map-3d>。如需了解如何加载 Beta 渠道,请参阅版本控制。以下示例会创建并附加 3D 路线多段线:

const polylines3D = await routes[0].create3DPolylines({
  polylineOptions: { strokeWidth: 10, autofitsCamera: true },
});
map3DElement.append(...polylines3D);