jspopular

简介

提供的出行方式包括公交、驾车、步行。开发者可以使用我们提供的默认展示效果，也可通过结果面板或数据接口获取返回结果，自己编写实现界面。图片支持自定义。

提供的路线规划方式

路线规划方式	类名	简介
公交	TransitRoute	提供公交路线规划搜索服务
驾车	DrivingRoute	提供驾车路线规划服务
步行	WalkingRoute	提供步行路线规划服务

驾车路线规划

BMap.DrivingRoute提供驾车导航服务。与公交导航不同的是，驾车导航的搜索范围可以设置为省。

1使用服务示例

代码如下：

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);    
var driving = new BMap.DrivingRoute(map, {    
    renderOptions: {    
        map: map,    
        autoViewport: true    
    }    
});    
driving.search("中关村", "天安门");

2结果面板

下面示例中，我们提供了结果面板参数，方案描述会自动展示到页面上。

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);    
var driving = new BMap.DrivingRoute(map, {    
    renderOptions: {    
        map   : map,     
        panel : "results",    
        autoViewport: true    
    }    
});    
driving.search("中关村", "天安门");

3数据接口

驾车导航服务也提供了丰富的数据接口，通过onSearchComplete回调函数可以得到BMap.DrivingRouteResult对象，它包含了驾车导航结果数据信息。结果会包含若干驾车方案（目前仅提供一条方案），每条方案中包含了若干驾车线路（如果导航方案只包含一个目的地，那么驾车线路的个数就为1，如果方案包含若干个目的地，则驾车线路的个数会大于1。目前API尚不支持多个目的地的驾车导航）。每条驾车线路又会包含一系列的关键步骤（BMap.Step），关键步骤描述了具体驾车行驶方案，可通过BMap.Step.getDescription()方法获得。

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);    
var options = {    
    onSearchComplete: function(results){    
        if (driving.getStatus() == BMAP_STATUS_SUCCESS){    
            // 获取第一条方案   
            var plan = results.getPlan(0);      
            // 获取方案的驾车线路   
            var route = plan.getRoute(0);      
            // 获取每个关键步骤，并输出到页面   
            var s = [];    
            for (var i = 0; i < route.getNumSteps(); i ++){    
                var step = route.getStep(i);    
                s.push((i + 1) + ". " + step.getDescription());    
            }    
            document.getElementById("log").innerHTML = s.join("<br>");    
        }    
    }    
};    
var driving = new BMap.DrivingRoute(map, options); 
driving.search("中关村","天安门");

公交路线规划

BMap.TransitRoute类提供公交导航搜索服务。在搜索之前需要指定搜索区域。注意：公交导航的区域范围只能是市，而不能是省。如果搜索区域为BMap.Map对象，路线结果会自动添加到地图上。如果您提供了结果容器，相应的路线描述也会展示在页面上。

1使用服务示例

代码如下：

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);    
var transit = new BMap.TransitRoute(map, {    
    renderOptions: {map: map}    
});    
transit.search("王府井", "西单");

2结果面板

您可以提供用于展示文字结果的容器元素，方案结果会自动在页面中展现：

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);    
var transit = new BMap.TransitRoute(map, {    
    renderOptions: {map: map, panel: "results"}    
});    
transit.search("王府井", "西单");

3数据接口

您可通过数据接口获取详细的公交方案信息。公交导航搜索结果用BMap.TransitRouteResult来表示，其中包含了若干公交出行方案（BMap.TransitRoutePlan）。每条出行方案由步行线路和公交线路组成。在起点到上车点之间、下车点到终点之间以及每个换乘站之间都会存在步行线路，如果上述的某两点位置重合，那么其间的步行路线长度为0。如下示例，通过数据接口将第一条方案的路线添加到地图上，并将所有方案的描述信息输出到页面上。

var map = new BMap.Map("container");    
map.centerAndZoom(new BMap.Point(116.404, 39.915), 12);    
var transit = new BMap.TransitRoute("北京市");    
transit.setSearchCompleteCallback(function(results){    
    if (transit.getStatus() == BMAP_STATUS_SUCCESS){    
        var firstPlan = results.getPlan(0);    
        // 绘制步行线路    
        for (var i = 0; i < firstPlan.getNumRoutes(); i ++){    
            var walk = firstPlan.getRoute(i);    
            if (walk.getDistance(false) > 0){    
                // 步行线路有可能为0  
                map.addOverlay(new BMap.Polyline(walk.getPoints(), {lineColor: "green"}));    
            }    
        }    
        // 绘制公交线路   
        for (i = 0; i < firstPlan.getNumLines(); i ++){    
            var line = firstPlan.getLine(i);    
           map.addOverlay(new BMap.Polyline(line.getPoints()));    
        }    
       // 输出方案信息  
        var s = [];    
        for (i = 0; i < results.getNumPlans(); i ++){    
            s.push((i + 1) + ". " + results.getPlan(i).getDescription());    
        }    
        document.getElementById("log").innerHTML = s.join("<br>");    
    }    
})    
transit.search("中关村", "国贸桥");

步行路线规划

BMap.WalkingRoute提供步行线路规划服务。基本用法和驾车线路规划类似。

1使用服务示例

代码如下：

var map = new BMap.Map("container");    
    map.centerAndZoom(new BMap.Point(116.404, 39.915), 14);    
    var walk = new BMap.WalkingRoute(map, {    
        renderOptions: {map: map}    
    });    
walk.search("王府井", "西单");

文档全面上新