BingElevationDataProvider Class
OBSOLETE
This class is obsolete. Microsoft deprecated Bing Maps on June 30th, 2025. For alternative providers, see https://www.
Provides the capability to obtain the elevation data from the Bing Maps service.
Namespace: DevExpress.XtraMap
Assembly: DevExpress.XtraMap.v25.1.dll
NuGet Package: DevExpress.Win.Map
#Declaration
[Obsolete("This class is obsolete. Microsoft deprecated Bing Maps on June 30th, 2025. For alternative providers, see https://www.devexpress.com/bing-maps-winforms.")]
[PreferableMember("BingElevationDataProvider", "", "")]
public class BingElevationDataProvider :
BingMapDataProviderBase,
IMouseClickRequestSender
#Remarks
Important
On May 21, 2024, Microsoft announced that Bing Maps for Enterprise and its API will be discontinued. Azure Maps will be a single unified enterprise mapping platform available from Microsoft.
To obtain and display map data from Azure Maps, we implemented the following providers:
- Azure
Map Data Provider - Azure
Search Data Provider - Azure
Route Data Provider - Azure
Geocode Data Provider - Azure
Traffic Incident Data Provider - Azure
Route Isochrone Data Provider
For information on how to migrate your app from Bing Maps to Azure Maps, see the following help topic: Migrate from Bing Maps to Azure Maps Providers.
If you already have a Bing Maps for Enterprise license, you can keep using the current API. You must transition to the new API by June 30, 2025 (for free/basic licenses) or June 30, 2028 (for enterprise licenses). New licenses will no longer be available after June 30, 2025. Bing Maps will not work with our map controls without a license after that date.
#Example
This example demonstrates how to receive elevation information from the Bing Maps service.
To do this, request elevation information using the BingElevationDataProvider.RequestPointsElevations method. Then, display the request result using the BingElevationDataProvider.ElevationsCalculated event handler.
using DevExpress.XtraMap;
using System;
using System.Collections.Generic;
using System.Windows.Forms;
namespace BingElevationData {
public partial class Form1 : Form {
InformationLayer layer { get { return (InformationLayer)mapControl.Layers[1]; } }
VectorItemsLayer vectorLayer { get { return (VectorItemsLayer)mapControl.Layers[2]; } }
BingElevationDataProvider provider { get { return (BingElevationDataProvider)layer.DataProvider; } }
public Form1() {
InitializeComponent();
}
private void Form1_Load(object sender, EventArgs e) {
provider.ElevationsCalculated += OnElevationCalculated;
provider.GenerateLayerItems = false;
List<GeoPoint> locations = new List<GeoPoint> {
new GeoPoint(41.145556, -73.995),
new GeoPoint(36.131389, -95.937222),
new GeoPoint(36.175, -115.136389)
};
provider.RequestPointsElevations(locations);
}
void OnElevationCalculated(object sender, ElevationsCalculatedEventArgs e) {
MapItemStorage storage = new MapItemStorage();
foreach (ElevationInformation elevationInformation in e.Result.Locations) {
storage.Items.Add(new MapCallout() {
Text = string.Format("{0}\nElevation = {1} m", elevationInformation.Location, elevationInformation.Elevation),
Location = elevationInformation.Location
});
}
vectorLayer.Data = storage;
}
}
}