1. Ottieni una chiave API di Google Maps
Ogni volta che utilizzi le API di Google Maps , se il tuo dominio è stato creato dopo il 22 2016 giugno, devi convalidare una chiave per convalidare la tua richiesta.
Ottieni una chiave e abilita l'API: https://developers.google.com/maps/documentation/javascript/get-api-key
Maggiori informazioni: https://developers.google.com/maps/documentation/javascript/usage?hl=en
Il primo passo è quello di creare un progetto e quindi digitare il nome del progetto.
Se voglio consentire tutte le richieste dal mio dominio, lo schema da seguire è * .joomunited.com / *
Se si desidera consentire solo un singolo dominio, ad esempio mydomain.com, il modello sarebbe joomunited.com/*
In un ambiente localhost, puoi inserire qualsiasi chiave valida e funzionerà senza alcun riferimento al dominio.
Viene quindi generata la chiave API, questa è la chiave che devi copiare per aggiungere alla My Maps location .
Aggiungi la chiave alla posizione Le My Maps Location .
Dal Componenti> My Maps Location > Visualizzazione opzioni, puoi aggiungere una chiave nella configurazione.
Incolla la chiave.
Resume passo dopo passo:
Quindi i passaggi che seguo sono
- Vai alla Console API di Google
- Crea o seleziona un progetto
- Clicca su Continua per abilitare l'API e tutti i servizi correlati
- Nella pagina Credenziali, ottenere a Tasto del browser (e imposta le credenziali API)
- Per prevenire il furto di quote, proteggere la seguente chiave API quelle migliori pratiche
2 Gestire le categorie di posizione
Le posizioni sono classificate in categorie. Tali categorie possono essere visualizzate come filtro in frontend o utilizzate come parametro predefinito in una voce di menu per caricare alcune posizioni categorizzate.
Se hai molte località, si consiglia di utilizzare le categorie. È possibile creare categorie e sottocategorie.
Per creare una categoria, accedi My Maps location > Categoria e fare clic su Nuovo
Quindi dalla schermata della categoria dovrai aggiungere un titolo e una categoria principale nel caso in cui desideri creare una sottocategoria
È inoltre possibile definire un indicatore predefinito per la posizione nella categoria utilizzando la scheda Selezione marcatore
Nota: una categoria viene creata per impostazione predefinita denominata "La mia categoria" che consente di iniziare ad aggiungere posizioni direttamente dopo l'installazione
3 Crea una posizione
Per creare una posizione, accedi My Maps location > Posizioni> Nuovo
Vi sono 3 campi obbligatori:
- Nome del luogo
- Categoria del luogo
- Dettagli posizione (indirizzo)
Per l'indirizzo hai 3 soluzioni per aggiungerlo:
- Usa il campo di ricerca (consigliato)
- Navigare sulla mappa e utilizzare il cursore per indicare una posizione
- Inserisci un indirizzo (deve essere valido Google Maps )
Per aggiungere una posizione con il motore di ricerca, digitare il nome del luogo che si desidera aggiungere.
Selezionando, i campi di latitudine e longitudine verranno riempiti automaticamente. Le mie mappe sono integrate anche con Google Places! Significa che puoi cercare un negozio o qualsiasi altra cosa sia registrata su Google Maps , il nostro componente riceverà tutte le informazioni sul luogo.
Puoi anche muoverti sulla mappa e mettere un indicatore direttamente, il risultato sarà lo stesso e otterrai una latitudine e una longitudine riempite automaticamente.
Fai attenzione con il campo dell'indirizzo e il codice postale se lo compili manualmente, deve corrispondere a un indirizzo noto di Google Maps .
Tutte le altre informazioni sulla posizione (descrizione, ore, ...) vengono visualizzate nella vista dettagliata della posizione.
Il collegamento di contatto nell'edizione dei dettagli della posizione è la possibilità di aggiungere un collegamento di contatto, mailto o URL per posizione. Sul frontend sarà presente un pulsante di contatto che aprirà l'URL o eseguirà l'azione mailto.
Su ogni posizione è possibile aggiungere un'immagine e un marcatore.
- Posizione immagine: L'immagine verrà visualizzata come anteprima nella descrizione comando della posizione e con dimensioni maggiori nella pagina dei dettagli della posizione.
- Usa l'icona della categoria: Usa l'icona che hai inserito nel campo categoria delle posizioni della mia mappa
- Sfondo marcatore: scegli il colore per il tuo marcatore di sfondo
- marcatore verrà visualizzato sulla mappa come icona dell'indicatore di posizione. Hai anche alcuni set di indicatori utili per le tue posizioni inclusi nell'estensione My Maps Location .
- Usa un collegamento personalizzato sovrascriverà il collegamento ai dettagli della posizione con un URL personalizzato.
My Maps location utilizza la funzione multilingue nativa di Joomla . È possibile definire una lingua in categorie di località e località. Al cambio di lingua, le posizioni verranno filtrate come qualsiasi altro contenuto di Joomla al fine di visualizzare il contenuto approvato dalla lingua.
Il campo della descrizione della posizione è uno dei più importanti.
Verrà visualizzato nella pagina dei dettagli della posizione e, a seconda del tema, come testo introduttivo della posizione nei risultati di ricerca. Ancora più importante, la descrizione è un editor WYSIWYG con tutti i plugin caricati al suo interno, significa che puoi fare tutto ciò che vuoi (immagini, video ...).
Ecco il testo introduttivo visualizzato nei risultati della ricerca della posizione.
Il campo tag è lo stesso sistema di tag di Joomla . È possibile aggiungere tag e tag secondari, quindi caricarli in frontend come filtro. Per gestire tutti i tag, basta caricare il componente tag Joomla : Componente menu> Tag
Sul frontend, a seconda della configurazione, i tag possono essere visualizzati come casella di controllo (come sotto) o come elenco a discesa.
My Maps Location ha campi aggiuntivi per riempire le meta informazioni (per i motori di ricerca). Questi campi vengono caricati nella pagina dei dettagli della posizione.
5 Visualizza posizioni sul frontend
Per visualizzare le tue posizioni sul frontend puoi usare:
- Un menu per visualizzare il motore di ricerca della posizione, la posizione singola o la categoria di posizioni
- Un modulo per visualizzare un campo di ricerca o selezionare un set di posizioni
- Un pulsante dell'editor per visualizzare posizioni singole o multiple in qualsiasi editor
Dal gestore del menu Joomla , aggiungi un elemento e seleziona come tipo "Ricerca e visualizzazione della posizione". Verrà visualizzato il motore di ricerca della posizione con filtri.
Selezionare "Vista dettagli posizione" per visualizzare una singola posizione predefinita.
Se selezioni "Ricerca e visualizzazione della posizione" hai alcuni parametri di visualizzazione. Alcuni potrebbero sovrascrivere i parametri dei componenti predefiniti.
Dalla scheda principale del menu è possibile configurare:
- Inserisci l'indirizzo: puoi forzare la visualizzazione di un indirizzo predefinito al caricamento della pagina. Può essere lasciato vuoto
- Distanza: la distanza per bloccare la ricerca, facendo riferimento all'indirizzo sopra. Può essere lasciato come -1 (impostazione predefinita)
- Categoria: carica una categoria specifica di posizione
- Limite di ricerca: limitare il numero di risultati della ricerca. 10 restituirà solo i primi 10 risultati nella ricerca della posizione
- Ordinamento: ordina i risultati della ricerca per data, titolo, distanza (impostazione predefinita)
Quindi sul Scheda menu My Maps Location, puoi configurare:
- Seleziona componente: My Maps Location o l'integrazione di tutte le terze parti come K2, Jomsocial ...
- ID categoria predefinito (Estensioni di terze parti): categoria predefinita da caricare quando viene utilizzata un'estensione di terze parti, come K2, Hikashop o Adsmanager, ID elenco CB per builder comunità
- Posizioni delle categorie secondarie: Visualizza anche come posizioni dei risultati di ricerca da sottocategorie, non solo quella selezionata sopra
- Tema: seleziona uno dei 3 temi predefiniti, larghezza completa e barra laterale del tema di ricerca e visualizzazione dei risultati disponibile per la voce di menu
- Fornitore di mappe: Seleziona Google Maps , Bing Maps , Mapbox, OpenStreetMap, Baidu o Mapquest per personalizzare le tue mappe
- Abilita tag di ricerca: Consente di eseguire query di ricerca utilizzando i nomi dei tag di posizione
- disegni: A seconda della fonte della mappa hai diversi tipi e colori di mappa
- Livello mappa: Aggiungi alcuni dati (livello) alle tue mappe. Sono disponibili il livello KML, il livello Traffico, il livello Transito e il livello Bicicletta.
- URL livello mappa di Google: Utilizza il livello Dati per archiviare i tuoi dati personalizzati o per visualizzare i dati GeoJSON su una mappa di Google
- Tipo di Bing Maps : Se Bing Maps è il tuo fornitore di mappe, seleziona l'aspetto e i dati di Bing Maps
- Tipo di OpenStreetMap: Se OpenStreetMap è il tuo fornitore di mappe, puoi aggiungere alcuni dati (layer) alle tue mappe
- Descrizione comando posizione: Al caricamento della mappa, apri automaticamente la descrizione comando posizione dopo la ricerca posizione
- Zoom mappa: Definisci un livello di zoom predefinito sulla mappa
- Opzioni di larghezza e altezza della mappa e dei risultati di ricerca
Display frontend basato sul tema
Risultato per un singolo display di ricerca della posizione:
Visualizza le posizioni utilizzando un modulo
My maps location include 2 moduli per le posizioni native + altri per l'integrazione di terze parti (come un modulo per visualizzare le posizioni degli articoli K2)
Il modulo Mappa consente di visualizzare le posizioni con gli stessi filtri del menu ma in una posizione del modulo. Le posizioni verranno visualizzate come Mappa o Elenco. È possibile selezionare un set di posizioni o selezionare le categorie di posizione.
My Maps Location Mappa di My Maps Location - Modulo di ricerca visualizzerà un motore di ricerca con alcuni filtri come opzione come la larghezza della mappa o il componente in cui verrà cercata la posizione (cercare la posizione K2 solo per axample).
Modulo display sul frontend:
Il pulsante dell'editor verrà caricato nel tuo editor Joomla (di solito in articoli o moduli personalizzati HTML). Vedrai il pulsante nella parte inferiore dell'editor.
Al clic, vedrai una lightbox che ti consente di selezionare una o più posizioni che hai aggiunto in precedenza.
Quindi puoi selezionare una o più posizioni e premere il pulsante per aggiungerlo nel tuo articolo. Se non si specifica alcun livello di zoom, verrà automaticamente caricato per adattarsi alla propria area di posizione.
Il codice tag che vedrai nel tuo editor WYSIWYG sarà simile a questo modello: {mymaplocations mapid width height}
Ad esempio: {mymaplocation id = 1 larghezza = 58% altezza = 400 px zoom = 10 tipo = google} questo codice visualizzerà una mappa con l'ID posizione = 1, con larghezza 58%, altezza 400 px, zoom 10 volte e tipo Google. Utilizzo della virgola per aggiungere più di una posizione in una mappa. Ad esempio: {mymaplocation id = 1 larghezza = 58% altezza = 400px zoom = 10 tipo = google} l'ID posizione = 1, 2 , 3 .
