Google Maps über COM (Component Object Model)

Thom

Use Google Maps API inside your Delphi application. Free, easy to use and much more powerful than a component.

Der Kern besteht aus einer Delphi-To-JavaScript-Bridge, mit deren Hilfe Delphi-Programme über das COM-Interface des Internet Explorers auf JavaScript-Objekte und -Funktionen zugreifen können. Die Kommunikation ist dabei bidirektional: Das bedeutet, daß Objekt- und anonyme Methoden aus JavaScript heraus aufgerufen werden können - zum Beispiel als Callback-Funktion, Event-Handler oder "injizierter" Code.

In diesem Framework wurde mit Hilfe dieser Delphi-To-JavaScript-Bridge das komplette Google Maps API abgebildet. Damit ist es möglich, alle Funktionen und Objekte dieses API's anzusprechen, ohne eine einzige Zeile JavaScript schreiben zu müssen.

Nun gibt es schon eine Reihe von Lösungsvorschlägen und Komponenten für Delphi, die das Google Maps API kapseln (ohne Anspruch auf Vollständigkeit):

jasontpenny (Lösungsansatz)
Rodrigo (Lösungsansatz)
TGoMaps (Komponente, kommerziell, 599 € + MwSt.)
TGoMaps Lite (Komponente, kostenlos, stark eingeschränkte Version von TGoMaps, dient als "Testversion" von TGoMaps)
TGAgisGoogleMap und TGAgisGoogleGeo (Komponenten, kommerziell, 799 USD + MwSt.)
TECMap (Komponente, kommerziell, 500 € + MwSt., Testkomponente auf Anfrage)
TMS WebGMaps (Komponenten, kommerziell, 95 € + MwSt.)
DelphiMaps (Komponenten, MPL 1.1)
GMLib (Komponenten, LGPL 3.0)

Weshalb dann noch dieses Framework?
Ganz klar zwei Gründe:

Der Preis. Für Freeware oder OpenSource, die nach den Lizenzbedingungen von Google keine Premier Lizenz benötigt, sind diese Preise indiskutabel. Eine kostenlose Version, die das komplette API bedient, ist mir nicht bekannt.
Die Flexibilität. Eine Komponente kann prinzipiell kein API ersetzen. Sie macht zwar die Arbeit des Programmierers bedeutend leichter und spart viel Zeit bei der Einarbeitung und Umsetzung des Projektes (bei kommerziellen Projekten ist Zeit gleich Geld, daher auch die hohen Preise für diese Komponenten) - schränkt aber mehr oder weniger stark ein.
Eine JavaScript-ähnliche Programmierung ist nicht möglich.

Mit diesem Framework können JavaScript-Beispiele ohne Probleme nach Delphi umgesetzt werden - mit den Vorteilen einer Code-Vervollständigung und komfortablen Debugging-Möglichkeiten.

Ein kleines Beispiel:

markieren

Code:

			[...]

<script type="text/javascript">

  function CreateMap() {

    var Options = {zoom: 13,

                   center: new google.maps.LatLng(47.651743,-122.349243),

                   mapTypeId: google.maps.MapTypeId.SATELLITE};

    new google.maps.Map(document.getElementById("div_map"),Options);

  };

</script>

</head>

<body onload="CreateMap()">

[...]

zusammenfalten · markieren

Delphi-Quellcode:

			procedure TForm1.FormShow(Sender: TObject);

begin

  if Script=nil then

    with TScript.Create(WebBrowser1) do

      LoadAPIAsync(InitMap);

end;

procedure TForm1.InitMap(Sender: TObject);

var

  Options: TMapOptions;

begin

  with TScript(Sender) do

  begin

    Options:=TMapOptions.Create;

    with Options do

    begin

      Zoom:=13;

      Center:=New(Google.Maps.LatLng(47.651743,-122.349243));

      MapTypeID:=Google.Maps.MapTypeID.Satellite;

    end;

    New(Google.Maps.Map(Options));

  end;

end;

In der aktuellen Version 2.0 besteht das Framework aus rund 30000 Quelltextzeilen, 10000 Zeilen Dokumentation im XML-Format und rund 10000 Zeilen in reichlich 80 Demos.

Systemvoraussetzungen

Delphi ab Version 5 (empfohlen Delphi 2009 oder neuer zur Nutzung von Unicode und anonymen Methoden)
Internet Explorer ActiveX (zum Beispiel TWebBrowser (1) oder TEmbeddedWB)
bei einigen Demos installierte Indy-Komponenten
bei einer Demo eine installierte TChart-Komponente

Das Framework wurde bisher mit folgenden Delphi-Versionen getestet:

Delphi 5
Delphi 7 (vielen Dank an angos!) (2)
Delphi 2005
Delphi 2007
Delphi 2010
Delphi XE
Delphi XE2 32/64 Bit
Delphi XE3 32/64 Bit (vielen Dank an Stefan für die angepaßte inc-Datei und für's Testen!)
Delphi XE4 32/64 Bit
Delphi XE5 32/64 Bit

Bekannte Probleme

In Zusammenhang mit dem Internet Explorer 6 (sollte eigentlich keiner mehr benutzen):

Darstellungsfehler bei Schatteneffekten
langsamer Schatten- und Bildaufbau
keine Überblendeffekte
keine Base64/Data-Unterstützung
Probleme bei der Nutzung von Icons (die Demos Icon Simple und Icon Complex bleiben hängen)
keine Animation von Markern
das StreetView-Symbol verschwindet sporadisch

Allgemein:

werden vor Delphi 2007 TGIFImage und vor Delphi 2009 TPNGImage verwendet (bis dahin nicht Bestandteil von Delphi), können die entsprechenden Compilerschalter in der Datei gmConfig.inc aktiviert werden
die integrierte XML-Hilfe funktioniert noch nicht richtig und ist noch nicht vollständig
unter den verstärkten Sicherheitseinstellungen für den Internet Explorer in einem Server-System konnte bisher kein Zugriff auf die Funktionen der JavaScript-Engine hergestellt werden
die Demo Places Autocomplete führt unter IE9 64 Bit zu einem Absturz des Programmes, wenn das Edit-Feld benutzt wird

Installation, Migration bestehender Projekte

Da es sich um ein Framework handelt, muß nichts in der IDE installiert werden - es müssen lediglich die Pfade zur gmConfig.inc sowie den Verzeichnissen API und JScript eingetragen werden (global oder in den Projekt-Optionen).

Die Umstellung von bestehenden Projekten unter Verwendung der Versionen 1.x auf die Version 2.0 sollte sich in der Regel auf die Anpassung der Unit-Namen beschränken. Um eine bessere Übereinstimmung zur Google Maps API-Dokumentation zu erzielen, wurden einige Units umbenannt. Auf die Einführung eines Namespace wurde mit Rücksicht auf ältere Delphi-Versionen (noch) verzichtet.
Es wird empfohlen, die Initialisierung der Karte in eine separaten Methode auszulagern, um den Refresh-Mechanismus (Taste F5) des Frameworks nutzen zu können.

Lizenz

(Möglichst) kurz und schmerzlos:
Ich mag keine seitenlangen Texte, die meist nur verunsichern (siehe aktuelle Problematik mit einer speziellen Datenbank) und die sowieso kaum jemand liest. Noch weniger mag ich Quelltexte, die am Anfang einen Hinweis enthalten, der länger ist als der eigentliche Code. Auch bin ich aus dem Alter heraus, in dem ich nach jeweils drei Zeilen mein Copyright hinterlassen muß, als hätte ich die genialste Erfindung aller Zeiten gemacht und müßte wie ein Hund mein Revier markieren. Wer das nötig hat, soll das machen - ich jedenfalls nicht.
Deshalb nur folgende Regeln:

Die Nutzungsbedingungen von Google sind zu beachten.
Die Verwendung des Frameworks ist kostenfrei, wenn die Anwendung, die damit erstellt wurde, kostenlos und frei für alle zur Verfügung steht (siehe Lizenzbestimmungen von Google: Das schließt zum Beispiel die Kopplung an kostenpflichtige Hard- oder Software und eine innerbetriebliche Nutzung aus!!!). Das veröffentlichte Programm muß keinesfalls OpenSource sein.
Keine Leistung - keine Verpflichtung. Wird das Framework in der kostenlosen Community-Edition verwendet, gibt es keinen Anspruch auf Bugfixes, Updates oder Hilfe. Das bedeutet natürlich nicht, daß ich hier im Forum nicht mehr auf Fragen antworte.
Für jegliche andere Nutzung (kommerziell, innerbetrieblich, geschlossene Benutzergruppe) ist eine Lizenzierung bei Google und mir notwendig. Bei Nachfrage bitte per PM oder Email melden. Von meiner Seite sind dann Bugfixes, Updates und Support für ein Jahr garantiert.
Wem das Framework gefällt und wer die Weiterentwicklung unterstützen möchte, kann das in Form eine Spende tun. Ab einer Spendenhöhe von gegenwärtig 25 € erhält der/die Spender/in als Dankeschön zusätzliche Units, Komponenten und Demos (siehe Abschnitt Erweiterungen) sowie alle weiteren Bonus-Komponenten, die in der Version 2.x veröffentlicht werden. Falls jemand kein PayPal-Konto besitzt, kann er mich auch für eine direkte Überweisung (innerhalb Deutschlands) kontaktieren. Für einen Betrag von mindestens 100 € wird der Spender namentlich genannt (falls er nicht anonym bleiben möchte). (3)

Erweiterungen

Panoramio API
- Wrapper-Unit
- Demo
KeyDragZoom Library
- Wrapper-Unit
- sechs Demos
MarkerClustererPlus Library
- Wrapper-Unit
- fünf Demos
RichMarker Library
- Wrapper-Unit
- zwei Demos

Viel Spaß!

(1) Wer für die Starter Editionen (XE bzw. XE2) keine TWebBrowser-Komponente besitzt, kann diese

hier nachrüsten.
(2) siehe

Beitrag
(3) Spenden über

PayPal (Bitte Name und Email-Adresse angeben, damit ich die Bonus-Units versenden kann.)

**Thom**

Hallo DelphiFan2008,

ich weiß nicht, ob's die irgendwo einzeln gibt. Sie sollte aber in den anderen

Jedi-Bibliotheken enthalten sein.

P.S.:
Ich habe jetzt noch einmal alles getestet:
Das Framework Version 1.1 läßt sich unter Delphi XE2 ungeändert sowohl in 32 als auch 64 Bit compilieren. Besser ist natürlich eine aktuelle jedi.inc. Notfalls tut es auch die von mir angepaßte Version im Anhang. Dabei handelt es sich aber um keine offizielle Version und sie erhebt auch keinen Anspruch auf Vollständigkeit. Ich habe nur die vom Framework verwendeten Compilerschalter aktualisiert. Die Demos sollten ebenfalls funktionieren.

**NetSonic**

Hey Thom,

super cooles Projekt, was Du hier auf die Beine gestellt hast. Ich habe mir Dein Framework in Version 1.1 einmal angesehen und wollte jetzt etwas mit den Directions und Wegpunkten probieren. Allerdings wäre es super zu wissen, wie ich einem DirectionRequest weitere Wegpunkte hinzufügen kann! Das ist mir bisher nicht gelungen:

markieren

Delphi-Quellcode:

			var

DirectionsRequest: TDirectionsRequest;

WayPoint: TDirectionsWayPoint;

begin

...

WayPoint := TDirectionsWayPoint.Create;

WayPoint.LocationAsString := 'Adresse';

DirectionsRequest.WayPoints.Add(WayPoint);

...

Vielen Dank und

für Deine Arbeit hier! Ganz großes Tennis

**Thom**

Vielen Dank!

Du mußt einfach einen weiteren Punkt erstellen und dem Array hinzufügen:

zusammenfalten · markieren

Delphi-Quellcode:

			  [...]

  WayPoint:=TDirectionsWaypoint.Create;

  WayPoint.LocationAsString:='ErsterPunkt';

  DirectionsRequest.WayPoints.Add(WayPoint);

  WayPoint:=TDirectionsWaypoint.Create;

  WayPoint.LocationAsString:='ZweiterPunkt';

  DirectionsRequest.WayPoints.Add(WayPoint);

  WayPoint:=TDirectionsWaypoint.Create;

  WayPoint.LocationAsString:='UndNochEiner';

  DirectionsRequest.WayPoints.Add(WayPoint);

  [...]

Ohne Google's Premier Lizenz ist die Anzahl der Wegpunkte allerdings beschränkt.

Edit:
Sorry: Das funktioniert noch nicht in Version 1.1.

Wenn Du mir Deine Emailadresse per PM mitteilst, würde ich Dir Version 1.3 zusenden. Damit klappt es.

**NetSonic**

Alles klar, es funktioniert. Vielen Dank.

Jetzt würde mich aber noch interessieren, wie ich die Länge der ermittelten Route und der einzelnen Wege, falls Wegpunkte gesetzt sind, auslesen kann. In Deiner Beispiel-Anwendung "Directions" habe ich dazu nichts gefunden. Habe dort nur den Quellcode-Schnipsel der Callback-Funktion:

zusammenfalten · markieren

Delphi-Quellcode:

			procedure TForm1.DirectionsCallback(Sender: TObject; Result: TDirectionsResult; Status: String);

var

  n, r, l, s: Integer;

  DirectionsRendererOptions: TDirectionsRendererOptions;

  procedure AddMsg(Msg: String);

  begin

    Memo1.Lines.Add(Msg);

  end;

begin

  with Script do

  begin

    Memo1.Lines.Clear;

    if Status=Google.Maps.DirectionsStatus.Ok then

    begin

      for r:=0 to Result.Routes.Count-1 do

        for l:=0 to Result.Routes[r].Legs.Count-1 do

          for s:=0 to Result.Routes[r].Legs[l].Steps.Count-1 do

            AddMsg(Result.Routes[r].Legs[l].Steps[s].Instructions);  //Richtungshinweise von Start zum Ziel

      for n:=0 to Result.Routes[0].Warnings.Count-1 do

        AddMsg(Result.Routes[0].Warnings[n]);                        //Warnhinweise zur berechneten Route

      AddMsg(Result.Routes[0].Copyrights);                           //Copyright-Informationen zur berechneten Route

      DirectionsRendererOptions:=TDirectionsRendererOptions.Create;  //Darstellung der berechneten Route vorbereiten

      DirectionsRendererOptions.Directions:=Result;                  //Ergebnisse übergeben

      DirectionsRendererOptions.Map:=Maps[0];                        //Karte übergeben

      Google.Maps.DirectionsRenderer(DirectionsRendererOptions);     //berechnete Route darstellen

    end else Memo1.Lines.Add(Status);

  end;

end;

Außerdem würde mich interessieren, wie ich die Routenanweisungen auf Deutsch und ggf. noch anders formatiert erhalten kann. Gerne auch in dem Layout, welches bei Google Maps zur Darstellung der Routeninformationen genutzt wird - ist das überhaupt möglich?

Über einen Tipp würde ich mich freuen.

Gruß
NetSonic

**Thom**

Schön, daß es funktioniert!

Die Gesamtlänge eine Strecke bzw. Gesamtreisedauer kann zum Beispiel so ermittelt werden:

markieren

Delphi-Quellcode:

			  TotalDistance:=0;

  TotalDuration:=0;

  with Result.Routes[0] do //<- erste Route

    for Leg:=0 to Legs.Count-1 do //<- alle Abschnitte durchgehen

      with Legs[Leg] do

      begin

        Inc(TotalDistance,Distance.Value); //<- Länge des Abschnitts

        Inc(TotalDuration,Duration.Value); //<- Reisedauer für diesen Abschnitt

      end;

Google Maps arbeitet mit den Spracheinstellungen des PC's. Auf meinem sendet der IE also ein 'de' - dementsprechend werden alle Menüs und Ausgaben auf Deutsch angezeigt. Es ist aber auch möglich, eine bestimmte Sprache zu erzwingen. Das geht beim Laden des API's. In der kommenden Version des Frameworks kann sie als Parameter angegeben werden:

markieren

Delphi-Quellcode:

			 
procedure TScript.LoadAPIAsync(InitMapProc: TNotifyEvent; 

                               UseSensor: Boolean; 

                               Version: String;

                               Language: String; //<- 'de' 

                               Libraries: TGoogleLibraries);

In den älteren Versionen (1.1 - 1.3) muß dafür in der Unit gmAPI die Funktion HTMLPage angepaßt werden:

zusammenfalten · markieren

Delphi-Quellcode:

			  [...]

  Result:=Result+

          '    <script type="text/javascript" src="http://maps.google.com/maps/api/js?&sensor=';

  if UseSensor

    then Result:=Result+

        'true'

    else Result:=Result+

          'false';

  //zusätzlich:

  Result:=Result+'&language=de';

  [...]

So sieht zum Beispiel die Routenplanung mit 'ru' aus:

Allerdings funktioniert Unicode nur mit den entsprechenden Compilern und erst ab Version 2.0 des Frameworks.

Die Routeninformationen werden mit HTML-Tags (zum Beispiel <b></b>) geliefert. Die müßten dann selbst oder durch eine geeignete Komponente geparst und dargestellt werden.

**NetSonic**

Danke für die ausführliche Info. Ich werde mir das einmal ansehen. Die Ergebnisse der Routenbeschreibung zeige ich mir bereits in einer TWebBrowser-Komponente formatiert an. Ich dachte nur, es gebe ggf. auch über die API und Deine Schnittstelle Layout-Möglichkeiten.

Wann wirst Du denn die neue Version Deines Frameworks veröffentlichen? Gibt es da ein konkretes Ziel?

**Thom**

Nein, leider nicht: Momentan habe ich noch keine spezielle Komponente für die Ausgabe. Aber das wäre eine gute Idee für die Zukunft.
Ich habe mir nämlich überlegt, den Quelltext für etwas umfangreichere Demos und kleine "Helferlein" (wie spezielle Ein- und Ausgabekomponenten) als Dankeschön exklusiv an fleißige Tester und Spender zu vergeben.

Ich babe zur Anzeige einmal

TRichView mit einem HTML-Importer verwendet:

Die Handhabung ist einfach: Alle Ausgaben werden in einer lokalen Stringliste zwischengespeichert und zum Schluß angezeigt:

markieren

Delphi-Quellcode:

			  [...]      

  RichView.Clear;

  HtmlImporter.LoadHtml(UTF8Encode(Messages.Text));

  RichView.Format;

  [...]

Man könnte natürlich noch zusätzlich die Entfernung und die Fahrzeit integrieren.

Wann die neuen Version fertig ist?

Gute Frage...

Die Integration der Google-Bibliotheken, dazugehörige Dokumentation, Demos und Tests haben mich jetzt drei Wochen (3*7*12 also rund 250 Stunden) gekostet. Ich wollte ganz gern noch die Distanz-Matrix und StreetView integrieren. Die XML-Dokumentation wird auf jeden Fall nicht komplett fertig - die wird nach und nach kommen.

Ich bin erst einmal froh, daß sich die aktuellen Versionen auch mit XE2 vertragen - und das sogar ohne Änderung.
Vielen Dank dabei an DelphiFan2008, der mit XE2 Starter alles - einschließlich der Demos - getestet und nur einige wenige Probleme entdeckt hat.

Fazit: Ich beeile mich...

**Thom**

So - es wird langsam Zeit für die neue Version. Ich hoffe, daß ich das Framework in etwa ein bis zwei Wochen für einen Beta-Test fertig habe.

Da sich intern einiges getan hat und viele neue Funktionen hinzugekommen sind, wird es nicht - wie angekündigt - die Version 1.4 sondern 2.0.
So wurde ein interner Callback-Manager integriert, der es ermöglicht, bei asynchronen Aufrufen des API's neben herkömmlichen Objekt-Methoden auch anonyme Methoden als Callback-Funktion einzusetzen. Damit sind dann auch solche JavaScript-ähnlichen Konstruktionen wie in der

Distanz-Matrix-Demo möglich:

markieren

Code:

			  geocoder.geocode({'address': location}, function(results, status) {

    if (status == google.maps.GeocoderStatus.OK) {

      bounds.extend(results[0].geometry.location);

      map.fitBounds(bounds);

      var marker = new google.maps.Marker({

        map: map,

        position: results[0].geometry.location,

        icon: icon

      });

    } else {

      alert("Geocode was not successful for the following reason: " + status);

    }

  });

zusammenfalten · markieren

Delphi-Quellcode:

			  Geocoder.Geocode(TJScriptObject.Create(['address: '+Location]),

    procedure(Sender: TObject; Results: TGeocoderResultArray; Status: String)

    var

      Opts: TMarkerOptions;

    begin

      with Script do

      begin

        if Status=Google.Maps.GeocoderStatus.OK then

        begin

          Bounds.Extend(Results[0].Geometry.Location);

          Maps[0].FitBounds(Bounds);

          Opts:=TMarkerOptions.Create;

          with Opts do

          begin

            Map:=Maps[0];

            Position:=Results[0].Geometry.Location;

            Icon:=MarkerIcon;

            Title:=Location;

          end;

          New(Google.Maps.Marker(Opts));

        end else ShowMessage('Geocode was not successful for the following reason: '+Status);

      end;

    end);

Bei den Objektlisten des TScript-Objektes wurden Iteratoren hinzugefügt, die den for-in Syntax unterstützen:

markieren

Delphi-Quellcode:

			  for Marker in Script.Markers do

    Marker.Map:=nil;

Zusätzlich wurden alle Units von RTTI-Rückständen befreit und damit ein fertiges Programm um reichlich 300 kByte (Beispiel für Delphi XE) verkleinert, obwohl das Framework selbst beachtlich an Umfang zugelegt hat.

Desweiteren sind Spenden herzlich willkommen.

PayPal

**Thom**

Hey Markus,

here is a little demo with the framework version 2.
Is this what you mean with multiple destinations?

Diese Demo zeigt übrigens auch die Behandlung der Refresh-Taste F5.

**fduenas**

Zitat von Thom:

Hey Markus,

here is a little demo with the framework version 2.

Diese Demo zeigt übrigens auch die Behandlung der Refresh-Taste F5.

Hi Tom. When will your Framework 2 be available?

Erstellt von	For	Type	Datum
DELPHI \| (google maps)	This thread	Refback	11. Nov 2011 10:07
Twebbrowser HTML tag to UniHTMLFrame1 - uniGUI Discussion Forums	This thread	Refback	4. Nov 2011 07:52
DoraDev1975: google maps	This thread	Refback	23. Sep 2011 09:18
delphi osm - Google Search	Post #0	Refback	19. Sep 2011 10:02
DoraDev1975: ?ิ????? 2011	This thread	Refback	11. Sep 2011 17:39
DoraDev1975	This thread	Refback	30. Aug 2011 11:13
Untitled document	This thread	Refback	25. Jun 2011 20:57
Interact with Google Maps in a TWebBrowser from Delphi \| Ramblings	This thread	Refback	26. Jan 2011 06:12
google maps mit delphi link - Google Search	This thread	Refback	24. Jan 2011 15:24
google maps mit delphi - Google Search	This thread	Refback	24. Jan 2011 15:20
Untitled document	This thread	Refback	19. Jan 2011 22:49

Google Maps über COM (Component Object Model)

Forumregeln

LinkBack to this Thread

fduenas	#130 26. Sep 2011, 19:10 Zitat von Thom: Hey Markus, here is a little demo with the framework version 2. Diese Demo zeigt übrigens auch die Behandlung der Refresh-Taste F5. Hi Tom. When will your Framework 2 be available?
	Zitat