Google-Map

Hilfe für das Google-Map Modul

Hier finden sie eine kleine Hilfe für die Benutzung des Google-Map Moduls und die Erläuterungen für die verschiedenen Felder innerhalb des Moduls.

Die Hilfe untergliedert sich in die 5 Bereiche Einstellung im Administrator-Bereich, Marker und Wege editieren, Einstellungen im Template, Marker installieren und das changelog.

Einstellung im Administrator-Bereich

Als erstes geben Sie unter "Ihr GoogleMap API-Key (v2)" Ihren GoogleMap API-Key ein.

Falls Sie für Ihre Domain keinen haben, können Sie diesen bei Google (hier) generieren.

Hinweis:
Falls Sie Ihre Webseiten auf einem lokalen Server testen bevor Sie diese ins Internet stellen, bedenken Sie bitte, dass Sie für die Internet-Damain einen anderen Key benötigen als für die lokale. Ein Script, welche alle API-Keys auf einmal austauschen kann, ist derzeit noch in der Entwicklung.

Im Abschnitt "Karteneigenschaften" können Sie das grundsätzliche Verhalten Ihrer Google-Map einstellen.

Marker und Wege editieren

Im Abschnitt "Marker" können Sie die einzelnen Marker, deren Erscheinungsbild und Verhalten festlegen.

Wenn Sie auf "Marker editieren" klicken, öffnet sich ein neues Fenster.

 

In dieser Tabelle können Sie jede Zelle einzeln bearbeiten. Beachten Sie bitte, dass wenn sich das "Bearbeitungs-Popup" öffnet, die derzeit eingetragenen Inhalte nicht übergeben werden.

Die Bedeutung der einzelnen Spalten:

• [Folge] legt die Reihenfolge fest, in der die Marker geladen werden sollen. Falls Sie hier etwas ändern wollen, beachten Sie bitte, dass keine Zahl doppelt vorkommen darf.
• [Lat] legt den Breitengrad des Markers (Dezimalschreibweise) fest.
• [Long] legt den Längengrad des Markers (Dezimalschreibweise) fest.
  Hinweis: Beim Auffinden der Marker-Koordinaten könnte diese Seite hilfreich sein: Link.
• [Farbe] Dieses Feld ist derzeit außer Funktion.
• [Typ] Hier öffnet sich sich ein Auswahlmenü, in welchem Sie das Aussehen des Markers festlegen können.
  Hinweis: Beachten Sie bitte, dass die einzelnen Markertypen erst im System installiert werden müssen. Näheres erfahren Sie hier. Die bereits im System installierten Markertypen können Sie hier (Link entfernt) einsehen.
• [Fenster] Wenn Sie ein Popup-Fenser für den Marker definieren wollen, fügen Sie hier bitte den gewünschten HTML-Quelltext ein.
  Für Popups mit mehreren Reiterkarten trennen Sie die Karten bitte mit "##//##" und die Reiterüberschriften mit "#/#" vom Karteninhalt.
• [Fensterverhalten] Hier können Sie zwischen "statisch" (0), "popup" (1) und "Routenplaner-Popup" (2) auswählen.
  "popup" bedeutet, dass ein Mausklick auf den betreffenden Marker das Info-Fenster öffnet, welches Sie unter "[Fenster]" angelegt haben.
  "statisch" bedeutet, dass sich hier entweder kein Info-Fenster öffnet oder dieses sofort mit dem Laden der Map angezeigt wird. (Beachten Sie, dass letzteres nur funktioniert, wenn dieser Marker als letzter geladen wird. - siehe "[Folge]")
  Bei "Routenplaner-Popup" fügt das System die notwendigen Inhalte für das Popup-Fenster und den Routenplaner von Google automatisch in die Datenbank ein.

Im Abschnitt "Wegelinien" können Sie mehrere Wegelinien anlegen und deren Erscheinungsbild festlegen.

Im oberen Bereich können sie für alle Wegelinien gemeinsame Eichenschaften festlegen. Dieses sind im einzelnen

• die Linienstärke (in Pixel) und
• die Deckkraft (in Prozent).

Wenn Sie auf "Wege editieren" klicken, öffnet sich ein neues Fenster.

 

In dieser Tabelle können Sie jede Zelle einzeln bearbeiten. Beachten Sie bitte, dass wenn sich das "Bearbeitungs-Popup" öffnet, die derzeit eingetragenen Inhalte nicht übergeben werden.

Die Bedeutung der einzelnen Spalten:

• [Folge] legt die Reihenfolge der einzelnen Wegepunkte fest. Falls Sie hier etwas ändern wollen, beachten Sie bitte, dass keine Zahl doppelt vorkommen darf.
• [Latitude] legt den Breitengrad des Wegepunktes (Dezimalschreibweise) fest.
• [Longitude] legt den Längengrad des Wegepunktes (Dezimalschreibweise) fest.
  Hinweis: Beim Auffinden der Wegepunkt-Koordinaten könnte diese Seite hilfreich sein: Link.
• [Route-Nr.] Wenn sie mehrere Wegelinien in einer Karte darstellen wollen, können Sie den einzelnen Wegen hier eine Nummer zuweisen.
• [Farbe] Dieses Feld legt die Farbe Ihrer Wegelinie fest. - Beachten Sie bitte, dass Sie allen Wegepunkten einer Wegelinie die gleiche Farbe zuweisen.

Einstellungen im Template

Um das Google-Map Modul in Ihr Template einzubinden, müssen an einigen Stellen des Templates Veränderungen vorgenommen werden, die nicht über die normale Datei view.php möglich sind.
Daher sind einige händische Eingriffe in Ihr Template notwendig:

1. Nachladen der Template-Erweiterungen des Google-Map Moduls:
   Fügen Sie zu Beginn Ihres Templates die Zeile "<?php include(WB_PATH.'/modules/gmap/functions.php'); ?>" ein.
2. Festlegen des DOCTYPEs auf strictXHTML und VML:
   
   1. Wenn Sie standartmäßig kein DOCTYPE festlegen:
      Fügen Sie vor dem öffnen des HTML-Headers die Zeile "<?php gmap_doctype(); ?>" ein.
   2. Wenn Sie normalerweise einen DOCTYPE verwenden, wird es etwas komplizierter:
      Ersetzen Sie dann Ihren DOCTYPE mit:
      "<?php if(SHOW_GOOGLEMAP) {
   gmap_doctype();
} else { ?>
   [... Ihr DOCTYPE ...]
<?php } ?>"
3. Initialisieren der Google-Map:
   Bevor Sie den HTML-Header mit </HEAD> schließen, fügen Sie die Zeile "<?php gmap_setup(); ?>" ein.
4. Body-Tag Funktionen:
   
   1. Wenn Sie keine Java-Script-Funktionen im Bodytag laden, fügen Sie einfach
      "<?php gmap_bodytag(''); ?>" in Ihren Body-Tag ein. Er sieht dann z.B. so aus: "<BODY topmargin="0" leftmargin="0" rightmargin="0" <?php gmap_bodytag(''); ?>>".
   2. Wenn Sie Java-Script Funktionen im Bodytag laden, müssen Sie die onload- und onunload-Funktionen einzeln einfügen. Ihr Bodytag sieht dann beispielsweise so aus:
      "<body onload="function_x()<?php gmap_bodytag('onload'); ?>" onunload="<?php gmap_bodytag('onunload'); ?>">".

Marker installieren

In der Standartinstallation bringt das Google-Map Modul 284 von Google zur Verfügung gestellte Marker mit.

Sie haben die Möglichkeit eigene Marker zu erstellen und in das System zu integrieren. Nutzen Sie hierfür dieses Formular (Link entfernt).
Die individuell hinzugefügten Marker werden im Pfad 'WB_PATH/media/gmap-markers' gespeichert. Sie finde diese folglich auch unter 'Medien' (Link entfernt). Benennen Sie die Marker jedoch nicht um, weil das Modul die betreffenden Datenbankeinträge dann nicht mehr zuordnen kann.
Die in ihrem System installierten Marker können Sie hier (Link entfernt) einsehen.

Mit der zweiten Reiterkarte desselben Formulars können Sie vorhandene Marker löschen.
Klicken Sie einfach auf und die Marker werden aus Datenbank und Pfad gelöscht.

Es gibt unzählige fertige IconSets für Google-Maps. Einige finden Sie hier.

Changelog

• Version 0.14 (09-27-2006) by AFBelow
  • Added: Functions to install and delete own marker
  • Updated: Helpfile for the new functions
• Version 0.13 (09-26-2006) by AFBelow
  • Added: Google-Map Routefinder integrated
• Version 0.12 (09-23-2006) by ruebenwurzel
  • fixed: a bug in add.php
• Version 0.11 (09-23-2006) by ruebenwurzel
  • modified: modify.php
  • fixed: Helpfile
• Version 0.10 (09-23-2006) by ruebenwurzel
  • added: complete htmlcode to marker.php, routes.php and show_icons.php
  • fixed: problem with double quotes in show_icons.php
• Version 0.9 (09-22-2006) by AFBelow
  • fixed: some bugs related to XP/XAMPP-servers
• Version 0.8 (09-22-2006) by ruebenwurzel
  • changed: some double and single quotes to get cleaner output code
  • deleted some not necessary database connects in a few files
  • fixed: some bugs related to windows-server (error messages with "headers already sent by ...")
  • stored all files unix konform
• Version 0.7 (09-20-2006) by AFBelow
  • Added: External language file
  • Added: Helpfile.

ToDo's und Bugs

• Möglichkeit eröffnen, mehr als eine Google-Map pro Seite zu erstellen.
• Mehrsprachigkeit vollständig integrieren.
• AJAX-Grids für Marker- und Routen-Tabellen austauschen.
• In Javascript erstellten Layouts die Kartenmitte zentrieren.
• Löschen von Markern und Wegepunkten aus einer Map.