====== Pxxo_Widget_GoogleMaps ======

Ce widget permet d'afficher une carte [[http://maps.google.com|googlemap]] dans votre page Web. Vous pouvez configurer la taille de la zone d'affichage, le zoom, la longitude/latitude de la position initiale et vous pouvez étendre ses fonctionnalités en vous basant sur l'[[http://www.google.com/apis/maps/|API GoogleMaps]].

<pxxo widget="Pxxo_Widget_GoogleMaps">
  <params>
    <key>ABQIAAAAsHVA1uQhfTfkYV-IfWkNLhSNt7z7u_GeIa9L7vF_w14j5JokQhSqookYtStELYvgzJ9XDbU1sKpgXw</key>
    <width>700px</width>
    <height>400px</height>
    <zoom>8</zoom>
    <type>G_NORMAL_MAP</type>
    <controls>GSmallMapControl</controls>
    <controls>GMapTypeControl</controls>
    <controls>GOverviewMapControl</controls>
    <controls>GScaleControl</controls>
    <extrajs>map.openInfoWindowHtml(new GLatLng(48.655791, 6.15037),"Voici l'INIST");</extrajs>
  </params>
</pxxo>
\\ 

  * Convaincu ? venez voir d'autres [[http://demo.pxxo.net/GoogleMaps/|démonstrations]] !
  * [[fr:download|Installer]]

===== Paramètres =====


^ Nom ^ Valeur par défaut ^ Description ^
| ''key'' | - | Chaîne de caractères contenant une clé générée par Google qui lui permet de vous identifier et de vous authoriser. Vous pouvez la générer facilement sur [[http://www.google.com/apis/maps/signup.html|leur site]]  |
| ''keys'' | array() | Ce paramètre peut être utilisé en remplacement du paramètre 'key' de manière à prendre en compte plusieurs domaines sans avoir à changer votre code source. C'est un tableau associatif : la cle = le hostname de votre site, la valeur = la cle google correspondante. |
| ''width'' | '700px' | Une chaine de caractères indiquant la largeur de votre zone (attention à bien préciser l'unité, ex: px, em, ...) |
| ''height'' | '500px' | Une chaine de caractères indiquant la hauteur de votre zone (attention à bien préciser l'unité, ex: px, em, % ...) |
| ''center'' | array(48.655791, 6.15037) | Un tableau de deux élements contenant la longitude et latitude du lieu sur lequel vous voulez centrer la carte au démarrage |
| ''zoom'' | 10 | Cet entier positif correspond au zoom initial de la carte. |
| ''controls'' | array("GMapTypeControl", "GOverviewMapControl", "GSmallZoomControl", "GScaleControl") | La liste des controles à afficher. La liste détaillée des valeurs posible est présente sur [[http://www.google.fr/apis/maps/documentation/#Controls_overview|le site de google]]. |
| ''type'' | 'G_SATELLITE_MAP' | Le type de la carte à afficher : vue satéllite, vue carte, vue mélangée... La liste détaillée des valeurs posible est présente sur [[http://www.google.fr/apis/maps/documentation/reference.html#GMapType|le site de google]]. |
| ''extrajs'' | - | Contient les scriptes éventuel pour personaliser votre carte en détail. |

===== Exemples =====

Pour afficher une carte centrée sur Paris avec un zoom de 8 et la vue satéllite :

<code php>
require_once "Pxxo/Widget/GoogleMaps.php";
$params = array();
$params['center'] = array(48.893615,2.373047);
$params['zoom'] = 8;
$params['type'] = 'G_SATELLITE_MAP';
$o = new Pxxo_Widget_GoogleMaps($params);
$o->main();
</code>

Pour afficher une bulle sur un lieu :
<code php>
require_once "Pxxo/Widget/GoogleMaps.php";
$params = array();
$params['center'] = array(48.655791, 6.15037);
$params['zoom'] = 8;
$params['type'] = 'G_NORMAL_MAP';
$params['width'] = '600px';
$params['height'] = '400px';
$params['controls'] = array( "GSmallMapControl", "GMapTypeControl", "GOverviewMapControl", "GScaleControl");
$params['extrajs'] = '
map.openInfoWindowHtml(
    new GLatLng(48.655791, 6.15037),
    "Voici l\'INIST");
';
$o = new Pxxo_Widget_GoogleMaps($params);
$o->main();
</code>

Pour pouvoir afficher votre widget sur plusieurs sites (domaines) sans changer votre code nous utiliserons une liste de clés préalablement créées sur le [[http://www.google.com/apis/maps/signup.html|site de googlemap]] :
<code php>
require_once "Pxxo/Widget/GoogleMaps.php";
$params = array();
$params['keys'] = array('localhost' => 'ABQIAAAAsHVA1uQhfTfkYV-IfWkNLhT2yXp_ZAY8_ufC3CFXhHIE1NvwkxT0w4QGIwdF3eOxZiE2QB5Mag_E3Q',
                        'demo.pxxo.net' => 'ABQIAAAAsHVA1uQhfTfkYV-IfWkNLhTy3_4OqSmnZknNrSliZAZOiWtLkRQgG_a1Sv7ZiQZ4RS8y6exDpGTgfw');
$o = new Pxxo_Widget_GoogleMaps($params);
$o->main();
</code>