【Android】3.13 路径规划功能

分类：C#、Android、VS2015、百度地图应用； 创建日期：2016-02-04

一、简介

线路规划支持以下功能：

• 公交信息查询：可对公交详细信息进行查询；
• 公交换乘查询：根据起、终点，查询策略，进行线路规划方案；
• 驾车线路规划：提供不同策略，规划驾车路线；（支持设置途经点）
• 步行路径检索：支持步行路径的规划。

其中驾车线路规划自v3.4.0版本起支持多线路检索结果的能力。

二、运行截图

简介：介绍公交、驾车和步行三种线路规划方法和自设路线方法。

详述：

（1）驾车查询新增路径点查询功能，具体使用方法详见开发者指南路径规划部分，只需重载接口；

（2）自设路线功能演示开发者如何自己设定一条路线，包括如何设定起点、终点、途径站点和路段；

（3）自设路线功能同时也介绍如何在两个Activity之间切换的时候管理Mapview的生命周期；

（4）可自定义路线的起终点图标；

本示例运行截图如下：

三、设计步骤

1、添加自定义类【代码太多，就不再粘贴在这里了】

本示例用到的文件很多，主要涉及的是自定义覆盖物的相关类，这些文件都在SrcOverlayUtil文件夹下，除了上一节列出的OverlayManager.cs文件和PoiOverlay.cs外，还包括下面的文件。

（1）BikingRouteOverlay.cs文件

用于显示骑行路线的Overlay，自3.4.0版本起可实例化多个添加在地图中显示。

（2）BusLineOverlay.cs文件

用于显示一条公交详情结果的Overlay。

（3）DrivingRouteOverlay.cs文件

用于显示一条驾车路线的overlay，自3.4.0版本起可实例化多个添加在地图中显示，当数据中包含路况数据时，则默认使用路况纹理分段绘制。

（4）TransitRouteOverlay.cs文件

用于显示换乘路线的Overlay，自3.4.0版本起可实例化多个添加在地图中显示。

（5）WalkingRouteOverlay.cs文件

用于显示步行路线的overlay，自3.4.0版本起可实例化多个添加在地图中显示。

2、添加demo13_routeplan.xml文件

在layout文件夹下添加该文件，然后将代码改为下面的内容：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

    <LinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal" >
        <TextView
            android:id="@+id/textView1"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="起点：" />
        <EditText
            android:id="@+id/start"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:ems="10"
            android:text="龙泽" >
            <requestFocus />
        </EditText>
    </LinearLayout>

    <LinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal" >
        <TextView
            android:id="@+id/textView2"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="终点：" />
        <EditText
            android:id="@+id/end"
            android:layout_width="fill_parent"
            android:layout_height="wrap_content"
            android:ems="10"
            android:text="西单" >
            <requestFocus />
        </EditText>
    </LinearLayout>

    <LinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_marginBottom="5dip"
        android:layout_marginTop="5dip"
        android:orientation="horizontal" >
        <Button
            android:id="@+id/drive"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:layout_marginLeft="2dip"
            android:layout_marginRight="2dip"
            android:layout_weight="1.0"
            android:background="@drawable/button_style"
            android:text="驾车搜索" />
        <Button
            android:id="@+id/transit"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:layout_marginLeft="2dip"
            android:layout_marginRight="2dip"
            android:layout_weight="1.0"
            android:background="@drawable/button_style"
            android:text="公交搜索" />
        <Button
            android:id="@+id/walk"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:layout_marginLeft="2dip"
            android:layout_marginRight="2dip"
            android:layout_weight="1.0"
            android:background="@drawable/button_style"
            android:text="步行搜索" />
        <Button
            android:id="@+id/bike"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:layout_marginLeft="2dip"
            android:layout_marginRight="2dip"
            android:layout_weight="1.0"
            android:background="@drawable/button_style"
            android:text="骑行搜索" />
    </LinearLayout>

    <RelativeLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent" >

       <com.baidu.mapapi.map.TextureMapView
            android:id="@+id/map"
            android:layout_width="fill_parent"
            android:layout_height="fill_parent"
            android:clickable="true" />

       <LinearLayout
            xmlns:android="http://schemas.android.com/apk/res/android"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentRight="true"
            android:layout_alignParentTop="true"
            android:layout_alignWithParentIfMissing="false"
            android:layout_marginRight="10dp"
            android:layout_marginTop="10dip"
            android:orientation="vertical" >
            <Button
                android:id="@+id/customicon"
                android:layout_width="fill_parent"
                android:layout_height="fill_parent"
                android:layout_marginTop="10dip"
                android:layout_weight="1.0"
                android:background="@drawable/button_style"
                android:text="自定义起终点图标" />
        </LinearLayout>

        <LinearLayout
            xmlns:android="http://schemas.android.com/apk/res/android"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_alignParentBottom="true"
            android:layout_alignWithParentIfMissing="false"
            android:layout_centerHorizontal="true"
            android:layout_centerVertical="false"
            android:layout_marginBottom="10dip" >

            <Button
                android:id="@+id/pre"
                android:layout_width="fill_parent"
                android:layout_height="fill_parent"
                android:layout_marginLeft="2dip"
                android:layout_marginRight="2dip"
                android:layout_weight="1.0"
                android:background="@drawable/pre_" />

            <Button
                android:id="@+id/next"
                android:layout_width="fill_parent"
                android:layout_height="fill_parent"
                android:layout_marginLeft="2dip"
                android:layout_marginRight="2dip"
                android:layout_weight="1.0"
                android:background="@drawable/next_" />
        </LinearLayout>
    </RelativeLayout>

</LinearLayout>

3、添加Demo13RoutePlan.cs文件

在SrcSdkDemos文件夹下添加该文件，然后将代码改为下面的内容：

using Android.App;
using Android.Content.PM;
using Android.OS;
using Android.Views;
using Android.Widget;
using Com.Baidu.Mapapi.Map;
using Com.Baidu.Mapapi.Model;
using Com.Baidu.Mapapi.Search.Core;
using Com.Baidu.Mapapi.Search.Route;
using BdMapV371Demos.SrcOverlayUtil;

namespace BdMapV371Demos.SrcSdkDemos
{
    /// <summary>
    ///此demo用来展示如何进行驾车、步行、公交路线搜索并在地图使用RouteOverlay、TransitOverlay绘制，
    ///同时展示如何进行节点浏览并弹出泡泡。
    /// </summary>
    [Activity(Label = "@string/demo_name_route",
        ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.KeyboardHidden,
        ScreenOrientation = ScreenOrientation.Sensor)]
    public class Demo13RoutePlan : Activity
    {
        //浏览路线节点相关
        Button btnPre = null;//上一个节点
        Button btnNext = null;//下一个节点
        int nodeIndex = -2;//节点索引,供浏览节点时使用
        RouteLine route = null;
        OverlayManager routeOverlay = null;
        bool useDefaultIcon = false;
        private TextView popupText = null;//泡泡view

        //地图相关，使用MyRouteMapView目的是重写touch事件实现泡泡处理。
        //如果不处理touch事件，则无需继承，直接使用TextureMapView即可。
        TextureMapView mMapView = null;   // 地图View
        BaiduMap mBaidumap = null;
        //搜索相关
        RoutePlanSearch mSearch = null;    // 搜索模块，也可去掉地图模块独立使用

        protected override void OnCreate(Bundle savedInstanceState)
        {
            base.OnCreate(savedInstanceState);
            SetContentView(Resource.Layout.demo13_routeplan);

            //初始化地图
            mMapView = FindViewById<TextureMapView>(Resource.Id.map);
            mBaidumap = mMapView.Map;

            btnPre = FindViewById<Button>(Resource.Id.pre);
            btnNext = FindViewById<Button>(Resource.Id.next);
            btnPre.Visibility = ViewStates.Invisible;
            btnNext.Visibility = ViewStates.Invisible;

            //处理地图点击事件
            mBaidumap.MapClick += (s, e) =>
            {
                //LatLng point = e.P0;
                //Toast.MakeText(this, point.ToString(), ToastLength.Long).Show();
                mBaidumap.HideInfoWindow();
            };

            //--begin--初始化搜索模块，注册处理事件
            mSearch = RoutePlanSearch.NewInstance();
            //处理驾车搜索结果
            mSearch.GetDrivingRouteResult += (s, e) =>
            {
                var result = e.P0;
                if (result == null || result.Error != SearchResult.ERRORNO.NoError)
                {
                    Toast.MakeText(this, "抱歉，未找到结果", ToastLength.Short).Show();
                }
                if (result.Error == SearchResult.ERRORNO.AmbiguousRoureAddr)
                {
                    //起终点或途经点地址有岐义，通过result.SuggestAddrInfo属性获取建议查询信息
                    //......
                    return;
                }
                if (result.Error == SearchResult.ERRORNO.NoError)
                {
                    nodeIndex = -1;
                    btnPre.Visibility = ViewStates.Visible;
                    btnNext.Visibility = ViewStates.Visible;
                    route = result.RouteLines[0];
                    DrivingRouteOverlay overlay = new MyDrivingRouteOverlay(this, mBaidumap);
                    routeOverlay = overlay;
                    mBaidumap.MarkerClick += (sender, args) =>
                    {
                        //......
                    };
                    overlay.SetData(result.RouteLines[0]);
                    overlay.AddToMap();
                    overlay.ZoomToSpan();
                }
            };
            //处理公交搜索结果
            mSearch.GetTransitRouteResult += (s,e) =>
            {
                var result = e.P0;
                if (result == null || result.Error != SearchResult.ERRORNO.NoError)
                {
                    Toast.MakeText(this, "抱歉，未找到结果", ToastLength.Short).Show();
                }
                if (result.Error == SearchResult.ERRORNO.AmbiguousRoureAddr)
                {
                    //起终点或途经点地址有岐义，通过以下接口获取建议查询信息
                    //result.getSuggestAddrInfo()
                    return;
                }
                if (result.Error == SearchResult.ERRORNO.NoError)
                {
                    nodeIndex = -1;
                    btnPre.Visibility = ViewStates.Visible;
                    btnNext.Visibility = ViewStates.Visible;
                    route = result.RouteLines[0];
                    TransitRouteOverlay overlay = new MyTransitRouteOverlay(this, mBaidumap);
                    mBaidumap.MarkerClick += (sender, args) =>
                    {
                        //......
                    };
                    routeOverlay = overlay;
                    overlay.SetData(result.RouteLines[0]);
                    overlay.AddToMap();
                    overlay.ZoomToSpan();
                }
            };
            //处理步行搜索结果
            mSearch.GetWalkingRouteResult += (s, e) =>
            {
                var result = e.P0;
                if (result == null || result.Error != SearchResult.ERRORNO.NoError)
                {
                    Toast.MakeText(this, "抱歉，未找到结果", ToastLength.Short).Show();
                }
                if (result.Error == SearchResult.ERRORNO.AmbiguousRoureAddr)
                {
                    //起终点或途经点地址有岐义，通过以下接口获取建议查询信息
                    //result.getSuggestAddrInfo()
                    return;
                }
                if (result.Error == SearchResult.ERRORNO.NoError)
                {
                    nodeIndex = -1;
                    btnPre.Visibility = ViewStates.Visible;
                    btnNext.Visibility = ViewStates.Visible;
                    route = result.RouteLines[0];
                    WalkingRouteOverlay overlay = new MyWalkingRouteOverlay(this, mBaidumap);
                    mBaidumap.MarkerClick += (sender, args) =>
                    {
                        //......
                    };
                    routeOverlay = overlay;
                    overlay.SetData(result.RouteLines[0]);
                    overlay.AddToMap();
                    overlay.ZoomToSpan();
                }
            };
            //处理骑行搜索结果
            mSearch.GetBikingRouteResult += (s, e) =>
            {
                var result = e.P0;
                if (result == null || result.Error != SearchResult.ERRORNO.NoError)
                {
                    Toast.MakeText(this, "抱歉，未找到结果", ToastLength.Short).Show();
                }
                if (result.Error == SearchResult.ERRORNO.AmbiguousRoureAddr)
                {
                    // 如果起终点或途经点地址有岐义，可通过result.SuggestAddrInfo属性获取建议查询信息
                    //......
                    return;
                }
                if (result.Error == SearchResult.ERRORNO.NoError)
                {
                    nodeIndex = -1;
                    btnPre.Visibility = ViewStates.Visible;
                    btnNext.Visibility = ViewStates.Visible;
                    route = result.RouteLines[0];
                    BikingRouteOverlay overlay = new MyBikingRouteOverlay(this, mBaidumap);
                    routeOverlay = overlay;
                    mBaidumap.MarkerClick += (sender, args) =>
                    {
                        //......
                    };
                    overlay.SetData(result.RouteLines[0]);
                    overlay.AddToMap();
                    overlay.ZoomToSpan();
                }
            };
            //--end--初始化搜索模块，注册监听事件

            //处理【驾车搜素】按钮点击事件
            var btnDrive = FindViewById<Button>(Resource.Id.drive);
            btnDrive.Click += delegate
            {
                SearchButtonProcess(Resource.Id.drive);
            };

            //处理【公交搜素】按钮点击事件
            var btnTransit = FindViewById<Button>(Resource.Id.transit);
            btnTransit.Click += delegate
            {
                SearchButtonProcess(Resource.Id.transit);
            };

            //处理【步行搜素】按钮点击事件
            var btnWalk = FindViewById<Button>(Resource.Id.walk);
            btnWalk.Click += delegate
            {
                SearchButtonProcess(Resource.Id.walk);
            };

            //处理【骑行搜素】按钮点击事件
            var btnBike = FindViewById<Button>(Resource.Id.bike);
            btnBike.Click += delegate
            {
                SearchButtonProcess(Resource.Id.bike);
            };

            //处理【自定义起终点图标】按钮点击事件
            var btnCustomicon = FindViewById<Button>(Resource.Id.customicon);
            btnCustomicon.Click += delegate
            {
                //切换路线图标，刷新地图使其生效。注意：起终点图标使用中心对齐。
                if (routeOverlay == null) return;
                if (useDefaultIcon)
                {
                    btnCustomicon.Text = "自定义起终点图标";
                    Toast.MakeText(this,"将使用系统起终点图标", ToastLength.Short).Show();
                }
                else
                {
                    btnCustomicon.Text = "系统起终点图标";
                    Toast.MakeText(this, "将使用自定义起终点图标", ToastLength.Short).Show();
                }
                useDefaultIcon = !useDefaultIcon;
                routeOverlay.RemoveFromMap();
                routeOverlay.AddToMap();
            };

            //处理节点浏览相关的按钮事件
            btnPre.Click += delegate
            {
                NodeClick(Resource.Id.pre);
            };
            btnNext.Click += delegate
            {
                NodeClick(Resource.Id.next);
            };
        }

        /// <summary>
        /// 发起路线规划搜索
        /// </summary>
        /// <param name="id">按钮的id</param>
        public void SearchButtonProcess(int id)
        {
            //重置浏览节点的路线数据
            route = null;
            btnPre.Visibility = ViewStates.Invisible;
            btnNext.Visibility = ViewStates.Invisible;
            mBaidumap.Clear();
            // 处理搜索按钮响应示例
            EditText editSt = FindViewById<EditText>(Resource.Id.start);
            EditText editEn = FindViewById<EditText>(Resource.Id.end);
            //设置起终点信息，对于tranist search 来说，城市名无意义
            PlanNode stNode = PlanNode.WithCityNameAndPlaceName("北京", editSt.Text);
            PlanNode enNode = PlanNode.WithCityNameAndPlaceName("北京", editEn.Text);

            // 实际使用中请对起点终点城市进行正确的设定
            if (id == Resource.Id.drive)
            {
                mSearch.DrivingSearch(new DrivingRoutePlanOption()
                    .From(stNode).To(enNode));
            }
            else if (id == Resource.Id.transit)
            {
                mSearch.TransitSearch(new TransitRoutePlanOption()
                    .From(stNode).City("北京").To(enNode));
            }
            else if (id == Resource.Id.walk)
            {
                mSearch.WalkingSearch(new WalkingRoutePlanOption()
                    .From(stNode).To(enNode));
            }
            else if (id == Resource.Id.bike)
            {
                mSearch.BikingSearch(new BikingRoutePlanOption()
                    .From(stNode).To(enNode));
            }
        }

        /// <summary>
        /// 节点浏览示例
        /// </summary>
        /// <param name="id">按钮的id</param>
        public void NodeClick(int id)
        {
            if (nodeIndex < -1 || route == null ||
                route.AllStep == null || nodeIndex > route.AllStep.Count)
            {
                return;
            }
            //设置节点索引
            if (id == Resource.Id.next && nodeIndex < route.AllStep.Count - 1)
            {
                nodeIndex++;
            }
            else if (id == Resource.Id.pre && nodeIndex > 1)
            {
                nodeIndex--;
            }
            if (nodeIndex < 0 || nodeIndex >= route.AllStep.Count)
            {
                return;
            }

            //获取节结果信息
            LatLng nodeLocation = null;
            string nodeTitle = null;
            var step = route.AllStep[nodeIndex];
            if (step is DrivingRouteLine.DrivingStep)
            {
                nodeLocation = ((DrivingRouteLine.DrivingStep)step).Entrance.Location;
                nodeTitle = ((DrivingRouteLine.DrivingStep)step).Instructions;
            }
            else if (step is WalkingRouteLine.WalkingStep)
            {
                nodeLocation = ((WalkingRouteLine.WalkingStep)step).Entrance.Location;
                nodeTitle = ((WalkingRouteLine.WalkingStep)step).Instructions;
            }
            else if (step is TransitRouteLine.TransitStep)
            {
                nodeLocation = ((TransitRouteLine.TransitStep)step).Entrance.Location;
                nodeTitle = ((TransitRouteLine.TransitStep)step).Instructions;
            }

            if (nodeLocation == null || nodeTitle == null)
            {
                return;
            }
            //移动节点至中心
            mBaidumap.SetMapStatus(MapStatusUpdateFactory.NewLatLng(nodeLocation));
            // Show popup
            popupText= new TextView(this);
            popupText.SetBackgroundResource(Resource.Drawable.popup);
            popupText.SetTextColor(Android.Graphics.Color.Black);
            popupText.Text = nodeTitle;
            mBaidumap.ShowInfoWindow(new InfoWindow(popupText, nodeLocation, 0));
        }

        protected override void OnRestoreInstanceState(Bundle savedInstanceState)
        {
            base.OnRestoreInstanceState(savedInstanceState);
        }

        //定制RouteOverly
        private class MyDrivingRouteOverlay : DrivingRouteOverlay
        {
            Demo13RoutePlan routePlanDemo;

            public MyDrivingRouteOverlay(Demo13RoutePlan routePlanDemo, BaiduMap baiduMap) :
                base(baiduMap)
            {
                this.routePlanDemo = routePlanDemo;
            }

            public override BitmapDescriptor GetStartMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_st);
                }
                return null;
            }

            public override BitmapDescriptor GetTerminalMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_en);
                }
                return null;
            }
        }

        private class MyWalkingRouteOverlay : WalkingRouteOverlay
        {
            Demo13RoutePlan routePlanDemo;
            public MyWalkingRouteOverlay(Demo13RoutePlan routePlanDemo, BaiduMap baiduMap) :
                base(baiduMap)
            {
                this.routePlanDemo = routePlanDemo;
            }

            public new BitmapDescriptor GetStartMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_st);
                }
                return null;
            }

            public new BitmapDescriptor GetTerminalMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_en);
                }
                return null;
            }
        }

        private class MyTransitRouteOverlay : TransitRouteOverlay
        {
            Demo13RoutePlan routePlanDemo;

            public MyTransitRouteOverlay(Demo13RoutePlan routePlanDemo, BaiduMap baiduMap) :
                base(baiduMap)
            {
                this.routePlanDemo = routePlanDemo;
            }

            public override BitmapDescriptor GetStartMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_st);
                }
                return null;
            }

            public override BitmapDescriptor GetTerminalMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_en);
                }
                return null;
            }
        }

        private class MyBikingRouteOverlay : BikingRouteOverlay
        {
            Demo13RoutePlan routePlanDemo;
            public MyBikingRouteOverlay(Demo13RoutePlan routePlanDemo, BaiduMap baiduMap) : base(baiduMap)
            {
                this.routePlanDemo = routePlanDemo;
            }

            public new BitmapDescriptor GetStartMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_st);
                }
                return null;
            }

            public new BitmapDescriptor GetTerminalMarker()
            {
                if (routePlanDemo.useDefaultIcon)
                {
                    return BitmapDescriptorFactory.FromResource(Resource.Drawable.icon_en);
                }
                return null;
            }
        }

        protected override void OnPause()
        {
            mMapView.OnPause();
            base.OnPause();
        }

        protected override void OnResume()
        {
            mMapView.OnResume();
            base.OnResume();
        }

        protected override void OnDestroy()
        {
            mSearch.Destroy();
            mMapView.OnDestroy();
            base.OnDestroy();
        }
    }
}

4、修改MainActivity.cs

在MainActivity.cs文件的demos字段定义中，去掉【示例13】下面的注释。

运行观察结果。