1. Získejte klíč API pro Mapy Google

Pokaždé, když používáte rozhraní API služby Google Maps, pokud byla vaše doména vytvořena po 22. červnu 2016, musíte k ověření požadavku přidat klíč.
Získejte klíč a aktivujte API: https://developers.google.com/maps/documentation/javascript/get-api-key

Více informací: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Prvním krokem je vytvoření projektu a následné zadání názvu projektu.

Pokud chci povolit všechny požadavky z domény mydomain, pak je vzor *.joomunited.com/*.
Pokud chcete povolit pouze jednu doménu, například mydomain.com, pak by vzor byl joomunited.com/*.

V prostředí localhost můžete zadat libovolný platný klíč a bude fungovat bez odkazování na doménu.

Poté se vygeneruje klíč API, který je třeba zkopírovat pro přidání do My Maps location.

Přidejte klíč do My Maps Location.

V Komponenty > My Maps Location > Možnosti můžete do konfigurace přidat klíč.

Vložte klíč.

Životopis krok za krokem:

Takže kroky, které sleduji, jsou

• Přejděte do konzole Google API
• Vytvořit nebo vybrat projekt
• Kliknutím na tlačítko Pokračovat povolíte API a všechny související služby.
• Na stránce Přihlašovací údaje získejte klíč prohlížeče (a nastavte přihlašovací údaje API)
• Abyste zabránili krádeži kvót, zabezpečte si svůj klíč API podle těchto osvědčených postupů.

2. Správa kategorií umístění

Lokality jsou rozděleny do kategorií. Tyto kategorie lze zobrazit jako filtr ve frontendu nebo použít jako předdefinovaný parametr v položce nabídky pro načtení některých kategorizovaných lokalit.
 

Pokud máte mnoho lokalit, doporučuje se používat kategorie. Můžete vytvářet kategorie a podkategorie.
Chcete-li vytvořit kategorii, přejděte do My Maps location > Kategorie a klikněte na Nové.

Pak na obrazovce kategorií budete muset přidat název a nadřazenou kategorii, pokud chcete vytvořit podkategorii

Výchozí značku pro umístění v kategorii můžete také definovat pomocí záložky Výběr značky.

3. Vytvořte umístění

Chcete-li vytvořit místo, přejděte do My Maps location > Místo > Nové

Jsou zde 3 povinná pole:

• Název lokality
• Kategorie lokality
• Podrobnosti o poloze (adresa)      

Pro adresu, kterou máte, máte 3 řešení, jak ji přidat:

• Použijte vyhledávací pole (doporučeno)
• Navigujte na mapě a pomocí kurzoru označte místo
• Vyplňte adresu (musí být platná v Mapách Google)

Chcete-li přidat místo pomocí vyhledávače, zadejte název místa, které chcete přidat.

Po výběru se pole zeměpisné šířky a délky vyplní automaticky. Moje mapy jsou také integrovány s Google Places! To znamená, že můžete vyhledat obchod nebo cokoli jiného, ​​co je registrováno v Google Mapách, a naše komponenta získá veškeré informace o místě.

Můžete se také pohybovat po mapě a umístit značku přímo, výsledek bude stejný a zeměpisná šířka a délka se vám automaticky vyplní.

Pokud vyplňujete pole adresy a PSČ ručně, buďte opatrní, musí se shodovat s adresou známou z Google Maps.

Všechny ostatní informace o lokalitě (popis, otevírací doba atd.) se zobrazují v podrobném zobrazení lokality.

Kontaktní odkaz v edici podrobností o poloze umožňuje přidat kontaktní odkaz, e-mailovou adresu nebo URL pro každou lokalitu. Na frontendu se zobrazí kontaktní tlačítko, které otevře URL adresu nebo provede akci e-mailové adresy.

4. Další informace o poloze

Na každé místo můžete přidat obrázek a značku. 

• Obrázek lokality: Obrázek se zobrazí jako miniatura v popisku lokality a ve větší velikosti na stránce s podrobnostmi o lokalitě.
• Použít ikonu kategorie: Použít ikonu, kterou vložíte do pole kategorie mých umístění na mapě
• Pozadí značky: vyberte barvu pozadí značky
• Značka se na mapě zobrazí jako ikona značky polohy. V My Maps Location .
• Možnost Použít vlastní odkaz přepíše odkaz na podrobnosti o poloze vlastní adresou URL.

My Maps location využívají nativní vícejazyčnou funkci Joomla. Jazyk můžete definovat v kategoriích lokalit a v lokalitách. Při přepnutí jazyka budou lokality filtrovány stejně jako jakýkoli jiný obsah Joomla, aby se zobrazil obsah schválený v daném jazyce.

Pole s popisem lokality je jedno z nejdůležitějších.
Zobrazí se na stránce s podrobnostmi o lokalitě a v závislosti na tématu také jako úvodní text lokality ve výsledcích vyhledávání. A co je důležitější, popis je WYSIWYG editor se všemi nainstalovanými pluginy, což znamená, že do něj můžete vložit cokoli chcete (obrázky, videa...).

Zde je úvodní text zobrazený ve výsledcích vyhledávání polohy.

Pole pro tagy má stejný systém tagů jako Joomla. Můžete přidávat tagy a podtagy a poté je načíst do frontendu jako filtr. Pro správu všech tagů stačí načíst komponentu tagů Joomly: Komponenta Menu > Tagy
. Na frontendu se tagy v závislosti na konfiguraci mohou zobrazovat jako zaškrtávací políčka (jako níže) nebo jako rozbalovací seznam.

My Maps Location má další pole pro vyplnění metainformací (pro vyhledávače). Tato pole se načítají na stránce s podrobnostmi o poloze.

5. Zobrazení umístění na frontendu

Pro zobrazení vašich umístění na frontendu můžete použít:

• Nabídka pro zobrazení vyhledávače polohy, jedné polohy nebo kategorie poloh
• Modul pro zobrazení vyhledávacího pole nebo výběr sady umístění
• Tlačítko editoru pro zobrazení jednoho nebo více míst v libovolném editoru

Načíst lokality z nabídky

V nabídce Joomla přidejte prvek a vyberte typ „Vyhledávání a zobrazení umístění“. Zobrazí se vyhledávač umístění s filtry.
Vyberte „Zobrazení detailů umístění“ pro zobrazení jednoho předdefinovaného umístění.

Z hlavní záložky nabídky můžete nastavit:

• Zadejte adresu: můžete vynutit zobrazení výchozí adresy při načítání stránky. Pole můžete nechat prázdné.
• Vzdálenost: vzdálenost k vyhledávání zámků s odkazem na výše uvedenou adresu. Lze ji ponechat na -1 (výchozí hodnota).
• Kategorie: načíst konkrétní kategorii lokality
• Omezení vyhledávání: omezte počet výsledků vyhledávání. Hodnota 10 vrátí pouze prvních 10 výsledků vyhledávání podle lokality.
• Řazení: seřazení výsledků vyhledávání podle data, názvu, vzdálenosti (výchozí)

Pak na kartě nabídky My Maps Location můžete nastavit:

• Vyberte komponentu: My Maps Location nebo integrace se systémy třetích stran, jako je K2, Jomsocial ...
• Výchozí ID kategorie (rozšíření třetích stran): Výchozí kategorie, která se načte při použití rozšíření třetí strany, jako je K2, Hikashop nebo Adsmanager, ID seznamu CB pro nástroj pro tvorbu komunity
• Podkategorie míst: Zobrazit jako výsledky vyhledávání také místa z podkategorií, nejen z té vybrané výše.
• Téma: vyberte jedno ze 3 témat: výchozí, celošířkové a postranní panel vyhledávání a zobrazení výsledků, které jsou k dispozici pro danou položku nabídky.
• Poskytovatel map: Vyberte si Mapy Google, Bing Maps, Mapbox, OpenStreetMap, Baidu nebo Mapquest pro úpravu stylu vašich map.
• Povolit vyhledávací tagy : Umožňuje provádět vyhledávací dotazy pomocí názvů tagů umístění
• Designy: V závislosti na zdroji mapy máte k dispozici několik typů a barev map
• Vrstva mapy: Přidejte do map nějaká data (vrstvu). K dispozici jsou vrstvy KML, Doprava, Veřejná doprava a Cyklistika.
• Adresa URL vrstvy mapy Google: Datovou vrstvu použijte k uložení vlastních dat nebo k zobrazení dat GeoJSON na mapě Google.
• Typ služby Mapy Bing: Pokud je vaším poskytovatelem map Mapy Bing, vyberte vzhled a data služby Mapy Bing.
• Typ OpenStreetMap: Pokud je vaším poskytovatelem map OpenStreetMap, můžete do map přidat nějaká data (vrstvy).
• Popisek polohy: Při načítání mapy se po vyhledání polohy automaticky otevře popisek polohy
• Přiblížení mapy: Definování výchozí úrovně přiblížení mapy
• Možnosti šířky a výšky mapy a výsledků vyhledávání

Frontendový displej založený na tématu

Výsledek pro zobrazení vyhledávání jednoho místa:

Zobrazení umístění pomocí modulu

My maps location je dodáváno se 2 moduly pro nativní umístění + dalším pro integraci třetích stran (například modul pro zobrazení umístění položek K2)

Modul Mapa umožňuje zobrazit vaše lokality se stejnými filtry jako nabídka, ale na pozici modulu. Lokality se zobrazí jako Mapa nebo Seznam. Můžete vybrat sadu lokalit nebo kategorie lokalit.

My Maps Location – Vyhledávací modul zobrazí vyhledávač s možností filtrování, jako je šířka mapy nebo komponenta, ve které bude poloha vyhledávána (pro příklad hledejte pouze polohu K2).

Zobrazovací modul na frontendu:

Zobrazení umístění pomocí tlačítka editoru

Tlačítko editoru se načte do vašeho editoru Joomla (obvykle v článcích nebo vlastních HTML modulech). Tlačítko uvidíte ve spodní části editoru.
Po kliknutí se zobrazí světelný box, který vám umožní vybrat jedno nebo několik míst, která jste dříve přidali.

Pak si můžete vybrat jednu nebo více lokalit a stisknutím tlačítka ji přidat do článku. Pokud nezadáte žádnou úroveň přiblížení, bude se automaticky načíst tak, aby odpovídala oblasti vaší lokality.
Kód tagu, který uvidíte ve svém WYSIWYG editoru, bude vypadat takto: {mymaplocations mapid width height}

Např.: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} Tento kód zobrazí mapu s ID lokality = 1, s šířkou 58 %, výškou 400px, 10násobným přiblížením a typem Google. Pro přidání více než jedné lokality do mapy použijte čárku. Např.: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} s ID lokality = 1, 2, 3.