DrivingRoute

用于获取驾车路线规划方案。

构造函数

  • 创建驾车路线规划实例

    参数类型说明
    locationstring检索区域，可以是地图实例、坐标点或城市名称字符串
    opts 可选DrivingRouteOptions可选参数
    属性类型说明
    onInfoHtmlSetFunction标注气泡内容创建后的回调函数
    onMarkersSetFunction标注添加完成后的回调函数，参数为起终点 POI 数组
    onPolylinesSetFunction路线折线添加完成后的回调函数，参数为折线覆盖物数组
    onResultsHtmlSetFunction结果列表创建后的回调函数
    onSearchCompleteFunction检索完成后的回调函数
    policyDrivingPolicy驾车路线规划策略
    renderOptionsRenderOptions结果呈现设置

    返回值 DrivingRoute

    示例代码1

    // 设置 renderOptions.map，路线和标注自动渲染到地图上
    const drivingRoute = new BMap.DrivingRoute(map, {
      renderOptions: { map: map, autoViewport: true },
      onSearchComplete(results) {
        console.log('路线已自动绘制到地图');
      },
    });
    drivingRoute.search(new BMap.Point(116.391, 39.910), new BMap.Point(116.431, 39.931));

    示例代码2

    // 设置展示面板 + viewportOptions.margins 避免面板遮挡路线聚焦区域
    const drivingRoute = new BMap.DrivingRoute(map, {
      renderOptions: {
        map: map,
        panel: 'route-panel',
        autoViewport: true,
        viewportOptions: { margins: [20, 20, 20, 300] },
      },
      onSearchComplete(results) {
        console.log('路线已绘制，结果面板已展示');
      },
    });
    drivingRoute.search(new BMap.Point(116.391, 39.910), new BMap.Point(116.431, 39.931));

    示例代码3

    // 纯回调用法，不自动渲染到地图
    const drivingRoute = new BMap.DrivingRoute(map, {
      onSearchComplete(results) {
        if (drivingRoute.getStatus() === 0) {
          const plan = results.getPlan(0);
          console.log('驾车距离：', plan.getDistance(true));
        }
      },
    });

方法

  • 清除最近一次检索的结果，同时清除地图上的路线和标注

    返回值 void

  • 禁用自动调整地图视野

    返回值 void

  • 启用自动调整地图视野，当指定了搜索结果展现的地图时有效

    返回值 void

  • 发起驾车路线检索。驾车不支持关键字检索，起终点必须为坐标或 POI

    参数类型说明
    startPoint起点
    endPoint终点

    返回值 void

    示例代码1

    drivingRoute.search(new BMap.Point(116.391, 39.910), new BMap.Point(116.431, 39.931));

  • 设置气泡打开后的回调函数

    参数类型说明
    callback(poi: LocalResultPoi, html: HTMLElement) => void回调函数

    返回值 void

    示例代码1

    drivingRoute.setInfoHtmlSetCallback((poi, html) => {
      console.log(poi.title, html.innerHTML);
    });

  • 设置检索区域

    参数类型说明
    locationstring地图实例、坐标点或城市名称字符串

    返回值 void

    示例代码1

    drivingRoute.setLocation('北京');

  • 设置标注添加完成后的回调函数

    参数类型说明
    callback(pois: LocalResultPoi[]) => void回调函数，参数为起终点 POI 数组

    返回值 void

    示例代码1

    drivingRoute.setMarkersSetCallback((pois) => {
      pois.forEach(poi => console.log(poi.title));
    });

  • 设置驾车路线规划策略

    参数类型说明
    policyDrivingPolicy策略常量

    返回值 void

    示例代码1

    drivingRoute.setPolicy(BMAP_DRIVING_POLICY_AVOID_HIGHWAYS);

  • 设置路线折线添加完成后的回调函数

    参数类型说明
    callback(polylines: Polyline[]) => void回调函数，参数为折线覆盖物数组

    返回值 void

    示例代码1

    drivingRoute.setPolylinesSetCallback((polylines) => {
      polylines.forEach(pl => pl.setStrokeColor('blue'));
    });

  • 设置结果列表创建后的回调函数

    参数类型说明
    callback(container: HTMLElement) => void回调函数

    返回值 void

    示例代码1

    drivingRoute.setResultsHtmlSetCallback((container) => {
      document.getElementById('results').appendChild(container);
    });

  • 设置检索结束后的回调函数

    参数类型说明
    callback(results: DrivingRouteResult) => void回调函数

    返回值 void

    示例代码1

    drivingRoute.setSearchCompleteCallback((results) => {
      console.log('方案数:', results.getNumPlans());
    });