HowTo: Microsoft Virtual Earth (Praktischer Einstieg)

image

Nachdem ich bereits sehr kurz mal Google Map angerissen habe, möchte ich mich nun etwas intensiver mit Microsofts Variante beschäftigen: Virtual Earth.

Anders als Googles Dienst, kann man den Microsoft Dienst ohne Anmeldung nutzen und die Regeln für das Nutzen des Dienstes ist nicht ganz so streng.
Man kann zum Beispiel in einem Windows Programm (wie das geht erklär ich hoffentlich ein ander mal ;) ) Live Daten mit Virtual Earth anzeigen – bei Google Maps gabs wohl da Probleme (rechtliche – technisch bestimmt ebenso machbar), aber es kann sein, dass ich mich hier täusche.

Schritt 1: Informationen besorgen

Informationen rund um Virtual Earth findet man auf verschiedenen Stellen:

Insbesondere bei dem letzten Link sieht man mal, wie einfach es doch ist.
Wer allerding genau aufpasst und sich fragt, warum Oliver dort mit Koordinaten und nicht mit den Adressen von München arbeitet, der wird später feststellen, dass es keine schöne “Geocoder” Klasse gibt wie bei Google Maps, sondern nur eine “Find” Methode.

Schritt 2: Simple HTML Seite basteln

Den kompletten Beispielcode kann man am Ende runterladen, hier möchte ich nur kurz die wichtigsten Punkte erwähnen:

Das Einbinden des Virtual Earth Javascripts:
“<script language=”javascript” type=”text/javascript” src=”http://dev.virtualearth.net/mapcontrol/mapcontrol.ashx?v=5″></script>”

Dannach erstellt man einfach ein “VEMap(ZielDiv) Objekt und gibt als Parameter noch ein Zieldiv an wo es angezeigt wird. Dannach initialisiert man die Karte mit “LoadMap()” und schon gehts ab:

Javascript für das erstellen der Karte:

function GetMap()
{
map = new VEMap(‘<%=PanelMap.ClientID%>’); // ZielDiv
map.LoadMap();                                              // Karte initialisieren
map.SetZoomLevel(14);                                  // Zoomlevel
map.HideDashboard();                                    // Auswahloptionen verstecken
map.SetMapStyle(VEMapStyle.Aerial);           // Auf Arealsicht stellen
map.SetScaleBarDistanceUnit(VEDistanceUnit.Kilometers); // Von Meilen auf Kilometer umstellen

map.Find(”,’<%=Request.QueryString["destination"] %>, Germany’,null,null,0,1,false,false,false,true, onComplete); // Suchen
}

Am komplexesten ist die Find-Methode – anstatt dem <%=Request.QueryString["destination"] %> könnte man zum Beispiel auch “Dresden” hinschreiben – das brauchen wir nur für später.

Am wichtigsten ist eigentlich die “onComplete” Callbackmethode

Schritt 3: Verstehen wie das Geocoding funktioniert

Das wichtigste ist hier das Geocodeing zu verstehen – in der Find-Methode werden mehrere Parameter übergeben. Der letzte ist die Callbackmethode.
Diese Methode wird aufgerufen, nachdem der geocoding Vorgang abgeschlossen wurde.

Die onComplete Methode bei mir sieht so aus:

function onComplete(shape, FindResult, VEPlace, HasMoreFlag)
{
shape = new VEShape(VEShapeType.Pushpin, VEPlace[0].LatLong);
shape.SetTitle(VEPlace[0].Name);
map.AddShape(shape);
}

In dem VEPlace Array (!) verstecken sich die Koordinaten, diese übergebe ich dem VEShape Konstruktor und hab am Ende so ein “Pushpin”.

image

Downloads:

[Hier ein Link zur Demopage (Deutschland, normale größe)] & [Noch ein Link, diemal mit anderen Parametern dran(Berlin, größer)]

Als IFrame:

[Demo Source Code Downloaden]

Links:

Virtual Earth auf der dt. Live Seite
Virtual Earth @ MSDN Library
Virtual Earth @ MSDN
Virtual Earth SDK
Einführung in Windows Live (darunter auch Virtual Earth) von Oliver Scheer

Letzte Posts

  • image.png
    RavenHQ–RavenDB in der Cloud

    Ayende Rahien hat es heute verkündet – RavenHQ, der RavenDB Cloud Hoster (natürlich von und mit Ayende) ist ab heute raus aus der Beta und man kann es von überall aus nutzen. In der Betaphase waren nur Nutzer von AppHarbor zugelassen. Was ist RavenHQ? RavenHQ ist im Grunde ein gehostes RavenDB in den Rechenzentren von ...

  • image.png
    GitHub for Windows–erste Eindrücke

    Git ist schon eine tolle Sachen und eröffnet viele neue Möglichkeiten – allerdings ist der Einstieg recht hart und selbst wenn man die guten Hilfsanleitungen auf GitHub befolgt, kommt man am Anfang nur langsam vorwärt. Insbesondere ist das Tooling für Windows / .NET Entwickler auch nicht gerade “bekanntes Terrain”. GitHub to the rescue! Die GitHub ...

  • image.png
    Chocolatey–apt-get für Windows

    Durch Zufall bin ich auf das Tool “Chocolatey” gestoßen. Wer die Website sich anschaut, wird evtl. eine Verwandschaft mit NuGet ausmachen. Was macht Chocolatey? Chocolatey ist ein “Maschine Package Manager”, das bedeutet, dass man für seine Maschine einfach Tools runterladen und Updaten kann – direkt über die Konsole. Was ist der Unterschied zu NuGet? NuGet ...

  • image.png
    SASS, LESS & Coffeescript in Visual Studio mit der Web Workbench

    CSS und Javascript sind die “kleinste” Schnittmenge von allen Browsern für die Erstellung von Web-Applikationen. Leider geht dabei etwas komfort verloren, daher lieben alle Webentwickler jQuery! SASS und LESS sind zwei Varianten, wie man “schöner” CSS schreiben kann und Coffeescript versucht Javascript Entwicklung zu vereinfachen. Aber immer der Reihe nach… Was ist SASS? SASS steht ...

  • image.png
    Code-Inside Sample nun auf GitHub: Google Code zu GitHub Migration

    Seit einiger Zeit habe ich Beispielcode auf Google Code bereitgestellt. Einfach nur noch weg von Google Code O-Ton damals war: Ich hatte mich für Google Code entschieden, weil ich hoffe dass früher oder später die Google Code Suche nutzbar ist und es dadurch wenigstens ein kleiner Mehrwert entsteht. Allerdings wirft es momentan noch ein Fehler. ...

Support us!