BingLocationInformation.GeocodePoints Property

Gets or sets the collection of geocode points that a Bing Maps Service returns.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v24.1.dll

NuGet Package: DevExpress.Win.Map

Declaration

C#

[DefaultValue(null)]
public BingGeocodePoint[] GeocodePoints { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property GeocodePoints As BingGeocodePoint()

Property Value

Type	Default	Description
BingGeocodePoint[]	null	The collection of geocode points.

Remarks

Use the BingGeocodePoint.CalculationMethod property to determine how the geocode point is calculated. The BingGeocodePoint.UsageType property defines how the geocode point should be used.

The following example uses the GeocodePoints property to get geographical points for the Route and Display locations:

C#

private void searchProvider_SearchCompleted(object sender, BingSearchCompletedEventArgs e) {
  //...
  GeoPoint routeLocation = GetLocation((BingLocationInformation)e.RequestResult.SearchResults[0], BingUsageType.Route);
  GeoPoint displayLocation = GetLocation((BingLocationInformation)e.RequestResult.SearchResults[0], BingUsageType.Display);
}

GeoPoint GetLocation(BingLocationInformation locationInformation, BingUsageType usageType) {
  foreach (BingGeocodePoint geocodePoint in locationInformation.GeocodePoints)
      if ((geocodePoint.UsageType & usageType) != BingUsageType.None)
          return geocodePoint.Location;
  return null;
}

VB.NET

Private Sub searchProvider_SearchCompleted(ByVal sender As Object, ByVal e As BingSearchCompletedEventArgs)
    '...
    Dim routeLocation As GeoPoint = GetLocation(CType(e.RequestResult.SearchResults(0), BingLocationInformation), BingUsageType.Route)
    Dim displayLocation As GeoPoint = GetLocation(CType(e.RequestResult.SearchResults(0), BingLocationInformation), BingUsageType.Display)
End Sub

Private Function GetLocation(ByVal locationInformation As BingLocationInformation, ByVal usageType As BingUsageType) As GeoPoint
    For Each geocodePoint As BingGeocodePoint In locationInformation.GeocodePoints
        If (geocodePoint.UsageType And usageType) IsNot BingUsageType.None Then Return geocodePoint.Location
    Next

    Return DirectCast(Nothing, GeoPoint)
End Function

See the following article to get more information about location data returned from Bing Maps Services: Location Data.