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
    IIS & Windows Authentication – Troubleshooting mit Negotiate & NTLM

    Windows Authentifizierung ist eine einfache (und naheliegende) Authentifizierungs-Option für “Haus-interne” Webapplikationen. Setup Im IIS selbst kann man die Windows Authentifzierung sehr leicht anschalten: Natürlich kann man dies auch über die web.config steuern: <system.web> ... <authentication mode="Windows"/> ... </system.web> ... Fehlermeldung “HTTP Error 401.2 – Unauthorized”: Dies kann (wie fast immer) viele Gründe haben, z.B. weil ...

  • image.png
    Json-Online-Tools: Viewer & Json2Csharp Generator

    Wo APIs im Spiel sind, ist das JSON Format nicht weit. Da ich immer mal wieder zwei Tools benutze, möchte ich diese hier auch mal kurz würdigen. JSON Viewer Wer nur den JSON-Text vor sich hat sieht meist die Struktur nicht. Über JSON Viewer kann man sich recht einfach einen Überblick verschaffen: [URL] JSON2CSharp Der ...

  • image.png
    Tools & Vorgehen für Entwicklung rund um OpenXml oder wie erstelle ich Office Dokumente mit .NET?

    Durch meine Tätigkeit bei der  OneOffixx AG habe ich recht tiefe Einblicke in die Erstellung von Microsoft Office Dokumente mit .NET bekommen. Da das Problem “Office Dokumente per Code” zu erstellen recht verbreitet ist, schreib ich mal Empfehlungen für die ersten Schritte. Must Have Tools Ganz klar sollte man das Office in der jeweiligen Version ...

  • image.png
    Windows Phone SDK- & “System”-Icons

    Zwar legt das Metro Design viel Wert auf Typografie – jedoch sind auch Icons sehr wichtig. Wer das Windows Phone SDK installiert hat, bekommt 36 Icons mitgeliefert. Diese sind unter diesem Pfad zu finden: C:\Program Files (x86)\Microsoft SDKs\Windows Phone\v8.0\Icons Viele Icons, welche man von den eingebauten Anwendungen kennt, sind allerdings nicht enthalten. Pedro Lamas hat ...

  • image.png
    Wie finde ich heraus ob mein ADFS 2.0 funktioniert?

    Ich hatte mich recht lange mti dem Thema ADFS 2.0 (“Active Directory Federation Services”) beschäftigt und da kam die recht einfache Frage auf: Wie stelle ich fest ob die Verbindung zwischen ADFS und AD “funktioniert”? Hier eine simple Variante es zu testen… Was ist ein ADFS überhaupt? Wenn man über AD-Grenzen hinweg “Vertrauensstellungen” braucht, dann ...

Support us!