Windows Phone BingMap控件计算路径
一．实现过程
首先需要一个Key,可上官网免费注册
二．添加服务引用
这个是地图服务：
http://dev.virtualearth.net/webservices/v1/geocodeservice/geocodeservice.svc
这个是计算路径服务：
http://dev.virtualearth.net/webservices/v1/routeservice/routeservice.svc
一般只要这两个就可以了。如果需要实现搜索服务，则需要添加SearchService服务。
http://dev.virtualearth.net/webservices/v1/searchservice/searchservice.svc
此时的项目视图如下所示：
三．添加服务之后需要修改配置文件：
ServiceReferences.ClientConfig.将配置文件修改如下所示：
<configuration> <system.serviceModel> <bindings> <basicHttpBinding> <binding name="BasicHttpBinding_IGeocodeService" maxBufferSize="2147483647" maxReceivedMessageSize="2147483647"> <security mode="None"> <transport> <extendedProtectionPolicy policyEnforcement="Never" /> </transport> </security> </binding> <binding name="BasicHttpBinding_IRouteService" maxBufferSize="2147483647" maxReceivedMessageSize="2147483647"> <security mode="None" /> </binding> </basicHttpBinding> <customBinding> <binding name="CustomBinding_IGeocodeService"> <binaryMessageEncoding /> <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" /> </binding> <binding name="CustomBinding_IRouteService"> <binaryMessageEncoding /> <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" /> </binding> </customBinding> </bindings> <client> <endpoint address="http://dev.virtualearth.net/webservices/v1/geocodeservice/GeocodeService.svc" binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_IGeocodeService" contract="GeocodeService.IGeocodeService" name="BasicHttpBinding_IGeocodeService" /> <endpoint address="http://dev.virtualearth.net/webservices/v1/geocodeservice/GeocodeService.svc" binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_IGeocodeService1" contract="GeocodeService.IGeocodeService" name="BasicHttpBinding_IGeocodeService1" /> <endpoint address="http://dev.virtualearth.net/webservices/v1/geocodeservice/GeocodeService.svc/binaryHttp" binding="customBinding" bindingConfiguration="CustomBinding_IGeocodeService" contract="GeocodeService.IGeocodeService" name="CustomBinding_IGeocodeService" /> <endpoint address="http://dev.virtualearth.net/webservices/v1/routeservice/routeservice.svc" binding="basicHttpBinding" bindingConfiguration="BasicHttpBinding_IRouteService" contract="RouteService.IRouteService" name="BasicHttpBinding_IRouteService" /> <endpoint address="http://dev.virtualearth.net/webservices/v1/routeservice/routeservice.svc/binaryHttp" binding="customBinding" bindingConfiguration="CustomBinding_IRouteService" contract="RouteService.IRouteService" name="CustomBinding_IRouteService" /> </client> </system.serviceModel> </configuration>
以上的内容配置了三个服务的引用。
四．添加BingMap服务引用请求代码(方法)
该函数包含一个string类型和一个int类型变量，string类型变量用来存储地址，int类型变量用来存储位置坐标点的索引
示例代码如下：
1 private void Geocode(string strAddress, int waypointIndex) 2 { 3 //声明一个GeocodeService的客户端变量，并通过其GeocodeCompleted属性设置其回调方法 4 GeocodeService.GeocodeServiceClient geocodeService = new GeocodeService.GeocodeServiceClient("BasicHttpBinding_IGeocodeService"); 5 geocodeService.GeocodeCompleted += new EventHandler<GeocodeService.GeocodeCompletedEventArgs>(geocodeService_GeocodeCompleted); 6 //声明一个获取服务请求的变量，由于必须要一个Key值作为提供服务的凭据，微软的服务器才会提供BingMap的服务，所以利用ApplicationId这个属性绑定到我们的Key 7 GeocodeService.GeocodeRequest geocodeRequest = new GeocodeService.GeocodeRequest(); 8 geocodeRequest.Credentials = new Credentials(); 9 geocodeRequest.Credentials.ApplicationId = ((ApplicationIdCredentialsProvider)bingmap.CredentialsProvider).ApplicationId; 10 //设定请求查询的地址 11 geocodeRequest.Query = strAddress; 12 //发送异步调用的请求，并通过waypointIndex来跟踪不同的请求并识别返回的结果 13 geocodeService.GeocodeAsync(geocodeRequest, waypointIndex); 14 }
下面是GeocodeCompleted的回调函数。
由于异步发送Geocde请求，所以需要处理回调函数返回的请求结果，这里回调函数返回的结果包含用户的状态，以及查询地点的经纬度等。在回调函数中我们需要保存这些信息，因为在后面计算路径的方法中需要用到这些信息。同时这里我们还需判断geocodeResaults中的元素是否为空，如果为空则表示还有请求未被处理，若都不为空，则开始计算路径。
1 private void geocodeService_GeocodeCompleted(object sender, GeocodeService.GeocodeCompletedEventArgs e) 2 { 3 //检索反馈(Response)回来的用户的状态来鉴别用请求符合那种情况,这里的e.UserState其实就等于之前的waypointIndex 4 int waypointIndex = System.Convert.ToInt32(e.UserState); 5 //检索反馈回来的GeocodeResault，并将它存储在全局变量geocodeResaults数组中 6 geocodeResults[waypointIndex] = e.Result.Results[0]; 7 //这个变量用来判断geocodeResault数组是否被填满，如果未填满则表明还有请求未处理 8 bool doneGeocoding = true; 9 foreach (GeocodeService.GeocodeResult gr in geocodeResults) 10 { 11 if (gr == null) 12 { 13 doneGeocoding = false; 14 } 15 } 16 //如果所有的请求都已得到处理，则进行路径的计算 17 if (doneGeocoding) 18 { 19 // CaculateRoute是用于计算路径的函数，将在先一步定于这个函数。 20 CaculateRoute(geocodeResults); 21 } 22 }
接着我们定义一个全局变量，这个变量用来存储请求返回来的结果，并应用于之后的路径计算。
internal GeocodeService.GeocodeResult[] geocodeResults;
五.在我们的请求得到应答，并对返回的数据进行处理之后，如果满足条件，我们将进行下一步，那就是计算两个地点的路径，因此我们需要将之前请求的结果 geocodeResults 传入进来，以供我们的计算。
下面是具体实现的代码：
1 private void CaculateRoute(GeocodeService.GeocodeResult[] results) 2 { 3 //定义路径计算服务的客户端变量，并声明其回调方法 4 RouteService.RouteServiceClient routeService = new RouteService.RouteServiceClient("BasicHttpBinding_IRouteService"); 5 routeService.CalculateRouteCompleted += new EventHandler<RouteService.CalculateRouteCompletedEventArgs>(routeService_CalculateRouteCompleted); 6 //设置RouteService的一些属性以及获取服务的Key 7 RouteService.RouteRequest routeRequest = new RouteService.RouteRequest(); 8 routeRequest.Credentials = new Credentials(); 9 routeRequest.Credentials.ApplicationId = ((ApplicationIdCredentialsProvider)bingmap.CredentialsProvider).ApplicationId; 10 //返回计算路径的点，以便在地图上画出 11 routeRequest.Options = new RouteService.RouteOptions(); 12 routeRequest.Options.RoutePathType = RouteService.RoutePathType.Points; 13 //通过使用GeocodeService服务所得到的geocodeResults，来设定用于计算路径的点。 14 routeRequest.Waypoints = new System.Collections.ObjectModel.ObservableCollection<RouteService.Waypoint>(); 15 foreach (GeocodeService.GeocodeResult result in results) 16 { 17 //将存储在GeocodeService.GeocodeResult中的点(包含经纬度等信息)添加到Waypoints集合中 18 // GeocodeResultToWaypoint为自定义的一个函数(下一步声明)，该函数的作用是将geocodeResults中的点的信息的结果转化为具体的点，即Waypoint,这样才可以进行路径的计算，在转化之后我们就可发送计算路径的请求，计算两点之间的路劲 19 routeRequest.Waypoints.Add(GeocodeResultToWaypoint(result)); 20 } 21 //异步调用计算路径的服务请求 22 routeService.CalculateRouteAsync(routeRequest); 23 } 24 这是将GeocodeResult转化为Waypoint类型的自定义函数： 25 26 //将GeocodeResult中的坐标信息转化为具体的点的信息（Waypoint) 27 Private RouteService.Waypoint GeocodeResultToWaypoint 28 (GeocodeService.GeocodeResult result) 29 { 30 RouteService.Waypoint waypoint = new RouteService.Waypoint(); 31 waypoint.Description = result.DisplayName; 32 waypoint.Location = new Location(); 33 waypoint.Location.Latitude = result.Locations[0].Latitude; 34 waypoint.Location.Longitude = result.Locations[0].Longitude; 35 return waypoint; 36 }
接着我们需要处理计算路径的的回调函数，在回调函数中需要处理的是我们请求服务的结果，当计算路径的服务请求成功，且路径数不为0，即大于等于1条时，我们则将这条路径画出来，并在地图上显示。代码如下：
1 //CaculateRoute的回调函数 2 private void routeService_CalculateRouteCompleted(object sender, RouteService.CalculateRouteCompletedEventArgs e) 3 { 4 //如果计算路径成功，且路线条数不为0,则绘出路线 5 if ((e.Result.ResponseSummary.StatusCode == RouteService.ResponseStatusCode.Success) & (e.Result.Result.Legs.Count != 0)) 6 { 7 //设置绘制路线画笔的属性 8 Color routeColor = Colors.Blue; 9 SolidColorBrush routeBrush = new SolidColorBrush(routeColor); 10 MapPolyline routeLine = new MapPolyline(); 11 routeLine.Locations = new LocationCollection(); 12 routeLine.Stroke = routeBrush; 13 routeLine.Opacity = 0.65; 14 routeLine.StrokeThickness = 5.0; 15 //检索坐标点，用于绘制路线 16 foreach (Location p in e.Result.Result.RoutePath.Points) 17 { 18 //MSDN上是这么写的 19 //routeLine.Locations.Add(new Location(p.Latitude, p.Longitude)); 20 //以上代码不可用，原因是由于在WP7中Location没有包含两个参数的方法，WP7中将经纬度封装成了属性 21 Location location = new Location() 22 { 23 Longitude=p.Longitude, 24 Latitude=p.Latitude 25 }; 26 routeLine.Locations.Add(location); 27 } 28 //将绘制的路线的图层添加到当前地图中 29 MapLayer myRouteLayer = new MapLayer(); 30 bingmap.Children.Add(myRouteLayer); 31 myRouteLayer.Children.Add(routeLine); 32 //用点来标示每一种路线的Waypoint 33 foreach (GeocodeService.GeocodeResult gr in geocodeResults) 34 { 35 Ellipse point = new Ellipse(); 36 point.Width = 10; 37 point.Height = 10; 38 point.Fill = new SolidColorBrush(Colors.Red); 39 point.Opacity = 0.65; 40 Location location = new Location() 41 { 42 Latitude=gr.Locations[0].Latitude, 43 Longitude=gr.Locations[0].Longitude 44 }; 45 myRouteLayer.AddChild(point, location); 46 } 47 //计算出包含全部路径的矩形大小，这个将用于后面设置地图的视图(使查询得到的路线居中) 48 //RouteModel是自己定义的一个类，该类的作用是计算路径所在的矩形范围，并将路径视图居中显示在屏幕上 49 var routeModel = new RouteModel(e.Result.Result.RoutePath.Points); 50 LocationRect rect = LocationRect.CreateLocationRect(routeModel.Locations); 51 //设置地图的视图为路线所在的矩形 52 bingmap.SetView(rect); 53 } 54 }
其实在这里我们已经实现了路径的查询计算功能，只是当我们查询的路线不在当前屏幕范围时，我们需要调整一下屏幕显示的地图，将查询的结果显示很出来(例如当前的地图是沈阳市，但是我查询的长沙至武汉的路径，虽然以上的工作可以完成查询工作，但是并不会将我们的查询结果显示在屏幕上，所以我们将结果居中一下，在屏幕上显示出来)，下面是RouteModel的代码：
1 /// <summary> 2 /// 用于设置地图路线的视图位置 3 /// </summary> 4 public class RouteModel 5 { 6 private readonly LocationCollection _locations; 7 8 /// <summary> 9 /// 得到路线的地理位置的集合 10 /// </summary> 11 public ICollection<GeoCoordinate> Locations 12 { 13 get { return _locations; } 14 } 15 /// <summary> 16 /// 初始化一个新的LocationCollection对象 17 /// </summary> 18 /// <param name="locations">位置信息的集合</param> 19 public RouteModel(ICollection<Location> locations) 20 { 21 _locations = new LocationCollection(); 22 foreach (Location location in locations) 23 { 24 _locations.Add(location); 25 } 26 } 27 } 28 //最后添加一个计算路劲的Button响应函数，即开始发送服务请求，计算路径： 29 private void CaculateButton_Click(object sender, EventArgs e) 30 { 31 //初始化geocodeResault数组变量，这里由于我们只查询两个地点的路径，所以数组长度设为2 32 geocodeResults = new GeocodeService.GeocodeResult[2]; 33 //调用Geocde方法发送服务请求 34 Geocode("Changsha", 0); 35 Geocode("Shenyang", 1); 36 }
在这里我直接的输入了两个地名，一个是沈阳，一个是长沙，其实理想的做法是添加两个TextBox控件，根据TextBox的内容实现不同地点的路径查询。实现的过程没有什么变化，不多说。
这里注意的一点是：在Windows Phone 7中的BingMap暂不支持中文，所以地名都需要用拼音。
到此为止，所有的工作都已完成，我们来看看最后的结果吧：
以上的内容参考了MSDN上的一篇文章，以及Jake Lin的视频，这里非常推荐Jake Lin的视频，初学者值得一看。
MSDN文章地址：
http://msdn.microsoft.com/en-us/library/ee681887.aspx
(版权所有，转载请标明出处)
