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.)

**azrin.aris**

Dear Thomas,

Thank you for your great contribution. I do not understand German so I use google translate to try to understand your blog. I've downloaded your version 2 and try to compile on on Delphi XE2 - my ultimate is to use C++ Builder. Initially I got some problem to compile but now everything works fine. I'm learning the examples now.

Thank you

**beeglext**

error inslal TWebBrowser Delphi7

http://s47.radikal.ru/i116/1112/bc/2b5714883b81.jpg
help please

**Thom**

Hi Azrin,

thank you very much! Unfortunately I have only Delphi and not RAD Studio, so I could test it yet. If there are problems again, please tell about it!

Hi Дмитрий,

Delphi 7 has a integrated TWebBrowser component (dclie70.bpl). You do not need a additional component.

**beeglext**

Thom, спасибо (thank you)

**azrin.aris**

Zitat von Thom:

Hi Azrin,

thank you very much! Unfortunately I have only Delphi and not RAD Studio, so I could test it yet. If there are problems again, please tell about it!

Hi Thom,

I mange to port 2 of your samples int C++ Builder. Now I'm trying to port one of Events sample - the DOMListener sample. Unfortunately, I stuck

here is the code in Delphi (from your sample)

zusammenfalten · markieren

Delphi-Quellcode:

			    {$IFDEF USE_ANONYMOUS_METHODS}

    Google.Maps.Event.AddDomListener(Map.Container,'click',NewFunction(

      procedure(Sender: TObject)

      var

        Event: TJScriptObject;

      begin

        //'Sender' is the TJScriptObject that was created with 'NewFunction()'

        //The 'click' event has one parameter - a object with the x and y

        //position of the click.

        Event:=TJScriptObject(CreateObjectWrapper(Script,TJScriptObject,

                                                  TJScriptFunction(Sender).Arguments[0]));

        ShowMessage('DIV clicked'+', ('+

                    'x: '+IntToStr(Event.Properties['x'])+', '+

                    'y: '+IntToStr(Event.Properties['y'])+')');

      end));

    {$ELSE}

    Google.Maps.Event.AddDomListener(Map.Container,'click',NewFunction(DIVClick));

    {$ENDIF}

I also attached here are the C++ codes that I manage to port and compile and is working

**azrin.aris**

Hi all,

Here is another stumbling block that I encounter

the delphi code is:

zusammenfalten · markieren

Delphi-Quellcode:

			procedure TForm1.InitMap(Sender: TObject);

var

  Marker: TMarker;

  MarkerOptions: TMarkerOptions;

  MyMap: TMap;

  MyOptions: TMapOptions;

begin

  with TScript(Sender) do

  begin

    MyOptions:=TMapOptions.Create;

    with MyOptions do

    begin

      Zoom:=4;

      Center:=New(Google.Maps.LatLng(-25.363882,131.044922));

      MapTypeID:=Google.Maps.MapTypeID.Roadmap;

    end;

    MyMap:=New(Google.Maps.Map(MyOptions));

    MarkerOptions:=TMarkerOptions.Create;

    with MarkerOptions do

    begin

      Position:=MyMap.GetCenter;

      Map:=MyMap;

      Title:='Click to zoom';

    end;

    Marker:=New(Google.Maps.Marker(MarkerOptions));

    {$IFDEF USE_ANONYMOUS_METHODS}

    Marker.OnClick:=

      procedure(Sender: TObject; Event: TEvent)

      begin

        if MyMap.GetZoom=8

          then MyMap.SetZoom(4)

          else MyMap.SetZoom(8);

        MyMap.SetCenter(Marker.GetPosition);

      end;

    {$ELSE}

    Marker.OnClick:=MarkerClick;

    {$ENDIF}

  end;

end;

{$IFNDEF USE_ANONYMOUS_METHODS}

procedure TForm1.MarkerClick(Sender: TObject; Event: TEvent);

begin

  with Script do

  begin

    if Maps[0].GetZoom=8

      then Maps[0].SetZoom(4)

      else Maps[0].SetZoom(8);

    Maps[0].SetCenter(TMarker(Sender).GetPosition);

  end;

end;

{$ENDIF}

and the C++ code is:

markieren

Code:

			//---------------------------------------------------------------------------

#ifndef Unit1H

#define Unit1H

//---------------------------------------------------------------------------

#include <System.Classes.hpp>

#include <Vcl.Controls.hpp>

#include <Vcl.StdCtrls.hpp>

#include <Vcl.Forms.hpp>

#include <SHDocVw.hpp>

#include <Vcl.OleCtrls.hpp>

#include "gmAPI.hpp"

#include "gmMap.hpp"

#include "gmOverlaysMarker.hpp"

#include "gmEvents.hpp"

#include "HTMLObjects.hpp"

//---------------------------------------------------------------------------

class TForm1 : public TForm

{

__published:    // IDE-managed Components

    TWebBrowser *WebBrowser1;

    void __fastcall FormCreate(TObject *Sender);

private:    // User declarations

    TScript *Script;

    void __fastcall InitMap(TObject *Sender);

public:        // User declarations

    __fastcall TForm1(TComponent* Owner);

    void __fastcall MarkerClick(TObject* Sender, Gmevents::TEvent Event);

};

//---------------------------------------------------------------------------

extern PACKAGE TForm1 *Form1;

//---------------------------------------------------------------------------

#endif

//Unit1.cpp

//---------------------------------------------------------------------------

#include <vcl.h>

#pragma hdrstop

#include "Unit1.h"

//---------------------------------------------------------------------------

#pragma package(smart_init)

#pragma resource "*.dfm"

#pragma link "gmMap"

#pragma link "winInet.lib"

TForm1 *Form1;

//---------------------------------------------------------------------------

__fastcall TForm1::TForm1(TComponent* Owner)

   : TForm(Owner)

{

}

//---------------------------------------------------------------------------

void __fastcall TForm1::FormCreate(TObject *Sender)

{

   Script = new TScript(WebBrowser1);

   Script->LoadAPIAsync(InitMap);

}

//---------------------------------------------------------------------------

void __fastcall TForm1::InitMap(TObject *Sender)

{

   int n;

   TMarker *Marker;

   TMarkerOptions *MarkerOptions;

   TLatLng *MyLatLng;

   TMap *MyMap;

   TScript *Script = dynamic_cast<TScript*>(Sender);

   TMapOptions *MyOptions = new TMapOptions;

   MyOptions->Zoom = 4;

   MyOptions->Center = Script->Google->Maps->LatLng(-25.363882,131.044922);

   MyOptions->MapTypeID = Script->Google->Maps->MapTypeID->Roadmap;

   MyMap = Script->Google->Maps->Map(MyOptions);

   MarkerOptions = new TMarkerOptions;

   MarkerOptions->Position = MyMap->GetCenter();

   MarkerOptions->Map      = MyMap;

   MarkerOptions->Title   = "Click to Zoom";

   Marker = Script->Google->Maps->Marker(MarkerOptions);

   Marker->OnClick = MarkerClick;   //[BCC32 Error]  Member function must be called or its address taken

   delete MyOptions;

   delete MarkerOptions;

}

//---------------------------------------------------------------------------

void __fastcall TForm1::MarkerClick(TObject* Sender, Gmevents::TEvent Event)

{

   if(Script->Google->Maps[0]->GetZoom==8) // Error :E2288 Pointer to structure required on left side of -> or ->*

   {

   }

}

//---------------------------------------------------------------------------

I could not get the MarkerClick to be assigned to Marker->OnClick.

Also I could not find the Script->Google->Maps[0]->GetZoom() function.

Attached is the hpp file converted by C++ Builder

Anyhelp would be very much appreciated.

Thank you

**Thom**

Hi Azrin,

Thank you for your work!
Unfortunately I have no C++ or RAD Studio, so that I can not do this test. My trial version of XE2 has also expired.

I suspect that C++ does not can handle anonymous methods from Delphi. Please turn off the use of anonymous methods in the file gmConfig.inc

markieren

Delphi-Quellcode:

			{.$DEFINE USE_ANONYMOUS_METHODS}

//...

and remove all sections from demos, where anonymous methods were used.

**Thom**

Auf Grund einer Anfrage bezüglich drehbarer Marker habe ich zu diesem Thema einmal eine kleine Demo erstellt.

Prinzipiell bieten sich dafür vier Wege an:

Drehung per CSS mit Hilfe von Filtern.
Dazu ist der Zugriff auf das IMG- bzw. DIV-Element notwendig, der jedoch vom (JavaScript-) Marker-Objekt nicht unterstützt wird. Die Ermittlung des Bild-Containers ist über Umwege zwar möglich, aber umständlich und es ist nicht sicher, ob derartige "Hacks" auch mit zukünftigen API-Versionen kompatibel sind.
Drehung mit dem Canvas-Element von HTML 5.
Auch hier existieren die selben Probleme wie bei der ersten Lösung. Ein weiteres Gegenargument ist der Umstand, daß damit automatisch Windows XP (und älter) ausgeschlossen wird, da für diese Betriebssysteme kein HTML 5 fähiger IE angeboten wird.
Erstellung einer entsprechenden Anzahl gedrehter Icons (zum Beispiel mit einem Bildbearbeitungsprogramm) und Zuweisung des gewünschten Bildes zum Marker.
Auch diese Methode hat einen gravierenden Nachteil: Das schlechte Speichermanagement des IE's, auf das man leider keinen Einfluß hat. Dadurch wächst der Speicherverbrauch schnell um zahlreiche Megabyte.
Drehung des Bildes mit Delphi und Übergabe an das Marker-Objekt.
Dieser Weg bietet die meisten Vorteile, da er die größtmögliche Kontrolle über den Vorgang zuläßt. Das beginnt mit der Optimierung der Bildrotation (Schnelligkeit, Qualität des Antialiasing), geht über die Kontrolle des Speicherverbrauch (direkte Freigabe nicht mehr benötigter Objekte, kein Warten auf eine Garbage Collection und kein Cache, auf den man keinen Einfluß hat - wer kennt das nicht: Man hat 10 Seiten geöffnet und der Taskmanager bescheinigt dem IE einen Speicherverbrauch von einem GByte).

Als Marker-Icon wird ein Png-Bild mit Transparenz verwendet. Deshalb setzt die Demo die Unit PNGImage voraus. Ab Delphi 2009 ist diese Bestandteil der Bibliothek, bei älteren Versionen muß sie nachträglich installiert werden. Zu finden ist sie zum Beispiel

hier.
Desweiteren muß in diesem Fall die Verwendung von Png-Bildern in der Datei gmConfig.inc per Compilerschalter aktiviert werden, um die entsprechenden Funktionen im Framework nutzbar zu machen:

markieren

Delphi-Quellcode:

			{$DEFINE USE_PNGIMG} //<- Punkt nach '{' entfernen

//...

Dadurch, daß die Bezeichnung von TPNGObject in TPNGImage geändert wurde, sind auch die dfm-Dateien nicht kompatibel. In älteren Delphi-Versionen müssen deshalb die Picture-Eigenschaften der Image-Komponenten neu geladen werden. Ansonsten wurde die Demo mit Delphi 5 und XE getestet und sollte auch mit anderen Delphi-Versionen funktionieren.

Gedreht wird das Bild mit Hilfe von SmoothRotate - einer Prozedur von Gustavo Daud, dessen Beispiele leider nur noch sehr schwer zu finden sind. Nach langer Suche wurde ich auf

CodeCentral von Embarcadero fündig, wo unter PNGDelph Method Shop Code Samples auch einige Demos von Gustavo enthalten sind. Leider liegen die Dateien dort nur im txt-Format vor und enthalten einige Bugs. Deshalb wurden die benötigten Methoden von mir in eine Unit gepackt, ein Speicherleck beseitigt und um die Möglichkeit, beim gedrehten Bild die Größe des Originalbildes beizubehalten, erweitert.
Nach der Drehung wird das Bild Base64 kodiert und an den Marker übergeben.

Der gesamte Vorgang (Drehung, Antialiasing, Kodierung, Übergabe und Anzeige im Browser) geschieht in Echtzeit und führt auch auf einem Netbook zu keinem Ruckeln oder Flackern.

Das Ergebnis sieht dann so aus:

**movnet**

Hi Thom.
How can I get gmOverlaysMarker.pas?
Thank you.

**Thom**

Hi Oleg,

the unit gmOverlaysMarker.pas is located in the folder GoogleMaps\Source\API (Framework version 2.x).

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

Google Maps über COM (Component Object Model)

Forumregeln

LinkBack to this Thread

beeglext Delphi 7 Enterprise	#162 27. Dez 2011, 06:13 error inslal TWebBrowser Delphi7 http://s47.radikal.ru/i116/1112/bc/2b5714883b81.jpg help please Дмитрий(Dmitriy)
	Zitat

Thom Delphi XE3 Professional	#163 27. Dez 2011, 20:25 Hi Azrin, thank you very much! Unfortunately I have only Delphi and not RAD Studio, so I could test it yet. If there are problems again, please tell about it! Hi Дмитрий, Delphi 7 has a integrated TWebBrowser component (dclie70.bpl). You do not need a additional component. Thomas Nitzschke Geändert von Thom (27. Dez 2011 um 23:23 Uhr)
	Zitat

beeglext Delphi 7 Enterprise	#164 27. Dez 2011, 23:22 Thom, спасибо (thank you) Дмитрий(Dmitriy)
	Zitat

movnet	#169 5. Jan 2012, 22:38 Hi Thom. How can I get gmOverlaysMarker.pas? Thank you.
	Zitat

Thom Delphi XE3 Professional	#170 5. Jan 2012, 22:52 Hi Oleg, the unit gmOverlaysMarker.pas is located in the folder GoogleMaps\Source\API (Framework version 2.x). Thomas Nitzschke
	Zitat