How to use the Bing Maps directions task for Windows Phone 8

How to use the Bing Maps directions task for Windows Phone 8

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

The Bing Maps directions task launches the Bing Maps application and displays driving directions between two points. You can specify both the start and end points, or specify only one; in the latter case, the user’s current location is used for the other one. The start and end points contain a string label, and geographic coordinates specifying the latitude and longitude of the location. If you omit the geographic coordinates, the label string is used by the Bing Maps application as a search term.

By using Launchers, you help provide a consistent user experience throughout the Windows Phone platform. For more information, see Launchers and Choosers for Windows Phone 8.

Important noteImportant Note:

The Bing Maps application will not be launched if the device is in a location where it is not supported. Instead, a dialog is displayed to the user indicating that Bing Maps is unavailable in their location.

To use the Bing Maps directions task

  1. Add a reference to the System.Device assembly to your project.

  2. Add the following statements to your code.

    using Microsoft.Phone.Tasks;
    using System.Device.Location;
    
  3. Add the following code to your application wherever you need it, such as in a button click event. To test this procedure, you can put the code in the page constructor. This is the code to launch the task.

    BingMapsDirectionsTask bingMapsDirectionsTask = new BingMapsDirectionsTask();
                
    // You can specify a label and a geocoordinate for the end point.
    // GeoCoordinate spaceNeedleLocation = new GeoCoordinate(47.6204,-122.3493);
    // LabeledMapLocation spaceNeedleLML = new LabeledMapLocation("Space Needle", spaceNeedleLocation);
    
    // If you set the geocoordinate parameter to null, the label parameter is used as a search term.
    LabeledMapLocation spaceNeedleLML = new LabeledMapLocation("Space Needle", null);
    
    bingMapsDirectionsTask.End = spaceNeedleLML;
    
    // If bingMapsDirectionsTask.Start is not set, the user's current location is used as the start point.
    
    bingMapsDirectionsTask.Show();
    
    
    Important noteImportant Note:

    You must specify at least one of Start or End, or an exception is thrown when you call the Show method.

Show:
© 2017 Microsoft