VERSIONE: 7.06.00

INTRODUZIONE

Lo scopo del modulo Map è quello di sfruttare le API Google per visualizzare sulla mappa satellitare la posizione dei record del CRM. Il modulo si integra con qualunque modulo del CRM, purchè all’interno di quest’ultimo siano presenti i campi necessari (via, comune, cap, provincia, stato). Il modulo è composto da una parte di "Impostazioni", necessario alla configurazione delle API Google e alla mappatura dei campi, e dal modulo vero e proprio, dove posso scegliere quali record visualizzare sulla mappa.

PRIMA CONFIGURAZIONE

La prima cosa da fare per poter utilizzare il modulo è attivare le API fornite da Google. Per farlo, bisogna accedere a https://console.cloud.google.com, facendo il login con un account Gmail valido.

In alto a sinistra, di fianco alla scritta “Google Cloud Platform” bisogna scegliere un progetto esistente sul quale attivare le API. Se non si avessero progetti attivi, è sufficiente crearne uno nuovo.

Una volta fatto, entrare in “API e servizi” -> “Credenziali”.

In questa sezione bisogna compilare la “Schermata consenso OAuth”.

Compilare i dati come di seguito:

• Nome applicazione: VTiger;
• Domini autorizzati: il dominio di vtiger (inserire l’URL senza http:// o https:// );
• Link alla home page dell'applicazione: URL;
• Link alle Norme sulla privacy dell'applicazione: URL.

Una volta compilati questi dati cliccare su “Salva”.

Completato questo passaggio, tornare nella maschera “Credenziali”, cliccare su “Crea Credenziali” e selezionare “Chiave API”. Una volta creata la chiave API è necessario legarci le API giuste. Per farlo, cliccare su “libreria” dal menu di sinistra. Si aprirà l’elenco delle chiavi API messe a disposizione da Google.

Per il corretto funzionamento bisogna attivare:

• Maps Javascript API;
• Geocoding API;
• Geolocation API;
• Places API.

L’ultimo passaggio da fare nella Console Google è la configurazione di un account di fatturazione collegato al progetto. Cliccando su “Fatturazione” dal menu di sinistra si aprirà una maschera che vi guiderà in ogni passaggio per il collegamento dell’account di fatturazione.

Fatto anche il collegamento dell’account di fatturazione la configurazione delle API Google è completa. La chiave API ricevuta da Google va inserita in Vtiger.

LA CONFIGURAZIONE NEL CRM

La pagina di configurazione è richiamabile tramite il pulsante -> “Impostazioni” -> "Altre impostazioni” -> “Map”.

Cliccando “Modifica” in alto a destra si potrà aggiungere la chiave API fornita da Google.

Nella sezione inferiore della pagina invece possiamo inserire la mappatura dei campi di indirizzo dei vari moduli. Per farlo è sufficiente cliccare su “Aggiungi Record”. Dopo aver selezionato il modulo è sufficiente abbinare i campi correttamente e il sistema inizierà ad abbinare ad ogni record la posizione corretta.

FUNZIONAMENTO

Per visualizzare la mappa e fare una ricerca andare su -> “Map”.

Si aprirà questa maschera, dove è possibile impostare i parametri della ricerca. In questa maschera è possibile scegliere un comune e un raggio entro il quale fare la ricerca. Nel menù a tendina appena sotto è possibile scegliere il modulo, la lista che si vuole visualizzare e il colore con cui evidenziare i risultati della ricerca.

• Cliccando su “Seleziona” o sull’occhio la mappa verrà aggiornata mostrando il risultato della ricerca;
• cliccando su “Aggiungi filtro” è possibile anche effettuare la ricerca contemporaneamente su più moduli.

Sulla mappa, cliccando su uno dei segnaposto presenti, mi verranno mostrate le informazioni riguardo al record, con la possibilità di essere reindirizzati sul record cliccando sul nome in alto.

È inoltre possibile localizzare un singolo record all’interno del CRM che appartiene ai moduli che interagiscono con il modulo Map. Per farlo, sarà sufficiente premere il bottone con l’icona della mappa in detail view del record stesso.

GEOLOCALIZZAZIONE ISTANTANEA

Questa estenzione del modulo permette di attivare i suggerimenti sulla compilazione dell'indirizzo. Iniziando quindi a digitare nel campo "Indirizzo" (standard Vtiger nei moduli Azienda, Contatti e Lead), comparirà un menu a tendina con i vari suggerimenti relativi all'indirizzo che si sta andando ad inserire.

Per configurare questa estensione sarà necessario andare su "Impostazioni" --> "Altre impostazioni" --> "Geolocalizzazione istantanea" e andando su "Modifica" in alto a destra bisogna inserire la chiave API attivata precedentemente.

COSTI GOOGLE MAPS

Si trattava di un servizio gratuito fornito da Google, rimaneva gratuito rimanendo entro certi limiti.

A partire dal 16 luglio 2018 è entrato in vigore il nuovo piano tariffario di Google Maps!

Dal 16 luglio 2018, tutti i prezzi relativi a Maps dipendono esclusivamente dal consumo effetivo. Ogni mese Google accredita $ 200 di credito sull’account di fatturazione per compensare i costi di utilizzo, corrispondenti a circa € 170.

Facciamo l’esempio per Google Static Maps API (quelle più utilizzate sui siti web): fino all’anno scorso, Google permetteva l’utilizzo delle proprie mappe all’interno di un sito garantendo 25.000 visualizzazioni giornaliere, raggiunta tale soglia ogni 1.000 visualizzazioni in più si pagava $ 0,50.

La soglia massima di visualizzazioni delle mappe è stata ora ridotta a 28.000 visualizzazioni mensili (non più giornaliere!), una volta superato tale limite, ogni 1.000 visualizzazioni in più vengono addebitati $ 7.

E’ diventato obbligatorio fornire una carta di credito valida per continuare ad usufruire del servizio di Google Maps, anche se si rimane sotto la soglia delle 28.000 visualizzazioni mensili. Infatti se non vengono inserite tutte le informazioni relative alla carta di credito , si riceverà un messaggio di errore e la mappa non verrà più visualizzata anzi apparirà oscurata.

Puoi anche impostare i limiti di utilizzo per proteggersi da aumenti imprevisti.

Ecco come impostare i limiti di utilizzo:

• Accedi su Google Cloud Platform con l’account Google della tua azienda.
• Clicca su fatturazione dal menù a sinistra.
• Vai su Budget e avvisi, crea nuovo budget.
• Inserisci tutti i dati richiesti e imposta il limite di budget che non vuoi sforare!
• Puoi impostare anche gli avvisi che ti informano a che percentuale di spesa del budget sei arrivato, in modo tale da non avere brutte sorprese all’ultimo.
• Salva il budget creato, una volta superato l’utilizzo delle API che hai selezionato nel tuo account verrà bloccato così da non farti pagare di più di quanto tu hai previsto.
• Ricordati che il budget di Google è di $ 200 mensili, e si azzera a inizio di ogni mese, puoi quindi impostare come limite mensile il credito di Google!