BingItineraryItem.CompassDirection Property

Returns the compass direction indicating the cardinal point.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

public string CompassDirection { get; }

VB.NET

Public ReadOnly Property CompassDirection As String

Property Value

Type	Description
String	A String value specifying the cardinal point.

Remarks

For more information, refer to the Bing Route Data topic in MSDN.

Example

This example demonstrates how to zoom a map to the calculated route.

To do this, handle the BingRouteDataProvider.RouteCalculated event. In the event handler, using the BingRouteResult.BoundingBox property, get the top-left corner (using the SearchBoundingBox.NorthLatitude and SearchBoundingBox.WestLongitude properties) and right-bottom corner (using the SearchBoundingBox.SouthLatitude and SearchBoundingBox.EastLongitude properties) of the required region. Then, using the MapControl.ZoomToRegion method, zoom the map to the required rectangle specified by the corners.

Form1.cs

using DevExpress.XtraMap;
using System.Collections.Generic;
using System.Windows.Forms;

namespace ZoomToFitOnRouteCalculated {
    public partial class Form1 : Form {
        InformationLayer Layer { get { return (InformationLayer)mapControl.Layers[1]; } }
        BingRouteDataProvider Provider { get { return (BingRouteDataProvider)Layer.DataProvider; } }
        public Form1() {
            InitializeComponent();
        }
        void OnRouteCalculated(object sender, BingRouteCalculatedEventArgs e) {
            SearchBoundingBox bBox = e.CalculationResult.RouteResults[0].BoundingBox;
            mapControl.ZoomToRegion(new GeoPoint(bBox.NorthLatitude, bBox.WestLongitude), new GeoPoint(bBox.SouthLatitude, bBox.EastLongitude), 0.4);
            splashScreenManager.CloseWaitForm();
        }
        private void Form1_Load(object sender, System.EventArgs e) {
            Provider.RouteCalculated += OnRouteCalculated;
            Provider.CalculateRoute(new List<RouteWaypoint> {
                new RouteWaypoint("New York", new GeoPoint(41.145556, -73.995)),
                new RouteWaypoint("Oklahoma", new GeoPoint(36.131389, -95.937222)),
                new RouteWaypoint("Las Vegas", new GeoPoint(36.175, -115.136389))
            });
            splashScreenManager.ShowWaitForm();
        }
    }
}

Form1.vb

Imports DevExpress.XtraMap
Imports System.Collections.Generic
Imports System.Windows.Forms

Namespace ZoomToFitOnRouteCalculated
    Partial Public Class Form1
        Inherits Form

        Private ReadOnly Property Layer() As InformationLayer
            Get
                Return CType(mapControl.Layers(1), InformationLayer)
            End Get
        End Property
        Private ReadOnly Property Provider() As BingRouteDataProvider
            Get
                Return CType(Layer.DataProvider, BingRouteDataProvider)
            End Get
        End Property
        Public Sub New()
            InitializeComponent()
        End Sub
        Private Sub OnRouteCalculated(ByVal sender As Object, ByVal e As BingRouteCalculatedEventArgs)
            Dim bBox As SearchBoundingBox = e.CalculationResult.RouteResults(0).BoundingBox
            mapControl.ZoomToRegion(New GeoPoint(bBox.NorthLatitude, bBox.WestLongitude), New GeoPoint(bBox.SouthLatitude, bBox.EastLongitude), 0.4)
            splashScreenManager.CloseWaitForm()
        End Sub
        Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
            AddHandler Provider.RouteCalculated, AddressOf OnRouteCalculated
            Provider.CalculateRoute(New List(Of RouteWaypoint) From { _
                New RouteWaypoint("New York", New GeoPoint(41.145556, -73.995)), _
                New RouteWaypoint("Oklahoma", New GeoPoint(36.131389, -95.937222)), _
                New RouteWaypoint("Las Vegas", New GeoPoint(36.175, -115.136389)) _
            })
            splashScreenManager.ShowWaitForm()
        End Sub
    End Class
End Namespace