1. Skaffa en Google Maps API-nyckel

Varje gång du använder Google Maps API:er, om din domän skapades efter den 22 juni 2016, måste du inkludera en nyckel för att validera din begäran.
Hämta en nyckel och aktivera API:et: https://developers.google.com/maps/documentation/javascript/get-api-key

Mer information: https://developers.google.com/maps/documentation/javascript/usage?hl=en

Det första steget är att skapa ett projekt och sedan skriva in projektets namn.

Om jag vill tillåta alla förfrågningar från mindomän, så är mönstret att följa *.joomunited.com/*
Om du bara vill tillåta en enskild domän, till exempel mindomän.com, så är mönstret joomunited.com/*

I en localhost-miljö kan du lägga in vilken giltig nyckel som helst och det kommer att fungera utan någon domänreferering.

API-nyckeln genereras sedan, det är den nyckel du behöver kopiera för att lägga till My Maps location.

Lägg till nyckeln till My Maps Location.

Från Komponenter > My Maps Location > Alternativ kan du lägga till en nyckel i konfigurationen.

Klistra in nyckeln.

Steg för steg-resumé:

Så stegen jag följer är

• Gå till Google API-konsolen
• Skapa eller välj ett projekt
• Klicka på Fortsätt för att aktivera API:et och alla relaterade tjänster
• På sidan Inloggningsuppgifter, hämta en webbläsarnyckel (och ange API-inloggningsuppgifterna)
• För att förhindra kvotstöld, säkra din API-nyckel enligt dessa bästa metoder

2. Hantera platskategorier

Platser klassificeras i kategorier. Dessa kategorier kan visas som filter i gränssnittet eller användas som en fördefinierad parameter i ett menyalternativ för att ladda vissa kategoriserade platser.
 

Om du har många platser rekommenderas det att använda kategorier. Du kan skapa kategorier och underkategorier.
För att skapa en kategori, gå till My Maps location > Kategori och klicka på Ny.

Sedan måste du från kategoriskärmen lägga till en titel och en överordnad kategori om du vill skapa en underkategori

Du kan också definiera en standardmarkör för plats i kategorin med hjälp av fliken Markörval

3. Skapa en plats

För att skapa en plats, gå till My Maps location > Platser > Ny

Det finns 3 obligatoriska fält:

• Platsens namn
• Platsens kategori
• Platsuppgifter (adress)      

För adressen har du 3 lösningar för att lägga till den:

• Använd sökfältet (rekommenderas)
• Navigera på kartan och använd markören för att peka på en plats
• Fyll i en adress (måste vara giltig i Google Maps)

För att lägga till en plats med sökmotorn skriver du namnet på den plats du vill lägga till.

Vid val fylls fälten för latitud och longitud i automatiskt. Mina kartor är också integrerade med Google Places! Det betyder att du kan söka efter en butik eller något annat som är registrerat på Google Maps, vår komponent kommer att hämta all platsinformation.

Du kan också flytta på kartan och placera en markör direkt, resultatet blir detsamma och du får en latitud och longitud ifyllda automatiskt.

Var försiktig med adressfältet och postnumret om du fyller i det manuellt, det måste matcha en känd adress från Google Maps.

All annan information om platsen (beskrivning, öppettider,...) visas i den detaljerade vyn av platsen.

Kontaktlänken i platsdetaljversionen ger möjlighet att lägga till en kontaktlänk, mailto eller URL per plats. I gränssnittet finns det en kontaktknapp som öppnar URL:en eller utför mailto-åtgärden.

4. Övrig platsinformation

På varje plats kan du lägga till en bild och en markör. 

• Platsbild: Bilden visas som en miniatyrbild i platsens verktygstips och i större storlek på platsens detaljsida.
• Använd kategoriikon: Använd ikonen som du placerar i kategorifältet för mina kartplatser
• Markörbakgrund: välj färg för din bakgrundsmarkör
• Markören kommer att visas på kartan som en platsmarkörikon. Du har också några fina marköruppsättningar för dina platser inkluderade i platstillägget My Maps Location
• Använd en anpassad länk kommer att åsidosätta länken till platsinformationen med en anpassad URL.

My Maps location använder Joomlas inbyggda flerspråkiga funktion. Du kan definiera ett språk i kategorier för plats och i platser. Vid språkbyte filtreras platser som allt annat Joomla-innehåll för att visa det språkgodkända innehållet.

Fältet för platsbeskrivning är ett av de viktigaste.
Det visas på platsens detaljsida och, beroende på tema, som en introduktionstext för platsen i sökresultaten. Ännu viktigare är att beskrivningen är en WYSIWYG-editor med alla plugin-program laddade inuti, vilket innebär att du kan lägga till vad du vill i den (bilder, videor...).

Här är introduktionstexten som visas i sökresultaten för plats.

Taggfältet är samma taggsystem som i Joomla. Du kan lägga till taggar och undertaggar och sedan ladda det i frontend som ett filter. För att hantera alla taggar, ladda bara Joomlas taggkomponent: Menykomponent > Taggar
Beroende på konfigurationen kan taggar visas som kryssrutor (som nedan) eller som en rullgardinslista.

My Maps Location har fått ytterligare fält för att fylla i metainformation (för sökmotorer). Dessa fält laddas på platsens detaljsida.

5. Visa platser på frontend

För att visa dina platser i frontend-gränssnittet kan du använda:

• En meny för att visa platssökmotor, enskild plats eller en kategori av platser
• En modul för att visa ett sökfält eller välja en uppsättning platser
• En redigeringsknapp för att visa en eller flera platser i valfri redigerare

Ladda platser från en meny

Från Joomlas menyhanterare, lägg till ett element och välj typen "Platssökning och visning". Det visar platssökningsmotorn med filter.
Välj "Platsdetaljvy" för att visa en enda fördefinierad plats.

Från huvudfliken i menyn kan du ställa in:

• Ange adress: du kan tvinga fram en standardadress som visas när sidan laddas. Fältet kan lämnas tomt
• Avstånd: avståndet till låst sökning, med hänvisning till adressen ovan. Det kan lämnas som -1 (standard)
• Kategori: ladda en specifik platskategori
• Sökgräns: begränsa antalet sökresultat. 10 returnerar endast de 10 första resultaten vid platssökning
• Ordning: sortera sökresultat efter datum, titel, avstånd (standard)

kan du ställa in följande på menyfliken My Maps Location

• Välj komponent: My Maps Location eller all tredjepartsintegration som K2, Jomsocial ...
• Standardkategori-ID (tredjepartstillägg): Standardkategori som laddas när ett tredjepartstillägg används, som K2, Hikashop eller Adsmanager, CB-list-ID för community Builder
• Platser från underkategorier: Visa även platser från underkategorier som sökresultat, inte bara den som valts ovan
• Tema: välj ett av de 3 temana standard, full bredd och sidofält för sök- och resultatvisningstemat som är tillgängligt för menyalternativet.
• Kartleverantör: Välj Google Maps, Bing Maps, Mapbox, OpenStreetMap, Baidu eller Mapquest för att utforma dina kartor
• Aktivera söktaggar : Tillåter att sökfrågor utförs med hjälp av platstaggar
• Design: Beroende på kartkällan finns det flera karttyper och färger
• Kartlager: Lägg till datalager till dina kartor. Det finns KML-lager, trafiklager, kollektivtrafiklager och cykellager.
• Google Map Layer URL: Använd datalagret för att lagra dina anpassade data eller för att visa GeoJSON-data på en Google-karta
• Bing Maps-typ: Om Bing Maps är din kartleverantör väljer du utseende och data för Bing Maps.
• OpenStreetMap-typ: Om OpenStreetMap är din kartleverantör kan du lägga till data (lager) till dina kartor
• Platstips: Öppnar automatiskt platsstips efter platssökning när kartan laddas
• Kartzoom: Definiera en standardzoomnivå på kartan
• Bredd- och höjdalternativ för kartor och sökresultat

Frontend-display baserad på tema

Resultat för en visning av en enda platssökning:

Visa platser med hjälp av en modul

My maps location levereras med två moduler för lokala platser + en annan för tredjepartsintegration (som en modul för att visa K2-objektens platsinformation)

Kartmodulen låter dig visa dina platser med samma filter som menyn men i en modulposition. Platserna visas som karta eller lista. Du kan välja en uppsättning platser eller välja platskategorier.

My Maps Location Map – Sökmodulen visar en sökmotor med några filter som alternativ, som kartans bredd eller den komponent där platsen ska sökas i (sök endast efter K2-plats som exempel).

Displaymodul på frontend:

Visa platser med hjälp av en redigeringsknapp

Redigeringsknappen laddas i din Joomla-redigerare (vanligtvis i artiklar eller anpassade HTML-moduler). Du ser knappen längst ner i din redigerare.
När du klickar ser du en ljusruta som låter dig välja en eller flera platser som du har lagt till tidigare.

Sedan kan du välja en eller flera platser och trycka på knappen för att lägga till dem i din artikel. Om du inte anger någon zoomnivå laddas den automatiskt för att passa ditt platsområde.
Taggkoden du ser i din WYSIWYG-redigerare kommer att se ut som denna modell: {mymaplocations mapid width height}

Exempel: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} Den här koden visar en karta med plats-ID=1, med 58% bredd, 400px höjd, 10 gånger zoom och Google-typ. Använd kommatecken för att lägga till mer än en plats på en karta. Exempel: {mymaplocation id=1 width=58% height=400px zoom=10 type=google} plats-ID = 1, 2, 3.