Navigation Tutorial

The primary classes in the Telogis.GeoBase.Navigation namespace are the Navigator and NavigationManager classes. These classes are used to guide users to a given destination with the aid of regular GPS position updates from a connected GPS unit.

These classes are tolerant of navigation errors (such as missed turns) made by the user and will dynamically recalculate the optimal route. Navigator and NavigationManager implement IMapRenderer to allow the calculated route and UI controls to be drawn on a map. The sections in this tutorial are designed to provide an introductory overview of the Navigator and NavigationManager classes, their associated properties, concepts and methods.

• The IGps Interface

  This example demonstrates how to interface with a GPS device.

  This example application in this tutorials uses a map control that remains centered and rotated to the current position and heading of the connected (or simulated) GPS device.

  Note
  This application will be used as the basis for many of the examples below.

• Using a LabelBox

  A LabelBox is a convenient and simple method of displaying textual information over a Map.

  This example application will display the current heading, speed and GPS fix using a LabelBox.

• Using a Navigator

  The Navigator class is used to guide the user to a destination with the assistance of a GPS unit.

  This example will use a Navigator object to determine the user's current address, and indicate whether the user is on course or off course while navigating to their destination.

• Using Notifications and Event

  Adding notifications and events to a Navigator allows users to be notified of upcoming, current and previous navigation events.

  This example will use a LabelBox to provide simple navigation instructions using AddNotification(Notification) and NotificationDelegate. It also displays the distance traveled, advises when navigation is off course (using the Navigator's OffCourse event) and announces arrival at our destination (using the Navigator's Arrived event).

• Using an XmlWaveAnnouncer

  An XmlWaveAnnouncer is used to audibly announce upcoming navigation events, such as turn instructions, to the user. An XmlWaveAnnouncer is particularly useful when it is inconvenient or unsafe to rely only on visual cues for navigation.

  This example will audibly announce upcoming turns.

• Using a TurnBox

  A TurnBox is used to graphically display upcoming turn events to the user.

  A TurnBox is drawn over a Map. This example will display upcoming turns, as signaled by a navigation notification.

• Using the Navigation Manager

  A NavigationManager provides simple UI controls (TurnBox and LabelBoxes) that graphically display information about location, speed and upcoming turn events to the user. NavigationManager also provides audible direction announcements.

  This example will display and announce upcoming turns, as signaled by a navigation notification, together with the vehicle's location, speed, time/distance remaining to the destination, and natural-language direction instructions.

• Implementing an IGps Member

  IGps is an important interface, used by much of the navigation services.

  This topic describes the fields and properties of an IGps member that should be populated in order for navigation services to function correctly.