BingMaps GeocodeService

Home » Dev » BingMaps GeocodeService

BingMaps GeocodeService

18. Mai 2011

Einführung

In meinem ersten Blog-Beitrag Microsoft Bing Maps for Enterprise, habe ich über die Darstellung von Punkten, ohne Einbindung eines Webservices, auf einer BingMaps-Karte gesprochen.

Microsoft bietet aber auch 3 verschiedene WebServices für die Darstellung von Punkten, Linien oder Bereichen auf Karten an. Diese wären:

In diesem Blog-Beitrag möchte ich die Verwendung des GeocodeService in BingMaps erläutern.

Wozu verwende ich den GeocodeService?

Mit Hilfe des GeocodeService wird eine Abfrage an den Webservice gestellt, der die Koordinaten (Längen- und Breitengrad) im Format WGS84 für die zu suchende Adresse zurückliefert. Daher bietet sich die Verwendung des GeocodeService besonders für die Suche bestimmter Adressen an.

Voraussetzungen

BingMaps-Key
Visual Studio
Silverlight

Falls Sie noch keinen BingMaps-Key haben, können Sie sich hier einen erstellen.

Silverlight Applikation

Als erster Schritt wird eine neue Silverlight-Applikation erstellt und der GeocodeService als Service Reference hinzugefügt. Hierzu klicken Sie mit der rechten Maustaste auf das Projekt und wählen Add Service Reference. Geben Sie als Adresse http://dev.virtualearth.net/webservices/v1/GeocodeService/GeocodeService.svc ein und klicken auf Go. Nennen Sie den Namespace GeocodeService.

Im nächsten Schritt werden eine Textbox zum Eingeben der Adresse und ein Button zum Abschicken erstellt. Des Weiteren werden noch zwei Textblöcke zum Ausgeben der Koordinaten (Längen- und Breitengrad) sowie eine Karte zum Darstellen der Suchergebnisse, erstellt.

<Grid x:Name="LayoutRoot" Background="White">
  <Grid.RowDefinitions>
    <RowDefinition Height="auto"/>
    <RowDefinition Height="*"/>
  </Grid.RowDefinitions>
  <Grid Grid.Row="0">
    <Grid.RowDefinitions>
      <RowDefinition Height="30" />
      <RowDefinition Height="30" />
      <RowDefinition Height="30" />
    </Grid.RowDefinitions>
    <Grid.ColumnDefinitions>
      <ColumnDefinition Width="75"/>
      <ColumnDefinition Width="auto" />
      <ColumnDefinition Width="*" />
    </Grid.ColumnDefinitions>
    <TextBlock Grid.Row="0" Grid.Column="0" Text="Adresse:" HorizontalAlignment="Left"/>
    <TextBox Name="txtStart" Grid.Row="0" Grid.Column="1" Text="Bitte Adresse oder Koordinaten eingeben!" Background="LightGray" Width="500" HorizontalAlignment="Left"/>
    <Button Name="btnShowResult" Grid.Row="0" Grid.Column="2" Content="Finden" Background="Black" Width="100" HorizontalAlignment="Left" Click="btnShowResult_Click"/>
    <TextBlock Grid.Row="1" Grid.Column="0" Text="Latitude" HorizontalAlignment="Left"/>
    <TextBlock Name="txtLatitude" Grid.Row="1" Grid.Column="1"/>
    <TextBlock Grid.Row="2" Grid.Column="0" Text="Longitude" HorizontalAlignment="Left"/>
    <TextBlock Name="txtLongitude" Grid.Row="2" Grid.Column="1"/>
  </Grid>
  <map:Map x:Name="geocodeMap" CredentialsProvider="<Your Key>" Grid.Row="1">
    <map:MapLayer x:Name="geocodeLayer" />
  </map:Map>
</Grid>

In den beiden nachfolgenden Funktionen werden die Geocode-Methoden des GeocodeService aufgerufen, um die Koordinaten (Längen- und Breitengrad) für die Adresse zu erhalten und ein Pushpin (Marker) für die Darstellung erstellt.

public void GetGeocode()
{
    // Request an den Geocode-Webservice 
    var request = new GeocodeService.GeocodeRequest
    {
        ExecutionOptions = new GeocodeService.ExecutionOptions { SuppressFaults = true },
        Credentials = new Credentials { Token = "<Your Key>" },
        Query = txtStart.Text
    };
 
    var client = new GeocodeService.GeocodeServiceClient("BasicHttpBinding_IGeocodeService");
    client.GeocodeCompleted += client_FindGeocodeCompleted;
    client.GeocodeAsync(request);
}

private void client_FindGeocodeCompleted(object sender, GeocodeService.GeocodeCompletedEventArgs e)
{
    try
    {
        if (e.Result.ResponseSummary.StatusCode != GeocodeService.ResponseStatusCode.Success)
        {
            MessageBox.Show("Error geocoding ... status <" + e.Result.ResponseSummary.StatusCode.ToString() + ">");
        }
        else if (0 == e.Result.Results.Count)
        {
            MessageBox.Show("No Results");
        }
        else
        {
            Location location = new Location(e.Result.Results[0].Locations[0].Latitude, e.Result.Results[0].Locations[0].Longitude);
            //Ausgeben des Längen- und Breitengrades
            txtLatitude.Text = location.Latitude.ToString();
            txtLongitude.Text = location.Longitude.ToString();
 
            //Setze die Sicht der Karte auf die aktuellen Koordinaten 
            geocodeMap.SetView(location, 15);
            Pushpin point = new Pushpin();
            MapLayer.SetPosition(point, location);
            MapLayer.SetPositionOrigin(point, PositionOrigin.Center);
 
            //Erstelle einen Pushpin auf der Karte um den Punkt anzuzeigen. 
            geocodeLayer.Children.Add(point);
        }
    }
    catch
    {
        MessageBox.Show("Exception raised");
    }
}

Anschließend ist in der Click-Methode des Finden-Buttons nur noch die GetGeocode-Methode aufzurufen.

private void btnShowResult_Click(object sender, RoutedEventArgs e)
{
  //Durch Bestätigen des Buttons Finden führe die Funktion GetGeocode() aus.
  GetGeocode();
}

Ergebnis

Starten Sie nun die Solution und geben eine Adresse ein. Klicken Sie anschließend auf Finden um den GeocodeService anzusprechen.

In dem folgenden Screenshot kann man erkennen, dass nachdem ich eine Adresse eingeben und auf den Button Finden gedrückt habe, oberhalb der Karte die Koordinaten und in der Karte ein Pushpin an der gesuchten Adresse angezeigt werden.

In meinem nächsten Blog-Beitrag werde ich die Verwendung des RouteService in BingMaps erläutern.