Questo widget consente di inserire una Google Map in una maschera, leggendo da un datasource le informazioni per visualizzare degli overlays come marker, linee e poligoni.

Google consente di utilizzare delle librerie javascript per insereri una mappa dinamica in una pagina web. A questa mappa è possibile aggiungere uno o più overlay, come markers (speciali icone che evidenziano un punto), linee e poligoni.
Per usare questo servizio e’ necessaria una chiave (gratuita) che verrà poi passata come parametro alla chiamata di una funzione dell’API, che associa la mappa al dominio usato nell’indirizzo della pagina.
Negli esempi seguenti, la chiave fornita può essere usata per pagine con indirizzo del tipo http://localhost.

Tutte le coordinate usate per le mappe e per gli overlays devono essere indicate con latitudine e longitudine, poco pratico per noi.
Nel widget p4a_map si è preferito usare degli indirizzi convenzionali: questo è possibile grazie alla chiamata ad una funzione Ajax che interroga il database google e torna, ad una funzione di callback, le coordinate geografiche (lat/long) usate poi per aggiornare dinamicamente la mappa e gli overlays.
Quindi, prima di usare un indirizzo, è meglio testarlo sul Sito Google Map per evitare duplicazioni o perdite di coordinate.

• Utilizzo di indizzi estesi
• Impostazione di dimensione, centro e zoom della mappa
• Possibilità di aggiungere markers sulla mappa per evidenziare punti e per ottenere informazioni passandoci sopra con il mouse

Potete vedere un esempio di utilizzo nel file GoogleTest.php del pacchetto scaricabile.

Per usare p4a_map, sono disponibili i seguenti metodi:

• Google Map site
• Google Map Api
• Get a key for using API

Rel 0.1 2007/10/17

• Release iniziale

Rel 0.1.1 2007/10/22

• Aggiunto il metodo setKey per impostare la chiave fornita da Google Map

Rel 0.1.2 2008/04/01

• Major update: Now it’s possible to calculate distances from a given center location in a given radius

• Markers could be added with or without passing geographic coordinates values

• Coordinates could be passed manually or by a specific field in the datasource

• Added setSourceCoordinatesField function for setting field name for geographic coordinates

• Added getSourceCoordinatesField function that returns the name of the fields for geographic coordinates

• Added getLocationCoordinates() functions that returns geographic coordinates of given location

• javascript was reworked

Rel 0.2

• Implementazione di icone personalizzate per i markers

Rel 0.3

• Implementazione linee e poligoni

Rel 0.4

• Gestione evento click sulla mappa per tornare coordinate geografiche alla maschera

Rel 0.5

• Implementazione autocenter/autozoom in base alla posizione degli overlay

Per usare il widget includete i files p4a_map.php e p4a_map.js come in questo esempio.

Alberto Galanti