How to start a turn-by-turn navigation to a destination from your Windows Phone app

TTG - Torino Technologies Group - How to start a turn-by-turn navigation to a destination from your Windows Phone app

How to start a turn-by-turn navigation to a destination from

your Windows Phone appEnzo Contini

Email: [email protected]: http://enzocontini.wordpress.com

Enzo Contini TILAB 1

mailto:[email protected]

http://enzocontini.wordpress.com/category/microsoft-phone-programming

http://enzocontini.wordpress.com/category/microsoft-phone-programming


Agenda

► Introduction to new Geolocation, Maps namespaces and new Tasks for Maps (quick review)

► How to start a turn-by-turn navigation to a destination from your Windows Phone app

► Demos► References (online examples and presentations)► Go back to introduction to see more in details (if there is time!)► Q&A



Location sources

Enzo Contini TILAB 313/04/2013

WP8 Location Services

+ Accuracy- Power- Speed- Indoors

- Accuracy+ Power+ Speed- Wilderness

+/- Accuracy+/- Power+/- Speed+/- Urban areas

GPS

Cell Towers

WiFi

TTG - Torino Technologies Group - How to start a turn-by-turn navigation to a destination from your Windows Phone appControlling the sources the geolocation service uses► You can’t decide if the source is GPS, WIFI or Cell Towers! ► You only can set the DesiredAccuracy property of the Geolocator

object: ► PositionAccuracy.Default – to optimize for power ► PositionAccuracy.High – if you want the most accurate data

available, but at the cost of increased battery usage, network bandwidth and possibly monetary charges from wireless network operators. Often this causes the GPS to be activated

► You can also set the DesiredAccuracyInMeters property to indicate to the Geolocation service the desired accuracy of any results

► However, the Geolocation service determines the best location data to provide to the application inside the user decided timeout (maximum time the Geolocator object has to obtain a position that satisfies the accuracy requirement).


Geolocator.GetGeopositionAsync(maximumAge, timeout)

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geolocator.desiredaccuracy.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geolocator.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geolocator.desiredaccuracyinmeters.aspx


New Windows.Devices.Geolocation namespace► Enables app developers to easily access the computer's geographic location

by using a single APICapabilities: ID_CAP_LOCATION in WMAppManifest.xmlGeolocator class: current geographic location (Windows.Devices.Geolocation Geoposition)

► User consent: you only have to get user consent if you plan to make location data available to any other service or other person. In that case, the first use of the Geolocator object to call GetGeopositionAsync must be made on the UI thread so that the consent prompt can be shown to the user.

► Convergent with Windows 8 location API with only minor differences. Most code should be reusable on both platforms.

► When in Connected Standby (when the system is powered on but the display is off: this happens in response to the user pressing the physical Power button or when the user selects Sleep from the UI), Geolocator objects can always be instantiated but the Geolocator object will not find any sensors to aggregate so calls to GetGeopositionAsync will time out after 7 seconds, PositionChanged event listeners will never be called, and StatusChanged event listeners will be called once with the NoData status.


http://msdn.microsoft.com/en-us/library/windows/apps/br225603.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geolocator.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geoposition.aspx

http://msdn.microsoft.com/en-us/library/windows/hardware/jj248729.aspx


System.Device.Location.GeoCoordinateWatcher.NET Location API from Windows Phone OS 7.1 is still supported: System.Device.Location.GeoCoordinateWatcher and related classes


private void TrackLocation_Click(object sender, RoutedEventArgs e) { if (!tracking) { geolocator = new Geolocator(); geolocator.DesiredAccuracy = PositionAccuracy.High; geolocator.MovementThreshold = 100; // The units are meters. geolocator.PositionChanged += geolocator_PositionChanged; tracking = true; TrackLocationButton.Content = "stop tracking"; } else { geolocator.PositionChanged -= geolocator_PositionChanged; geolocator = null; tracking = false; TrackLocationButton.Content = "track location"; StatusTextBlock.Text = "stopped"; } }

void geolocator_PositionChanged(Geolocator sender, PositionChangedEventArgs args) { Dispatcher.BeginInvoke(() => { LatitudeTextBlock.Text = args.Position.Coordinate.Latitude.ToString("0.00"); LongitudeTextBlock.Text = args.Position.Coordinate.Longitude.ToString("0.00"); }); }

http://msdn.microsoft.com/en-US/library/windowsphone/develop/system.device.location.geocoordinatewatcher(v=vs.105).aspx

http://msdn.microsoft.com/en-US/library/windowsphone/develop/system.device.location.geocoordinatewatcher(v=vs.105).aspx


BE CAREFUL► Geolocator uses System.Device.Location.GeoCoordinate:► GeoCoordinateWatcher (as well as Maps API in general) uses

Windows.Devices.Geolocation.Geocoordinate

Windows.Devices.Geolocation.Geocoodinate != System.Device.Location.GeoCoordinate

System.Device.Location.GeoCoordinate myCoord = new GeoCoordinate(Position.Coordinate.Latitude, Position.Coordinate.Longitude);


WGS 84 standard

Geoposition geoposition;GeoCoordinate geoCoordinate = geoposition.Coordinate.ToGeoCoordinate();

See also the Phone Toolkit Map extensions: GeocoordinateExtensions class that extends Geocoordinate class

http://bit.ly/Yg9rIb

http://bit.ly/Yg9rIb

http://bit.ly/Yg9wvq

http://bit.ly/Yg9wvq

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate(v=win.10).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geoposition(v=win.10).aspx

http://phone.codeplex.com/


ID_CAP_LOCATION capability


If you forget, at runtime calls to location APIs throw an UnauthorizedAccessException


Geolocator (summary)


Windows.Devices.Geolocation.Geolocator

PositionChanged [Tracking] GetGeopositionAsync(maxAge, Timeout) [one shot]

Geoposition

Geocoordinate Coordinate CivicAddress = NULL

AccuracyLatitudeLongitudePositionSourceSpeedTimeStamp

CellularGPSWIFI

ReportIntervalMovementThreshold

DesiredAccuracyDesiredAccuracyInMeters


Geoposition properties► The obtained Geoposition has the following 2 properties:

► Geocoordinate Coordinate [Latitude /Longitude /Altitude , Accuracy , PositionSource , Speed , Timestamp etc…]

► CivicAddress CivicAddress [City , Country] always NULL in WP8. If you want the address you need to call ReverseGeocodeQuery maps service (from a GeoCoodinate).

again … BE CAREFUL:Windows.Devices.Geolocation.Geocoodinate !=

System.Device.Location.GeoCoordinatetherefore ()GetReverseLocation(new GeoCoordinate(myCurrentGeoposition.Coordinate.Latitude, myCurrentGeoPosition.Coordinate.Longitude));

See also the Phone Toolkit Map extensions: GeocoordinateExtensions class that extends Geocoordinate class



WGS 84 standard

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geoposition.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geoposition.coordinate.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.latitude.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.longitude.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.altitude.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.accuracy.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.positionsource.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.speed.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geocoordinate.timestamp.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.civicaddress.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geoposition.civicaddress.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geoposition.civicaddress.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.civicaddress.city.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.civicaddress.country.aspx

http://msdn.microsoft.com/query/dev11.query?appId=Dev11IDEF1&l=EN-US&k=k(%22Microsoft.Phone.Maps.Services.ReverseGeocodeQuery.#ctor%22);k(TargetFrameworkMoniker-WindowsPhone,Version=v8.0);k(DevLang-csharp)&rd=true







private async void OneShotLocation_Click(object sender, RoutedEventArgs e) { Geolocator geolocator = new Geolocator(); geolocator.DesiredAccuracyInMeters = 50; //in meters //geolocator.DesiredAccuracy = Windows.Devices.Geolocation.PositionAccuracy.High, try { Geoposition geoposition = await geolocator.GetGeopositionAsync(

maximumAge: TimeSpan.FromMinutes(5),

timeout: TimeSpan.FromSeconds(10) );

LatitudeTextBlock.Text = geoposition.Coordinate.Latitude.ToString("0.000"); LongitudeTextBlock.Text = geoposition.Coordinate.Longitude.ToString("0.000"); } catch (UnauthorizedAccessException) { // the app does not have the right capability or the location master switch is off StatusTextBlock.Text = "location is disabled in phone settings."; } }

One shot phone’s current location (see *)



Location Tracking


private void TrackLocation_Click(object sender, RoutedEventArgs e) { if (!tracking) { geolocator = new Geolocator(); geolocator.DesiredAccuracy = PositionAccuracy.High; geolocator.MovementThreshold = 100; // The units are meters. geolocator.StatusChanged += geolocator_StatusChanged; geolocator.PositionChanged += geolocator_PositionChanged; tracking = true; } else { geolocator.PositionChanged -= geolocator_PositionChanged; geolocator.StatusChanged -= geolocator_StatusChanged; geolocator = null; tracking = false; } }

void geolocator_PositionChanged(Geolocator sender, PositionChangedEventArgs args) { Dispatcher.BeginInvoke(() => { LatitudeTextBlock.Text = args.Position.Coordinate.Latitude.ToString("0.000"); LongitudeTextBlock.Text = args.Position.Coordinate.Longitude.ToString("0.000"); }); }


Enable location tracking in the background (1)► Normally, when your user navigates away from your app, it is

made dormant and all activity – including location tracking – is suspended

► In Windows Phone 8, a location-tracking app can continue to run in the background after the user navigates away, as long as the app continues to actively track location

► This feature enables scenarios such as an app that provides turn-by-turn directions or a run tracker

► Continuously tracking the user’s location drains the user’s battery more and should only be used for apps that require it.



Enable location tracking in the background (2)

1. Edit WMAppManifest.xml using the XML Text Editor



2. Register event handler for RunningInBackground event in App.xaml

<Application.ApplicationLifetimeObjects>



<shell:PhoneApplicationService

Launching="Application_Launching" Closing="Application_Closing“

Activated="Application_Activated" Deactivated="Application_Deactivated“

RunningInBackground="Application_RunningInBackground"/> </Application.ApplicationLifetimeObjects>




// Static variables global to application to support tracking public static Geolocator Geolocator { get; set; }

public static bool RunningInBackground { get; set; }

// Code to execute when the application is activated (brought to foreground) private void Application_Activated(object sender, ActivatedEventArgs e) {

RunningInBackground = false;

}

// Code to execute when the application is deactivated and is tracking location

private void Application_RunningInBackground(object sender, RunningInBackgroundEventArgs e) {

RunningInBackground = true;

// Suspend all unnecessary processing such as UI updates

}



3. Implement RunningInBackground event handler in App.cs



void geolocator_PositionChanged(Geolocator sender, PositionChangedEventArgs args) {

if (!App.RunningInBackground) {

Dispatcher.BeginInvoke(() => {

LatitudeTextBlock.Text = args.Position.Coordinate.Latitude.ToString("0.000");

LongitudeTextBlock.Text = args.Position.Coordinate.Longitude.ToString("0.000"); });

} else {//DEMO

Microsoft.Phone.Shell.ShellToast toast = new Microsoft.Phone.Shell.ShellToast();

toast.Content = args.Position.Coordinate.Latitude.ToString("0.000");

toast.Title = "Location: ";

toast.NavigationUri = new Uri("/Page2.xaml", UriKind.Relative);

toast.Show();

}

}

Enable location tracking in the background (5)Do not update UI when running in the background. Then, for example, if running in background show toast or write in Start live tile.


Location on emulator


► Windows Phone Emulator comes with Location simulator: useful especially when you need tracking capabilities. You can also record data and then run again the same sequence.

NOTE - How to take a screenshot with Windows Phone 8

http://enzocontini.wordpress.com/2013/04/05/how-to-take-a-screenshot-with-windows-phone-8/

http://enzocontini.wordpress.com/2013/04/05/how-to-take-a-screenshot-with-windows-phone-8/


New Maps namespaces► Microsoft.Phone.Maps : contains core classes of the map control

Capabilities: ID_CAP_MAP in WMAppManifest.xml► Microsoft.Phone.Maps.Controls: contains the most commonly used

public classes of the map control for Windows Phone[Map, MapRoute, MapLayer, GeoCoordinateCollection, etc…]

► Microsoft.Phone.Maps.Services : contains classes that provide location services to map control

► GeocodeQuery: from a text [address/building name] to potential geocoordinates and other geolocation data (IList<MapLocation>)

► ReverseGeocodeQuery: given a location, what do I find there? From a location (System.Device.Location.GeoCoordinate) to potential geolocation data (IList<MapLocation>) as address

► RouteQuery : used to calculate the route between any two or more geographical locations. The query result could be used to draw a route on the map and/or to calculate the distance from source to destination.


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.map(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.maproute(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.maplayer(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.geocoordinatecollection(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj208017(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.geocodequery(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/5y536ey6(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.maplocation(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.reversegeocodequery(v=vs.105).aspx


http://msdn.microsoft.com/en-us/library/windowsphone/develop/5y536ey6(v=vs.105).aspx


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.routequery(v=vs.105).aspx


ID_CAP_MAP Capability


If you forget, always at runtime the page throw ‘XAML Parse exception occurred -

System.Windows.Markup.XamlParseException‘


Map Control ()

► In XAML

► In code

► By default, map displays at zoom level 1 (world view) and centered at Lat/Long 0,0;

► Center and ZoomLevel properties to change this, in XAML or in code.


<Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0"> <maps:Map x:Name=“MyMap"/> </Grid>

private void CreateMap() {

Map MyMap = new Map(); ContentPanel.Children.Add(MyMap);

}

//Set the Map center by using Center property MyMap.Center = new GeoCoordinate(45.09854, 17.33315); //Set the map zoom by using ZoomLevel property MyMap.ZoomLevel = 17;

<maps:Map x:Name=“MyMap" Center="45.09874,17.32691" ZoomLevel="17" Heading="45" Pitch="25" CartographicMode="Road" ColorMode="Dark" PedestrianFeaturesEnabled="True" LandmarksEnabled="True" />


Map Control: map views (1)

► A new map view is defined any time the position of the map is changed as a result of panning, zooming, rotating or tilting

► You can use one overload of the SetView method to define a map view using one or more of the following parameters:

► Center: A GeoCoordiante object defining the center of the map after setting the view.

► ZoomLevel: zoom level, between 1 and 20 ► Heading: specifies the directional heading that is pointing “up” on the

map in geometric degrees between 0 and 360 ► Pitch: specifies the degree to which the map is tilted as a value between

0 and 180 ► BoundingRectangle: a LocationRectangle object that contains the Map

control ► AnimationKind: sets the kind of animation you want to see (None,

Linear or Parabolic) when the view changes Enzo Contini TILAB 22

13/04/2013

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.map.setview(v=vs.105).aspx



Map Control: map views (2)

Use of the BoundingRectangle parameter to show a map that contains all the interested GeoCoordinates:



Map Control: cartographic modes

► CartographicMode property allows to set the cartographic mode of the map


Road (default) Aerial Hybrid Terrain


Map Control: light and dark color modes

► ColorMode property allows to display the map in a light or dark color mode


Light (default) Dark


► Display additional elements on your map such as 3D landmarks and pedestrian features such as public stairs.

► To display 3D landmarks (ZoomLevel>7; Pitch>25) LandmarksEnabled = true

► To display pedestrian features PedestrianFeaturesEnabled = true

NOTE: landmarks are visible only when the ZoomLevel is 7 or higher, and the Pitch property is 25 or higher

Map Control: pedestrian features and 3D landmarks


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.map.zoomlevel(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.map.pitch(v=vs.105).aspx


ConvertViewportPointToGeoCoordinate Map method


► ConvertViewportPointToGeoCoordinate method that returns the GeoCoordinates from the specified viewport point of the map control.

ConvertGeoCoordinateToViewportPoint: returns the viewport point from the specified GeoCoordinates of the map control.

GeoCoordinate geoCoordinate = Map.ConvertViewportPointToGeoCoordinate

(e.GetPosition(this.Map));


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.controls.map.convertgeocoordinatetoviewportpoint(v=vs.105).aspx




► Unlike the Bing Maps API, WP8 Maps API does not have a specific PushPin object. There’s nothing ready to be used in the SDK for common scenarios like displaying a pushpin or the user’s location.

► However, you can create your own pushPins by drawing UIElements onto a MapOverlay, then add the MapOverlay to a MapLayer which you add to the Map. ()

► MapOverlay object, that has two main properties: ► GeoCoordinate, with the coordinates where the element should be

placed► Content, which is a generic object property so it accepts any XAML

control► Very powerful: since the MapOverlay object has a generic

Content property, you can customize the overlay elements any way you want

Pushpins (1)

http://msdn.microsoft.com/en-US/library/windowsphone/develop/microsoft.phone.maps.controls.mapoverlay(v=vs.105).aspx

http://msdn.microsoft.com/en-US/library/windowsphone/develop/microsoft.phone.maps.controls.maplayer(v=vs.105).aspx


private void AddMapOverlay() {

Grid MyGrid = CreatePushpin();

//Creating a MapOverlay and adding the Grid to it.

MapOverlay MyOverlay = new MapOverlay();

MyOverlay.Content = MyGrid;

//MyOverlay.Content = new Ellipse { Fill = new SolidColorBrush(Colors.Red), Width = 40, Height = 40 }

MyOverlay.GeoCoordinate = new GeoCoordinate(7.60, -22.3);

MyOverlay.PositionOrigin = new Point(0, 0.5);

//Creating a MapLayer and adding the MapOverlay to it

MapLayer MyLayer = new MapLayer();

MyLayer.Add(MyOverlay);

MyMap.Layers.Add(MyLayer);

}


private Grid CreatePushpin() {

//Creating a Grid element.

Grid MyGrid = new Grid();

MyGrid.RowDefinitions.Add(new RowDefinition());

MyGrid.RowDefinitions.Add(new RowDefinition());

MyGrid.Background = new SolidColorBrush(Colors.Transparent);

//Creating a Rectangle

Rectangle MyRectangle = new Rectangle();

MyRectangle.Fill = new SolidColorBrush(Colors.Black);

MyRectangle.Height = 20;

MyRectangle.Width = 20;

MyRectangle.SetValue(Grid.RowProperty, 0);

MyRectangle.SetValue(Grid.ColumnProperty, 0);

//Adding the Rectangle to the Grid

MyGrid.Children.Add(MyRectangle);

}

Pushpins (2)

TTG - Torino Technologies Group - How to start a turn-by-turn navigation to a destination from your Windows Phone appPhone Toolkit Map extensions (1) (see MapsSample in

PhoneToolkitSample.WP8)UserLocationMarker and Pushpin controls

► They are both overlay elements that are placed on the map over a specific position and they offer a way to interact with them (so that, for example, the user can tap on a pushpin and do something)

► Pushpin has the same look & feel of the ones that were available in the old Bing Maps and can be used to highlights point of interests in the map

► UserLocationMarker is used to identify the position of the user and it has the same look & feel of the one used in the native app


Pushpin UserLocationMarker




► Declare in the XAML the namespace: xmlns:maptk="clr-namespace:

Microsoft.Phone.Maps.Toolkit;assembly=Microsoft.Phone.Controls.Toolkit“

► In XAML:

► Manage their position by code:


<maps:Map x:Name="myMap"> <toolkit:MapExtensions.Children> <toolkit:UserLocationMarker x:Name="UserLocationMarker" /> <toolkit:Pushpin x:Name="MyPushpin" Content="My Position“ Tap="MyPushpin_OnTap"/> </toolkit:MapExtensions.Children> </maps:Map>

UserLocationMarker marker = (UserLocationMarker)this.FindName("UserLocationMarker"); marker.GeoCoordinate = myMap.Center; Pushpin pushpin = (Pushpin)this.FindName("MyPushpin"); pushpin.GeoCoordinate = new GeoCoordinate(32.71200, 7.32600);

private void MyPushpin_OnTap(object sender, GestureEventArgs e) { Pushpin pushpin = sender as Pushpin; MessageBox.Show(pushpin.Content.ToString()); }

Phone Toolkit Map extensions (2) (see MapsSample in PhoneToolkitSample.WP8)

UserLocationMarker and Pushpin controls




Phone Toolkit Map extensions: GeocoordinateExtensions class



Windows.Devices.Geolocation.Geocoodinate != System.Device.Location.GeoCoordinate

WGS 84 standard







GeocodeQuery & ReverseGeocodeQuery (summary)

GeocodeQuery

GeocodeQuery_QueryCompleted

ReverseGeocodeQuery_QueryCompleted

IList<MapLocation>

LocationRectangle

BoundingBoxGeoCoordinateInformation LocationInformation

SearchTerm [descriptive text]GeoCoordinate [current / new GeoCoordinate(0,0)]

ReverseGeocodeQuerynew GeoCoordinate(Lat, Long)

MapAddress AddressDescriptionName

AltitudeLatitudeLongitudeSpeedHorizontalAccuracyVerticalAccuracy

StreetHouseNumberCity…


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.maplocation.boundingbox(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.maplocation.geocoordinate(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.maplocation.information(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.mapaddress(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.locationinformation.address(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.locationinformation.description(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.locationinformation.name(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate.altitude(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate.latitude(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate.longitude(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate.speed(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate.horizontalaccuracy(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/system.device.location.geocoordinate.verticalaccuracy(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.mapaddress.street(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.mapaddress.housenumber(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.mapaddress.city(v=vs.105).aspx


Turning Query into a proper async operation ()



New maps launchers: Tasks for Maps



► MapsTask makes launching the built-in Maps application easy. It allows an application to launch the Maps application centered at the location specified with the Center property or, by default, at the user’s current location.

► If SearchTerm is set, locations matching the search term are tagged on the map.

MapsTask (1)


private void LaunchMapsTask() { MapsTask mapsTask = new MapsTask(); //NOTE: omit the Center property to use the user's current location mapsTask.Center = new GeoCoordinate(45.098541, 7.697704); mapsTask.ZoomLevel = 17; mapsTask.SearchTerm = "ospedale"; //"ospedali";//"pizzeria";//!!!!!!!!!! mapsTask.Show();}

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapstask(v=vs.105).aspx


► Too few results and too often not consistent!! ► If SearchTerm = “ospedale” it goes to the town “Ospedale”; then, if

you search “ospedali”, it shows the hospitals near that previous found town and not near the centered point set in MapTask: only if you go to current position and then ask again for “ospedali”, it shows some of them … but again too few!

MapsTask (2)


«pizzeria» «ospedali»after previous search by code

«ospedale» «ospedali»after asked for current position

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapstask(v=vs.105).aspx


MapDownloaderTask / MapUpdaterTask (1)► These tasks launches the Maps settings application which allows

the user to select a region of map data to download / checks to see if there are updates available for any previously downloaded map data


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapdownloadertask(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapupdatertask(v=vs.105).aspx


► If a map control is currently used by the phone, these tasks cannot work and a popup alert is shown.


MapDownloaderTask / MapUpdaterTask (2)

MapDownloaderTask MapUpdaterTask

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapdownloadertask(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapupdatertask(v=vs.105).aspx

TTG - Torino Technologies Group - How to start a turn-by-turn navigation to a destination from your Windows Phone appPublish an app that uses the Map control: ApplicationId and AuthenticationToken (1)► To run and debug an app that uses the Map control you don’t need to do

nothing than use it.► BUT, before you can publish an app that uses the Map control, you have

to get an ApplicationId and AuthenticationToken from the Windows Phone Dev Center and add the values to your code, assign them to the respective properties (see here):

► after you have finished your app, begin the app submission process; ► on the Submit app page, click Map services; ► the Map services page opens; ► on the page, click Get token; ► the new ApplicationID and AuthenticationToken are displayed on the same

page;► copy the values and paste them into your code as described in the following

procedure; ► rebuild your app with the new code and upload and updated copy to the Store.


http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj207033(v=vs.105).aspx#BKMK_appidandtoken

TTG - Torino Technologies Group - How to start a turn-by-turn navigation to a destination from your Windows Phone appPublish an app that uses the Map control: ApplicationId and AuthenticationToken (2)


► In the xaml:

► In the code:


Start a turn-by-turn navigation to a destination from your Windows Phone appSometime it is useful to insert in your WP8 app the capability to start a navigation to a destination that can be derived, for example, from the address of a someone/some place or from the geocoordinate of a point in a map.There are several ways to do that and here I’ll try to describe the following ones:►Coding the navigation functions inside your app (RouteQuery class + GeocodeQuery class) .►Using the MapsDirectionsTask class.►Launching a navigator app with a Launcher that uses a specific navigation Uri.




http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapsdirectionstask(v=vs.105).aspx


A) Coding the navigation functions inside your app (1)► This can be done mainly using

► the GeocodeQuery class (to find a possible list of Geocoordinate from a descriptive search term like an address, a building name, or any other phrase indicating a place on Earth),

► the RouteQuery class (to get all the route points to reach the destination [according to the required mode of travel and optimizations])

► the SpeechSynthesizer class to have a text-to-speech reading of each Route turning point [the list of maneuvers associated with each route RouteLeg of every Route.Legs, that is the property of the legs associated with the route].

► All the three mentioned classes are async ones, in order not to stop the user interaction with the UI; in particular, the first two comes from the new Microsoft.Phone.Maps.Services.

► A code example that implements this kind of solution can be found in the Nokia Developer site: Map with directions in Windows Phone 8 project.






http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.route(v=vs.105).aspx


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services.route.legs(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.maps.services(v=vs.105).aspx

http://www.developer.nokia.com/

http://www.developer.nokia.com/

http://www.developer.nokia.com/Community/Wiki/Map_with_directions_in_Windows_Phone_8

http://www.developer.nokia.com/Community/Wiki/Map_with_directions_in_Windows_Phone_8


A) Coding the navigation functions inside your app (2)


You can see a blu circle for the starting point, a red one for the end point and a green one for the actual Route turning point with the maneuver written below (it is the text read by the SpeechSynthesizer).

However if you run that example, you will notice that the user experience is not comparable with that provided with commercial navigators and the synthesized voice, that can be acceptable for an input request, is not appropriate for giving driving instructions.

Most of the work needed to have a basic navigator is already done, even thought the text-to-speech of each instruction should be based on the actual position of the user [using the Geolocator class and in particular its GetGeopositionAsync(TimeSpan, TimeSpan) method and a listener to its PositionChanged event].


http://msdn.microsoft.com/en-us/library/windows/apps/hh973537.aspx

http://msdn.microsoft.com/en-us/library/windows/apps/windows.devices.geolocation.geolocator.positionchanged.aspx


B) Using the MapsDirectionsTask class (1)

► MapsDirectionsTask class is very powerful and allows to launch the Maps application, specifying a starting location and/or an ending location, for which driving directions are displayed and possibly launch an external navigator app.

Very often the starting position is the user’s current position: in that case the Start property must not be set because user’s current position is its default value (therefore there is no need to use the Geolocator class and its GetGeopositionAsync(TimeSpan, TimeSpan) method to find out user’s current position, because that Task already does everything for us).

► A code example that implements this kind of solution can be found among the Nokia Developer examples: LaunchDirectionsTask project (inside a Zip archive).


http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapsdirectionstask(v=vs.105).aspx

http://msdn.microsoft.com/en-us/library/windowsphone/develop/microsoft.phone.tasks.mapsdirectionstask.start(v=vs.105).aspx


http://msdn.microsoft.com/en-us/library/windows/apps/hh973537.aspx

https://projects.developer.nokia.com/WP8MapsExamples/browser

https://projects.developer.nokia.com/WP8MapsExamples/browser

https://projects.developer.nokia.com/WP8MapsExamples/browser/LaunchDirectionsTask

https://projects.developer.nokia.com/WP8MapsExamples/export/archive?rev=c8dcda32279166594c6bde06af46319edc4d240c&format=zip



MapsDirectionsTask mapsDirectionsTask = new MapsDirectionsTask();mapsDirectionsTask.Start = new LabeledMapLocation(OriginTitle.Text, originMarker.GeoCoordinate);mapsDirectionsTask.End = new LabeledMapLocation(DestinationTitle.Text, destinationMarker.GeoCoordinate);mapsDirectionsTask.Show();

In the case that you have an originMarker MapOverlay as a start point and a destinationMarker one as a destination point:

In the case you would like do go from your position to a specific geoCoordinate, (the default value of the starting position is the phone's current position):MapsDirectionsTask mapsDirectionsTask = new MapsDirectionsTask();mapsDirectionsTask.End = new LabeledMapLocation("Home", new GeoCoordinate(45.098614934831858,

7.6977774314582348));mapsDirectionsTask.Show();

If you have to go to a location that you want to find by name:

MapsDirectionsTask mapsDirectionsTask = new MapsDirectionsTask();mapsDirectionsTask.End = new LabeledMapLocation("Space Needle", null);mapsDirectionsTask.Show();




Request of user’s consent

Getting directions Directions found (emulator)

Set directions for pedestrian




After click on the mapToolbar & menu (1) Toolbar & menu (2)

If you click on “directions” toolbar button (“indicazioni stradali” in italian), you go back to the “Get direction” page, to allow a insert a new destination, and not to a navigation app.




But if you use a real phone and not the emulator, you can see, in the “Direction found“ page, a “by car“/”by foot” toolbar button (“In macchina“/”a piedi” in italian) [depending if it was chosen the car or the pedestrian view], that allows the user to launch, just from here, an external navigation app toward the chosen destination.




When the external navigator program is closed, your app comes again in foreground.Note that, if is your app is registered to run in background (because most if not all the navigator programs do the same and WP8 allows only one app to run in background), the background functions of your app stop until the navigator is closed and your app is again in foreground: once again, when it will go in background (for example because you answer a phone call or you use the browser to search something) the background execution will be activated.


Bing Search vs. MapsDirectionsTask (1)Navigation functions provided by the MapsDirectionsTask are in some way similar to the ones provided by the embedded Bing search.

When you go to the local results and click on the desired location, an Info page appears where you can start an external navigator with “drive -use an app” (“percorri – usa un’app” in italian).However the procedures that can be used to start a navigation app are different.



Bing Search vs. MapsDirectionsTask (2)

► In Bing Search “directions” ("indicazioni stradali" in italian) toolbar button starts the navigation app, while using MapsDirectionTask the toolbar button of the same name “directions” let the user go back to a previous page for a new input of start – end points, while the launch of a navigator app is done by a different named toolbar button (“by car”) in that previous page.

► In Bing Search, if there is not any app installed able to start a navigation (ex. case you can test using the emulator) clicking “directions” toolbar button let go to the store, showing all the appropriate apps that satisfy that requested protocol, while in the MapsDirectionTask the “byCar” toolbar button is not shown in that case, disabling any way to start a navigator app.

► I think that it is not nice to give a different user experience: if you agree you can vote here.


http://wpdev.uservoice.com/forums/110705-dev-platform/suggestions/3845585-make-the-logic-of-launching-a-navigation-app-from-


Bing Search vs. MapsDirectionsTask (3)


after clicking on a pushpin (ita)

after clicking on a pushpin (eng)

ask for app in the storeapp in the store for navigation


C) Use a Launcher with a specific navigation URI (1)► Sometime you need to start a professional navigator as soon as possible and the method described before

can be useful only when probably it’s enough for the user to have the route shown as a layer on the map and only sometimes he will need to ask for a turn-by-turn navigation.

► So if you want to directly launch an other app that offer a navigation service, an app-to-app communication can be used: a navigator app can be launched with a Launcher that uses a specific navigation Uri.

► If you knows the protocol name and the way possible parameters are passed, you can directly call a specific store app. For example, Nokia Maps can be launched as follows (at least now - NOKIA said that the “explore-maps://v1.0/…” app2app custom protocol is NOT SUPPORTED for 3rd party apps):

string launchNokiaMaps = "explore-maps://v1.0/?latlon=45.098541,7.697704&zoom=16"; await Windows.System.Launcher.LaunchUriAsync(new Uri(launchNokiaMaps));

► Use the new “ms-*” app2app custom protocols and in particular the navigation protocol and the ms-drive-to and ms-walk-to URI schemes (even thought they do not appear in the Reserved file and URI associations for Windows Phone 8 (???))


http://stackoverflow.com/questions/13387265/launch-nokia-maps-in-windows-phone-8

http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj207065(v=vs.105).aspx#BKMK_Reservedprotocolnames

http://msdn.microsoft.com/en-us/library/windowsphone/develop/jj207065(v=vs.105).aspx#BKMK_Reservedprotocolnames


C) Use a Launcher with a specific navigation URI (2)► A code example that implements this kind of solution can be found

among the MSDN samples: Navigation URI scheme sample.► It shows how you can use the navigation protocol both to write an

app that requests driving/walking directions, and to write an other app that provides driving/walking directions.


http://code.msdn.microsoft.com/Navigation-URI-scheme-4763c5f7

http://code.msdn.microsoft.com/Navigation-URI-scheme-4763c5f7



// Test both navigation Uri schemes. private const string DRIVING_PROTOCOL = "ms-drive-to"; private const string WALKING_PROTOCOL = "ms-walk-to"; // Use Seattle as the default destination. private const string DESTINATION_LATITUDE = "45.098614934831858"; private const string DESTINATION_LONGITUDE = "7.6977774314582348"; private const string DESTINATION_NAME = "Casa, TO"; // Single event handler for both driving and walking directions. private void GetDirections(object sender, EventArgs e) { string uriProtocol = null; string uri; // Driving or walking directions? string buttonClicked = ((Button)sender).Name; switch(buttonClicked) { case "btnGetDrivingDirections": uriProtocol = DRIVING_PROTOCOL; break; case "btnGetWalkingDirections": uriProtocol = WALKING_PROTOCOL; break; default: uriProtocol = DRIVING_PROTOCOL; break; } // Assemble the Uri for the request. uri = uriProtocol + ":?" + "destination.latitude=" + DESTINATION_LATITUDE + "&" + "destination.longitude=" + DESTINATION_LONGITUDE + "&" + "destination.name=" + DESTINATION_NAME; // Display the Uri. tbShowRequestUri.Text = AppResources.UriDisplayPrefix + ":\n" + uri; // Make the request. RequestDirections(uri); }

async void RequestDirections(string uri) { try { // Make the request. var success = await Windows.System.Launcher.

LaunchUriAsync(new Uri(uri)); if(success) { // Request succeeded. } else { // Request failed. MessageBox.Show("Request failed"); } } catch(Exception ex) { MessageBox.Show("Exception: " + ex.Message); } }


References► Video:

Building Apps for Windows Phone 8 Jump Start: (14) Maps and Location in Windows Phone 8 (or in Microsoft Virtual Academy - Building Apps for Windows Phone 8 Jump Start)

► Video: Windows Phone 8: Maps, Location, and Background Execution for Developers► Community Days 2013 - WP806 - Mappe su Windows Phone 8► Slides - Nokia - Mapping and Location ; Maps and location APIs for Windows Phone► Nokia Developer - Windows Phone 8 Maps Examples (Zip archive) ; **► Nokia Developer - Wiki Category: Nokia Maps - contains community articles

related to Nokia's Location Platform Here (also known as "Nokia Maps").► My Blog - How to start a turn by turn navigation to a destination from your

Windows Phone app► Pagani Blog - Maps in Windows Phone 8 and Phone Toolkit: A Winning Team► Windows Phone Api Quickstart


http://channel9.msdn.com/Series/Building-Apps-for-Windows-Phone-8-Jump-Start/Building-Apps-for-Windows-Phone-8-Jump-Start-14-Maps-and-Location-in-Windows-Phone-8



https://www.microsoftvirtualacademy.com/

https://www.microsoftvirtualacademy.com/training-courses/windows-phone-8-apps-development-jumpstart

https://www.microsoftvirtualacademy.com/training-courses/windows-phone-8-apps-development-jumpstart

http://channel9.msdn.com/Events/Build/2012/2-017

http://channel9.msdn.com/Events/Build/2012/2-017

http://www.communitydays.it/events/communitydays-2013/wp806/

http://www.slideshare.net/nokia-developer/mwcadc-2013-mapping-and-location-for-windows-phone



http://www.slideshare.net/nokia-developer/lumia-app-labs-here-maps-and-location-apis-for-windows-phone?utm_source=slideshow

https://projects.developer.nokia.com/WP8MapsExamples

Date post:	13-Feb-2017
Category:	Education
Upload:	enzo-contini
View:	1,952 times
Download:	1 times

How to start a turn-by-turn navigation to a destination from your Windows Phone app

Education