API o iFrame? Come integrare Google Maps

Quando l’8 febbraio 2005 è stato lanciato Google Maps, era difficile im­ma­gi­na­re quanto questo servizio di mappe online avrebbe in­fluen­za­to la vita quo­ti­dia­na di tutti gli utenti. Da oltre 10 anni questo servizio web mette a di­spo­si­zio­ne online immagini scattate dai satelliti dell’intero globo terrestre e grazie anche alla dif­fu­sio­ne degli smart­pho­ne è diventato oggi un ac­com­pa­gna­to­re prezioso. Google Maps permette di calcolare ad esempio la distanza tra l’hotel scelto per le vacanze e la spiaggia, o quali siano i ri­sto­ran­ti vicini più in voga, co­mo­da­men­te da casa. Il servizio si rivela anche un fon­da­men­ta­le aiuto per rag­giun­ge­re mete sco­no­sciu­te e aiuta a ritrovare la strada se ci si è persi, che ci si trovi a piedi, in bi­ci­clet­ta, in auto o che ci si sposti con i mezzi pubblici.

Inoltre i webmaster possono uti­liz­za­re Google Maps a proprio vantaggio, inserendo ad esempio una porzione di mappa sul proprio sito per indicare dove si trova l’azienda, l’hotel o il negozio che ge­sti­sco­no e suggerire il percorso migliore per arrivarci. Ma come si inserisce Google Maps sul sito e quali sono le regole da ri­spet­ta­re per l’uso a scopi com­mer­cia­li?

Nel menu di na­vi­ga­zio­ne trovate diverse opzioni: vi­sua­liz­za­re il tragitto in auto o con i mezzi pubblici e ottenere altri sug­ge­ri­men­ti utili per usare al meglio il servizio. Alla voce “I tuoi luoghi” sono visibili tutte le mappe che avete salvato in pre­ce­den­za. Invece per salvarne di nuove, cliccate su “Mappe> crea mappa”.

Copiate e incollate la stringa nel codice sorgente del vostro sito. A fianco al campo dove è inserito il codice trovate un menu a tendina dal quale scegliere le di­men­sio­ni della vostra mappa, sce­glien­do tra quelle già fornite da Google (medie, piccole o grandi) o ag­giun­gen­do­ne di per­so­na­liz­za­te. Il codice HTML integrato è un elemento iFrame e quindi il contenuto della carta verrà caricato ogni volta dal server di Google, senza uti­liz­za­re il vostro web server. Questa tecnica viene sup­por­ta­ta da quasi tutti i browser ed è la stessa usata per integrare i pulsanti per i social media.

L’in­te­gra­zio­ne di Google Maps tramite iFrame è con­sen­ti­ta solo per uso privato. Se volete uti­liz­za­re il servizio a scopi com­mer­cia­li, è prevista l’in­ser­zio­ne tramite le API ufficiali di Google Maps.

Inserire le mappe di Google tramite API (ap­pli­ca­tion pro­gram­ming interface) è un po’ più complesso che con la tecnica dell’iFrame. Allo stesso tempo però grazie all’utilizzo di queste in­ter­fac­ce di pro­gram­ma­zio­ne, gli svi­lup­pa­to­ri hanno nuove pos­si­bi­li­tà per integrare Google Maps al proprio progetto web. Nel caso ad esempio del servizio di mes­sag­gi­sti­ca istan­ta­nea WhatsApp, è possibile co­mu­ni­ca­re ai propri amici l’esatto luogo in cui ci si trova. Anche il servizio Plane Finder, che mostra il traffico aereo in tempo reale, utilizza diverse API di Google Maps.

Per conoscere tutte le API di­spo­ni­bi­li e capire quale si adatti meglio al vostro progetto, si consiglia di dare un‘occhiata alla pagina in­for­ma­ti­va in inglese sul sito di Google dedicato agli svi­lup­pa­to­ri.

1. Avviate la procedura cliccando su “Get a key” (richiedi una chiave) e con­fer­ma­te i termini del servizio; così facendo potete creare un nuovo progetto e una chiave API per il browser. 2. Dopo aver generato la chiave API, potete uti­liz­zar­la subito per la vostra ap­pli­ca­zio­ne. I passi da compiere per integrare la chiave nel documento HTML ed eventuali modifiche, sono indicati nella guida di Google.

L’utilizzo di un’in­ter­fac­cia di pro­gram­ma­zio­ne di Google non comporta di per se dei costi. Ciò che ne determina un eventuale pagamento sono il tipo di sito o di app gestite. Nel caso di progetti gratuiti per gli utenti, in genere si paga solo per quelle API che superano il numero pre­fis­sa­to di visite al giorno o al mese. Se il sito o l’app servono per rin­trac­cia­re dove si trovano persone o oggetti, l’in­te­gra­zio­ne delle API di Google Maps è sempre a pagamento. Trovate in­for­ma­zio­ni sui diversi prezzi e licenze d’uso sulla pagina di Google Maps API. Se siete insicuri, su questa pagina trovate anche in­di­ca­zio­ni per con­tat­ta­re i partner au­to­riz­za­ti da Google che vi potranno aiutare per scegliere l’API migliore a seconda delle vostre esigenze.

Inserire Google Maps nel vostro sito tramite iFrame o API offre dei vantaggi in­di­scu­ti­bi­li: potrete offrire un servizio ag­giun­ti­vo agli utenti senza caricare ul­te­rior­men­te il vostro web server. In virtù di questi vantaggi, Google nel 2012 ha in­tro­dot­to dei costi per i siti ad uso com­mer­cia­le con un alto numero di vi­si­ta­to­ri che vogliono uti­liz­za­re il servizio. Da qui l’obbligo per siti e app ad uso com­mer­cia­le di inserire Google Maps tramite API. Se quindi de­si­de­ra­te indicare all’interno della mappa altre in­for­ma­zio­ni oltre al semplice se­gna­po­sto, vi ser­vi­ran­no co­no­scen­ze di Ja­va­Script e HTML. Per coloro che vogliono integrare Google Maps solo ad uso privato e che non si aspettano un numero elevato di visite, è suf­fi­cien­te l’in­te­gra­zio­ne tramite iFrame.