BingRouteResult.BoundingBox Property

Returns the rectangular area containing the Bing resulting route.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v19.1.dll

Declaration

C#

public SearchBoundingBox BoundingBox { get; }

VB.NET

Public ReadOnly Property BoundingBox As SearchBoundingBox

Property Value

Type	Description
SearchBoundingBox	A SearchBoundingBox object specifying the rectangular region.

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.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-zoom-a-map-to-a-calculated-route-using-the-routecalculated-event-t363647

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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the BoundingBox property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-calculate-a-route-between-two-addresses-t364143/CS/RouteByAddresses/Form1.cs#L30

void OnRouteCalculated(object sender, BingRouteCalculatedEventArgs e) {
    SearchBoundingBox box = e.CalculationResult.RouteResults[0].BoundingBox;
    GeoPoint topLeft = new GeoPoint {

how-to-zoom-a-map-to-a-calculated-route-using-the-routecalculated-event-t363647/CS/ZoomToFitOnRouteCalculated/Form1.cs#L13

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);

VB.NET

how-to-calculate-a-route-between-two-addresses-t364143/VB/RouteByAddresses/Form1.vb#L33

Private Sub OnRouteCalculated(ByVal sender As Object, ByVal e As BingRouteCalculatedEventArgs)
    Dim box As SearchBoundingBox = e.CalculationResult.RouteResults(0).BoundingBox
    Dim topLeft As GeoPoint = New GeoPoint With {.Latitude = box.NorthLatitude, .Longitude = box.WestLongitude}

how-to-zoom-a-map-to-a-calculated-route-using-the-routecalculated-event-t363647/VB/ZoomToFitOnRouteCalculated/Form1.vb#L23

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)