1. Besorgen Sie sich einen Google Maps API-Schlüssel

Bei jeder Nutzung der Google Maps APIs müssen Sie, falls Ihre Domain nach dem 22. Juni 2016 erstellt wurde, einen API-Schlüssel zur Validierung Ihrer Anfrage angeben.
Hier erhalten Sie einen API-Schlüssel und aktivieren die API: https://developers.google.com/maps/documentation/javascript/get-api-key

Weitere Informationen: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Der erste Schritt besteht darin, ein Projekt anzulegen und anschließend den Namen des Projekts einzugeben.

Wenn ich alle Anfragen von meiner Domain zulassen möchte, lautet das Muster *.joomunited.com/*.
Wenn ich nur eine einzelne Domain, z. B. meinedomain.com, zulassen möchte, lautet das Muster joomunited.com/*.

In einer localhost-Umgebung können Sie jeden gültigen Schlüssel verwenden, und er funktioniert auch ohne Angabe einer Domain.

Anschließend wird der API-Schlüssel generiert. Diesen Schlüssel müssen Sie kopieren, um ihn zu My Maps locationhinzuzufügen.

Füge den Schlüssel zu My Maps Locationhinzu.

Unter Komponenten > My Maps Location > Optionen können Sie einen Schlüssel in der Konfiguration hinzufügen.

Fügen Sie den Schlüssel ein.

Schritt-für-Schritt-Lebenslauf:

Die Schritte, die ich befolge, sind also folgende:

• Gehen Sie zur Google API Console
• Erstellen oder auswählen eines Projekts
• Klicken Sie auf „ Weiter“ , um die API und alle zugehörigen Dienste zu aktivieren.
• Auf der Seite „Anmeldeinformationen“ können Sie einen Browserschlüssel (und die API-Anmeldeinformationen festlegen).
• Um Quotendiebstahl zu verhindern, sichern Sie Ihren API-Schlüssel gemäß den folgenden Best Practices.

2. Standortkategorien verwalten

Standorte werden in Kategorien eingeteilt. Diese Kategorien können im Frontend als Filter angezeigt oder als vordefinierter Parameter in einem Menüpunkt verwendet werden, um kategorisierte Standorte zu laden.
 

Wenn Sie viele Standorte haben, empfiehlt es sich, Kategorien zu verwenden. Sie können Kategorien und Unterkategorien erstellen.
Um eine Kategorie zu erstellen, gehen Sie in My Maps location > „Kategorie“ und klicken Sie auf „Neu“.

Anschließend müssen Sie im Kategoriebildschirm einen Titel und eine übergeordnete Kategorie hinzufügen, falls Sie eine Unterkategorie erstellen möchten

Sie können auch einen Standardmarker für den Standort in der Kategorie mithilfe der Registerkarte „ Markerauswahl“

3. Einen Standort erstellen

Um einen Standort zu erstellen, gehen Sie bitte in My Maps location > Standorte > Standorte > Neu

Es gibt 3 Pflichtfelder:

• Name des Ortes
• Kategorie des Standorts
• Standortdetails (Adresse)      

Für die Adresse gibt es 3 Lösungen zum Hinzufügen:

• Nutzen Sie das Suchfeld (empfohlen)
• Navigieren Sie auf die Karte und verwenden Sie den Cursor, um einen Ort auszuwählen
• Geben Sie eine Adresse ein (muss für Google Maps gültig sein)

Um einen Ort zur Suchmaschine hinzuzufügen, geben Sie den Namen des Ortes ein, den Sie hinzufügen möchten.

Bei Auswahl werden die Felder für Längen- und Breitengrad automatisch ausgefüllt. Meine Karten sind außerdem mit Google Places integriert! Das bedeutet, Sie können nach einem Geschäft oder einem anderen Ort suchen, der bei Google Maps registriert ist – unsere Komponente ruft alle relevanten Informationen ab.

Sie können auch auf der Karte navigieren und direkt eine Markierung setzen; das Ergebnis ist dasselbe, und Sie erhalten automatisch einen Breitengrad und einen Längengrad.

Seien Sie vorsichtig mit dem Adressfeld und der Postleitzahl, wenn Sie diese manuell ausfüllen; sie müssen mit einer in Google Maps gespeicherten Adresse übereinstimmen.

Alle weiteren Informationen zum Standort (Beschreibung, Öffnungszeiten usw.) werden in der Detailansicht des Standorts angezeigt.

Der Kontaktlink in der Standortdetailbearbeitung ermöglicht das Hinzufügen eines Kontaktlinks, einer Mailto-Adresse oder einer URL pro Standort. Im Frontend wird ein Kontaktbutton angezeigt, der die URL öffnet oder die Mailto-Aktion ausführt.

4. Weitere Standortinformationen

An jedem Standort können Sie ein Bild und eine Markierung hinzufügen. 

• Standortbild: Das Bild wird als Miniaturansicht im Tooltip des Standorts und in größerer Auflösung auf der Standortdetailseite angezeigt.
• Kategoriesymbol verwenden: Verwenden Sie das Symbol, das Sie im Kategoriefeld meiner Kartenstandorte eingefügt haben.
• Marker-Hintergrund: Wählen Sie die Farbe für Ihren Hintergrundmarker.
• Die Markierung wird auf der Karte als Standortmarkierungssymbol angezeigt. Die My Maps Location .
• Mit der Option „Benutzerdefinierten Link verwenden“ wird der Link zu den Standortdetails durch eine benutzerdefinierte URL überschrieben.

My Maps location nutzt die integrierte Mehrsprachigkeitsfunktion von Joomla. Sie können eine Sprache sowohl für Standortkategorien als auch für Standorte festlegen. Beim Sprachwechsel werden Standorte wie alle anderen Joomla-Inhalte gefiltert, um die in der jeweiligen Sprache freigegebenen Inhalte anzuzeigen.

Das Feld für die Ortsbeschreibung ist besonders wichtig.
Es wird auf der Detailseite des Ortes angezeigt und, je nach Theme, als Einleitungstext in den Suchergebnissen. Besonders hervorzuheben ist, dass es sich um einen WYSIWYG-Editor handelt, in den alle Plugins integriert sind. Das bedeutet, Sie können hier beliebige Inhalte einfügen (Bilder, Videos usw.).

Hier ist der Einleitungstext, der in den Suchergebnissen für Standorte angezeigt wird.

Das Tag-Feld verwendet dasselbe Tag-System wie Joomla. Sie können Tags und Untertags hinzufügen und diese anschließend im Frontend als Filter laden. Um alle Tags zu verwalten, laden Sie einfach die Joomla-Tag-Komponente: Menükomponente > Tags.
Im Frontend können Tags je nach Konfiguration als Kontrollkästchen (wie unten) oder als Dropdown-Liste angezeigt werden.

My Maps Location wurden um zusätzliche Felder zur Erfassung von Metadaten (für Suchmaschinen) erweitert. Diese Felder werden auf der Standortdetailseite geladen.

5. Standorte im Frontend anzeigen

Um Ihre Standorte im Frontend anzuzeigen, können Sie Folgendes verwenden:

• Ein Menü zur Anzeige der Standortsuchmaschine, einzelner Standorte oder Standortkategorien
• Ein Modul zur Anzeige eines Suchfelds oder zur Auswahl einer Gruppe von Standorten
• Eine Schaltfläche zum Bearbeiten, um einzelne oder mehrere Positionen in einem beliebigen Editor anzuzeigen

Standorte aus einem Menü laden

Fügen Sie im Joomla-Menümanager ein Element hinzu und wählen Sie als Typ „Standortsuche und -anzeige“. Daraufhin wird die Standortsuchmaschine mit Filtern angezeigt.
Wählen Sie „Standortdetailansicht“, um einen einzelnen vordefinierten Standort anzuzeigen.

Über den Hauptmenüpunkt können Sie Folgendes einstellen:

• Adresse eingeben: Sie können festlegen, dass beim Laden der Seite eine Standardadresse angezeigt wird. Dieses Feld kann leer bleiben.
• Entfernung: Die Entfernung, um die Sperre zu suchen, bezogen auf die oben genannte Adresse. Kann auf -1 (Standardwert) belassen werden.
• Kategorie: Eine bestimmte Kategorie von Standorten laden
• Suchlimit: Begrenzen Sie die Anzahl der Suchergebnisse. Mit dem Wert 10 werden bei der Ortssuche nur die ersten 10 Ergebnisse angezeigt.
• Sortierung: Suchergebnisse sortieren nach Datum, Titel, Entfernung (Standard)

können Sie auf der Registerkarte My Maps Location

• Komponente auswählen: My Maps Location oder alle Drittanbieterintegrationen wie K2, Jomsocial ...
• Standardkategorie-ID (Drittanbieter-Erweiterungen): Standardkategorie, die geladen wird, wenn eine Drittanbieter-Erweiterung wie K2, Hikashop oder Adsmanager verwendet wird; CB-Listen-ID für Community Builder.
• Standorte von Unterkategorien: Es sollen auch Standorte aus Unterkategorien als Suchergebnisse angezeigt werden, nicht nur die oben ausgewählte Kategorie.
• Design: Wählen Sie eines der drei verfügbaren Designs für die Such- und Ergebnisdarstellung für den Menüpunkt aus: Standard, Vollbild oder Seitenleiste.
• Kartenanbieter: Wählen Sie Google Maps, Bing Maps, Mapbox, OpenStreetMap, Baidu oder Mapquest, um Ihre Karten zu gestalten.
• Suchtags aktivieren : Ermöglicht Suchanfragen mithilfe von Orts-Tag-Namen.
• Designs: Je nach Kartenquelle stehen Ihnen verschiedene Kartentypen und Farben zur Verfügung.
• Kartenebene: Fügen Sie Ihren Karten Daten (Ebenen) hinzu. Es gibt KML-Ebenen, Verkehrsebenen, ÖPNV-Ebenen und Fahrradebenen.
• Google Maps-Layer-URL: Verwenden Sie den Daten-Layer, um Ihre benutzerdefinierten Daten zu speichern oder GeoJSON-Daten auf einer Google-Karte anzuzeigen.
• Bing Maps-Typ: Wenn Bing Maps Ihr Kartenanbieter ist, wählen Sie das Erscheinungsbild und die Daten von Bing Maps aus.
• OpenStreetMap-Typ: Wenn OpenStreetMap Ihr ​​Kartenanbieter ist, können Sie Ihren Karten Daten (Ebenen) hinzufügen.
• Standort-Tooltip: Beim Laden der Karte wird nach der Standortsuche automatisch ein Standort-Tooltip geöffnet.
• Kartenzoom: Definieren Sie eine Standardzoomstufe für die Karte
• Optionen für Breite und Höhe der Karte und der Suchergebnisse

Frontend-Anzeige basierend auf dem Thema

Ergebnis der Suche nach einem einzelnen Standort:

Standorte mithilfe eines Moduls anzeigen

My maps location enthält 2 Module für native Standorte + ein weiteres Modul für die Integration von Drittanbietern (z. B. ein Modul zur Anzeige von K2-Artikelstandorten)

Das Kartenmodul ermöglicht es Ihnen, Ihre Standorte mit denselben Filtern wie im Menü, jedoch an einer separaten Position, anzuzeigen. Die Standorte werden als Karte oder Liste dargestellt. Sie können mehrere Standorte oder Standortkategorien auswählen.

Das Modul „Standortkarte – Suche“ My Maps Location zeigt eine Suchmaschine mit einigen Filteroptionen an, wie z. B. die Kartenbreite oder die Komponente, in der der Standort gesucht werden soll (z. B. nur nach dem Standort K2 suchen).

Anzeigemodul im Frontend:

Standorte mithilfe einer Editor-Schaltfläche anzeigen

Die Schaltfläche „Editor“ wird in Ihrem Joomla-Editor geladen (üblicherweise in Artikeln oder benutzerdefinierten HTML-Modulen). Sie finden die Schaltfläche am unteren Rand des Editors.
Nach dem Klicken öffnet sich ein Fenster, in dem Sie einen oder mehrere zuvor hinzugefügte Speicherorte auswählen können.

Anschließend können Sie einen oder mehrere Orte auswählen und per Klick auf die Schaltfläche in Ihren Artikel einfügen. Wenn Sie keine Zoomstufe angeben, wird der Ort automatisch an Ihren Standortbereich angepasst.
Der Tag-Code, der in Ihrem WYSIWYG-Editor angezeigt wird, sieht folgendermaßen aus: {mymaplocations mapid width height}

Beispiel: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} Dieser Code zeigt eine Karte mit der Standort-ID 1, einer Breite von 58 %, einer Höhe von 400px, 10-fachem Zoom und dem Kartentyp „Google“ an. Mehrere Standorte können durch Kommas getrennt werden. Beispiel: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} Die Standort-IDs sind 1, 2, 3 usw.