LocationInformation.Location Property

Gets or sets geographical coordinates of a location.

Namespace: DevExpress.Xpf.Map

Assembly: DevExpress.Xpf.Map.v18.2.dll

Declaration

C#

public GeoPoint Location { get; set; }

VB.NET

Public Property Location As GeoPoint

Property Value

Type	Description
GeoPoint	A GeoPoint object containing geographical coordinates of a location.

Example

This example demonstrates how to calculate a route between several waypoints and change the appearance of a route path using the Microsoft Bing Route web service. To accomplish this, do the following.

• Create an InformationLayer object and add it to the MapControl.Layers collection.
• Create a BingRouteDataProvider object and assign it to the InformationLayer.DataProvider property.

• To calculate a route, call the BingRouteDataProvider.CalculateRoute method and pass a list of waypoints as its argument.

  Note

  The BingRouteDataProvider.CalculateRoute method calculates the route based on less than 265 RouteWaypoint objects.

• To customize the route path appearance, handle the InformationDataProviderBase.LayerItemsGenerating event and modify the MapPushpin.Text property of each MapPushpin.

  Note that map pushpins for waypoints are generated automatically and the LayerItemsGenerating event occurs because the InformationDataProviderBase.GenerateLayerItems property value is true by default.

Note

If you run the application, and see a window with the following error message: ”The specified Bing Maps key is invalid. To create a developer account, refer to https://www.microsoft.com/en-us/maps/create-a-bing-maps-key”, refer to the following tutorial: How to: Get a Bing Maps Key.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-connect-a-map-control-to-a-bing-route-web-service-e4159.

MainWindow.xaml.vb

Public Sub New()
    InitializeComponent()

    ' Create three waypoints and add them to a route waypoints list. 
    Dim waypoints As New List(Of RouteWaypoint)()
    waypoints.Add(New RouteWaypoint("New York", New GeoPoint(41.145556, -73.995)))
    waypoints.Add(New RouteWaypoint("Oklahoma", New GeoPoint(36.131389, -95.937222)))
    waypoints.Add(New RouteWaypoint("Las Vegas", New GeoPoint(36.175, -115.136389)))

    routeProvider.CalculateRoute(waypoints)
End Sub

Private Sub routeProvider_LayerItemsGenerating(ByVal sender As Object, ByVal args As LayerItemsGeneratingEventArgs)
    Dim letter As Char = "A"c

    For Each item As MapItem In args.Items
        Dim pushpin As MapPushpin = TryCast(item, MapPushpin)
        If pushpin IsNot Nothing Then
            pushpin.Text = letter.ToString()
            letter = ChrW(AscW(letter) + 1)
        End If
    Next item
End Sub

MainWindow.xaml

<dxm:InformationLayer EnableHighlighting="False"
                      >
    <dxm:InformationLayer.DataProvider>
        <dxm:BingRouteDataProvider x:Name="routeProvider" 
                                   BingKey="{Binding Source={StaticResource YourBingKey}}"
                                   LayerItemsGenerating="routeProvider_LayerItemsGenerating"/>
    </dxm:InformationLayer.DataProvider>
</dxm:InformationLayer>

MainWindow.xaml.cs

public MainWindow() {
    InitializeComponent();

    // Create three waypoints and add them to a route waypoints list. 
    List<RouteWaypoint> waypoints = new List<RouteWaypoint>();
    waypoints.Add(new RouteWaypoint("New York", new GeoPoint(41.145556, -73.995)));
    waypoints.Add(new RouteWaypoint("Oklahoma", new GeoPoint(36.131389, -95.937222)));
    waypoints.Add(new RouteWaypoint("Las Vegas", new GeoPoint(36.175, -115.136389)));

    routeProvider.CalculateRoute(waypoints);
}

private void routeProvider_LayerItemsGenerating(object sender, LayerItemsGeneratingEventArgs args) {
    char letter = 'A';

    foreach (MapItem item in args.Items) {
        MapPushpin pushpin = item as MapPushpin;
        if (pushpin != null)
            pushpin.Text = letter++.ToString();
    }
}

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Location 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-implement-a-custom-geocode-provider-t462583/CS/CustomGeocodeProvider/MainWindow.xaml.cs#L46

RequestCompletedEventArgs CreateEventArgs() {
    MapItem item = new MapPushpin() { Location = address.Location, Information = address.Address.FormattedAddress };
    return new RequestCompletedEventArgs(new MapItem[] { item }, null, false, null);

how-to-implement-a-custom-search-provider-t516585/CS/CustomSearchProvider/MainWindow.xaml.cs#L54

for (int i = 0; i < items.Length; i++)
    items[i] = new MapPushpin() { Location = addresses[i].Location, Information = addresses[i].Address.FormattedAddress, Text = (i + 1).ToString() };
return new RequestCompletedEventArgs(items, null, false, null);

how-to-perform-the-search-operation-for-multiple-locations-t558593/CS/MapSearch/MainWindow.xaml.cs#L58

{
    AddPushpin(region.Location);
    if (idx == addresses.Count)

how-to-implement-a-route-calculator-t190068/CS/MapControl_RouteCalculator/MainWindow.xaml.cs#L45

MapPushpin pushpin = new MapPushpin() {
    Location = location.Location,
    Information = location

how-to-manually-process-search-using-a-custom-search-panel-t189413/CS/MapControl_SearchPanel/MainWindow.xaml.cs#L66

sb.Append(String.Format("\tAdress: {0}\n", info.Address));
sb.Append(String.Format("\tLocation: {0}\n", info.Location));
return sb.ToString();

VB.NET

how-to-implement-a-custom-geocode-provider-t462583/VB/CustomGeocodeProvider/MainWindow.xaml.vb#L66

Private Function CreateEventArgs() As RequestCompletedEventArgs
    Dim item As MapItem = New MapPushpin() With {.Location = address_Renamed.Location, .Information = address_Renamed.Address.FormattedAddress}
    Return New RequestCompletedEventArgs(New MapItem() {item}, Nothing, False, Nothing)

how-to-implement-a-custom-search-provider-t516585/VB/CustomSearchProvider/MainWindow.xaml.vb#L77

items(i) = New MapPushpin() With { _
    .Location = addresses_Renamed(i).Location, _
    .Information = addresses_Renamed(i).Address.FormattedAddress, _

how-to-perform-the-search-operation-for-multiple-locations-t558593/VB/MapSearch/MainWindow.xaml.vb#L53

For Each region As LocationInformation In regions
    AddPushpin(region.Location)
    If idx = addresses.Count Then

how-to-implement-a-route-calculator-t190068/VB/MapControl_RouteCalculator/MainWindow.xaml.vb#L55

For Each location In locations
    Dim pushpin As New MapPushpin() With {.Location = location.Location, .Information = location}
    AddHandler pushpin.MouseLeftButtonDown, AddressOf pushpin_MouseLeftButtonDown

how-to-manually-process-search-using-a-custom-search-panel-t189413/VB/MapControl_SearchPanel/MainWindow.xaml.vb#L78

sb.Append(String.Format(vbTab & "Adress: {0}" & vbLf, info.Address))
sb.Append(String.Format(vbTab & "Location: {0}" & vbLf, info.Location))
Return sb.ToString()