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

**BBoy**

ok, dann schaue ich mal nach einer günstigeren oder kostenlosen karte.

Aber wegen Text auf der Map darstellen weis ich nicht wie mir das Events demo weiterhelfen soll.
Wie gesagt, am besten wäre es wenn die markernamen nicht nur angezeigt werden wenn man mit den Mauszeiger darüber geht sondern wenn er immer angezeigt wird. Oder eben wenn man wenigstens ein Textelement an die Marker platzieren könnte.

**Thom**

Dann ist es am günstigsten, jeden Marker mit einem DIV-Element zu versehen, damit die Markierung samt Karte verschoben werden kann.

**BBoy**

Ist es nicht einfach möglich ein label element an der marker position mit deiner api zu erstellen?

Und wie kann man z.B. Openstreetmap anstatt Google maps nutzen?

**BBoy**

Wie kann ich denn eigentlich erstellte Marker oder PolyObjekte wieder löschen von der Karte?

**Thom**

Zitat von BBoy:

Ist es nicht einfach möglich ein label element an der marker position mit deiner api zu erstellen?

Jain. Erst einmal eine kurze Erklärung zum Veständins: "Mein" API ist kein eigenständiges API, sondern lediglich ein Wrapper für das Google Maps API. Grundsätzlich kann es also weder mehr noch weniger als das JavaScript-API von Google. "Grundlegend" deshalb, weil einerseits aus Zeitgründen noch nicht alle Funktionen und Objekte des JavaScript-API's umgesetzt wurden (das betrifft vor allen Dingen den Teil von Street View), ich aber andererseits etliche Delphi-"Komfortfunktionen" hinzugefügt habe.

Zusätzliche Beschriftungen werden vom Google Maps API nicht explizit unterstützt. JavaScript-Programmierer nutzen für Labels meistens DIV-Container, die im Browser hinzugefügt und - bei Bedarf - mit Markern verknüpft werden. Ein Beispiel dazu habe ich in diesem

Blog gefunden. Dadurch werden diese bei der Verschiebung der Karte mehr oder weniger verzögerungsfrei mitgeführt. Das ist aber ein konzeptionelles Problem, welches leider auch der Delphi-Wrapper nicht beseitigen kann.

Die gute Nachricht ist, daß die benötigten DIV-Container vom Framework angelegt werden können:

zusammenfalten · markieren

Delphi-Quellcode:

			//...

var

  Container: TDivNode;

begin

  Container:=Script.Document.CreateDivNode;

  with Container.Style do

  begin

    Position:='absolute';

    Bottom:='50px';

    Left:='10px';

    Height:='10px';

    WhiteSpace:='nowrap';

    FontSize:='10px';

    FontFamily:='Arial, sans serif';

    //...

  end;

  //...

end;

Zitat von BBoy:

Und wie kann man z.B. Openstreetmap anstatt Google maps nutzen?

Eine Verständnisfrage: Meinst Du die Anzeige von Karten aus dem OSM-Projekt im Google Maps Player oder die Darstellung dieser Karten völlig ohne Google Maps API - also zum Beispiel im OpenLayers Player?
Es funktioniert nämlich beides: Der Google Player ist in der Lage, (nahezu) beliebige Karten darstellen. Dazu kann das Objekt

ImageMapType verwendet werden.
Für die Nutzung von OpenLayers muß dessen API in Delphi Wrapper umgesetzt werden. Das ist technisch machbar - darüber wurde schon in früheren

Beiträgen diskutiert. Ein erster Test verlief recht gut.

Zitat von BBoy:

Wie kann ich denn eigentlich erstellte Marker oder PolyObjekte wieder löschen von der Karte?

Einfach der Map-Eigenschaft den Wert nil zuweisen:

markieren

Delphi-Quellcode:

			  Marker.Map:=nil; 

  Polygon.Map:=nil;

Damit werden diese Objekte von der Karte entfernt. Die zugehörigen JavaScript-Objekte werden dann vom Browser selbst irgendwann freigegeben und die Delphi-Wrapper-Objekte durch den Programmcode oder bei Beendigung der Anwendung.

**BBoy**

Danke für die ausführliche Antwort.
Die Sache mit dem löschen funktioniert 1a

Ich würde eigentlich gerne die onlinemap von Openstreetmap nutzen. Ist das aufwendig zu realisieren? Oder wäre es einfacher die offlinemap zu verwenden?

Und als Label auf der Karte meinte ich eher einfach Text darstellen, egal wie. Möchte einfach nur die Marker nummerieren. Weis aber nicht wie

**Thom**

Jetzt hast Du leider immer noch nicht geschrieben, welchen Player Du zur Darstellung der OSM-Karten verwenden willst: Google Maps (damit meine ich nicht die Karten selbst, sondern das Ding, das die Karten anzeigt und für das der Wrapper geschrieben wurde) oder OpenLayers.

Das geht - wie schon geschrieben - mit beidem, ist aber ein Unterschied bei der Programmierung:

Mit Google Maps und dem Framework ist es jetzt schon möglich, (fertig gerenderte) Karten aus dem OSM-Projekt anzuzeigen. Da bedeutet aber trotzdem bei kommerziellen Projekten Lizenzkosten an Google, da ja desses API zur Anwendung kommt - auch wenn es fremde Karten sind. Das würde ich zumindest vermuten - ich bin aber kein Rechtsanwalt. Eine Anfrage bei Google würde da Klarheit bringen.
Die Wrapper für OpenLayers existieren nur im Ansatz - es würde deshalb eine ganze Weile dauern, dessen API in Delphi nachzubilden. Diese Variante hätte allerdings den Vorteil, ohne Lizenzkosten auszukommen - außer eventuell einer Spende an das OSM-Projekt...

Zur Frage online/offline:
Es kommt darauf an, ob Du nur einen Bereich oder die komplette Karte offline verwenden willst. Davon hängt nämlich die Kapazität Deiner Festplatte ab: In Zoomstufe 15 besteht eine Karte zum Beispiel aus (2^15*256)^2=70.368.744.177.664 Pixeln und ist damit ein Terrapixel-Bild

Eine andere Möglichkeit besteht darin, nur die geometrischen Kartendaten lokal zu speichern und daraus selbst eine Karte zu rendern. Dafür gibt's fertige Lösungen - zum Beispiel

Maperitive.

Insofern ist natürlich eine Onlinevariante, die sich einfach die fertigen Kartenteile von den entsprechenden Servern holt, leichter zu realisieren.

Für Marker können auch eigene Bilder verwendet werden und damit auch solche, die zum Beispiel einen Buchstaben oder eine Zahl enthalten. Dafür empfehle ich den Artikel Delphi und Google Maps (Teil 3) in der

Toolbox 3/2011, in dem es genau um dieses Thema geht.

**BBoy**

Wegen dem Player verstehe ich nicht wirklich was du meinst. Ich nutze einfach deine Api, denke das es dann der google Player ist oder?
Genau genommen geht es mir immer nur um einen kleinen Kartenausschnitt den ich benötige. Vielleicht eine Kleinstadt groß. Aber ich benötige halt immer wieder andere Kartenteile von anderen Orten. Das ganze benötige ich auch nur weil google maps leider nicht kleine wege anzeigt, die mir aber wichtig sind.
Die Garmin Topo 2010 Karten habe ich mir mal gekauft da diese echt die besten sind. da ist jeder kleine Weg drauf und ist voll routingfähig. Da sind lauter .img dateien dabei und eine basemap. Kann man das irgendwie verwenden?
Hast du da ein Idee ob und wie in etwas man so was realisieren könnte?

Wegen den Markern, ich verwende schon eigene Marker die ich mit Google.Maps.MarkerImage einbinde. Diese sollen jedoch dynamisch nummeriert werden. Ich bringe die in eine Reihenfolge und in dieser sollen die dann per buttonklick nummeriert (oder sonst wie benannt) werden. Da es sich auch um mehere verschiedene Marker handelt ist eine feste Nummerierung keine option.
Was gibt es da noch für Möglichkeiten?

**Thom**

Zitat von BBoy:

Wegen dem Player verstehe ich nicht wirklich was du meinst. Ich nutze einfach deine Api, denke das es dann der google Player ist oder?

Ja. Jetzt habe ich das verstanden.

Zur Erklärung: Die Karten sind die eine Seite - die andere das Programm, das die Karten anzeigt. Ich nenne diese einfach allgemein "Player" - in Analogie zu Multimediaplayern wie zum Beispiel Windows Media Player oder DivX Player. Ob es dafür bei Geo-Daten eine einheitliche Bezeichnung gibt, weiß ich nicht. Ich lasse mich da aber gern belehren...
Für

Google Maps gibt es offiziell das JavaScript-API (zu dem ich den Wrapper geschrieben habe), das dazu dient, die Karten von Google innerhalb eines Browsers darzustellen und das API für Flash.
Insofern sind die Begriffe API und Player Synonyme für die selbe Sache.

Zitat von BBoy:

Genau genommen geht es mir immer nur um einen kleinen Kartenausschnitt den ich benötige. Vielleicht eine Kleinstadt groß. Aber ich benötige halt immer wieder andere Kartenteile von anderen Orten. Das ganze benötige ich auch nur weil google maps leider nicht kleine wege anzeigt, die mir aber wichtig sind.
Die Garmin Topo 2010 Karten habe ich mir mal gekauft da diese echt die besten sind. da ist jeder kleine Weg drauf und ist voll routingfähig. Da sind lauter .img dateien dabei und eine basemap. Kann man das irgendwie verwenden?

Die Garmin Karten würde ich aus lizenzrechtlichen Gründen nicht verwenden (hatte ich schon einmal geschrieben).
Allerdings besitzen OSM-Karten teilweise eine bessere Qualität (Genauigkeit, Details) als Google-Karten. Das müßtest Du mal für den Bereich, der Dich interessiert, visuell überprüfen.

Zitat von BBoy:

Hast du da ein Idee ob und wie in etwas man so was realisieren könnte?

Die Anzeige von OSM-Karten mit dem Google Maps API funktioniert. Im Anhang befindet sich eine Demo, die eigentlich nicht zur Veröffentlichung bestimmt war (deshalb auch nur als compilierte EXE) und mir dazu diente, einige Designstudien vorzunehmen. Aber sie zeigt auch, daß die Verwendung von OSM-Karten kein Problem ist.

Zitat von BBoy:

Wegen den Markern, ich verwende schon eigene Marker die ich mit Google.Maps.MarkerImage einbinde. Diese sollen jedoch dynamisch nummeriert werden. Ich bringe die in eine Reihenfolge und in dieser sollen die dann per buttonklick nummeriert (oder sonst wie benannt) werden. Da es sich auch um mehere verschiedene Marker handelt ist eine feste Nummerierung keine option.
Was gibt es da noch für Möglichkeiten?

Ja - Toolbox lesen und zugehörige Beispiele ansehen.

**BBoy**

Danke für die ausführliche Antwort.
Werde mir die Demos der Toolbox mal ansehen, kaufen werde ich mir die Zeitung aber deswegen nicht

Habe mir die angehängte exe mal angesehen. Diese "Mapnik" Map wäre für mich schon ok (zumindest besser als die google map). Wenn ich jetzt noch wüsste wie ich die in mein Programm bekomme mit deiner Api wäre ich glücklich

Hast du da eine Idee??

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

Thom Delphi XE3 Professional	#72 3. Jun 2011, 23:52 Dann ist es am günstigsten, jeden Marker mit einem DIV-Element zu versehen, damit die Markierung samt Karte verschoben werden kann. Thomas Nitzschke
	Zitat

BBoy Delphi 10 Seattle Professional	#73 4. Jun 2011, 15:50 Ist es nicht einfach möglich ein label element an der marker position mit deiner api zu erstellen? Und wie kann man z.B. Openstreetmap anstatt Google maps nutzen? Geändert von BBoy ( 4. Jun 2011 um 15:56 Uhr)
	Zitat

BBoy Delphi 10 Seattle Professional	#74 5. Jun 2011, 20:08 Wie kann ich denn eigentlich erstellte Marker oder PolyObjekte wieder löschen von der Karte?
	Zitat