Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps JavaScript API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps JavaScript API et les services connexes
  3. Créer les clés appropriées
Continuer

Localiser une carte

Vous pouvez personnaliser une carte afin de l'adapter à un pays ou une région spécifique. Vous devez pour cela :

  • Changer les paramètres de langue par défaut
  • Spécifier un code de région, qui modifie le comportement de la carte en fonction d'un pays ou d'un territoire donné.

Localisation linguistique

Par défaut, Google Maps JavaScript API applique le paramètre de langue préférée de l'utilisateur, tel que spécifié dans le navigateur, pour afficher les informations textuelles (noms des commandes, mentions de droits d'auteur, itinéraires et libellés sur les cartes, par exemple). Dans la plupart des cas, il est préférable de respecter le paramètre du navigateur. Si toutefois vous souhaitez que Maps JavaScript API ignore le paramètre de langue du navigateur, vous pouvez le forcer à afficher les informations dans une langue spécifique en ajoutant le paramètre language à la balise <script> lorsque vous chargez le code Maps JavaScript API.

L'exemple suivant affiche une carte en japonais et définit la région sur « Japon » :

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ja&region=JP">
</script>

Voir l'exemple

Si vous définissez la langue de la carte, il est important de définir également sa région. Cela permet de veiller à ce que votre application soit conforme à la législation locale.

Remarque : Si vous chargez l'API de cette façon, la carte utilise le japonais pour tous les utilisateurs, quelles que soient leurs préférences. Avant de définir cette option, assurez-vous que c'est effectivement le comportement souhaité.

Maps JavaScript API prend également en charge le texte bidirectionnel (Bidi) contenant des caractères à la fois en langue qui se lit de gauche à droite (LTR – left-to-right) et en langue qui se lit de droite à gauche (RTL – right-to-left), en natif. Par exemple, l'arabe, l'hébreu et le farsi sont des langues RTL. Pour assurer un rendu correct, il est généralement préférable de signaler les pages en langue RTL, en ajoutant dir='rtl' à l'élément <html> de la page. L'exemple suivant affiche le rendu d'une carte du Caire, en Égypte, à l'aide de commandes en arabe :

<!DOCTYPE html>
<html dir="rtl">
  <body>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar&region=EG">
    </script>
  </body>
</html>

Voir l'exemple

Voir la liste des langues prises en charge. Notez que de nouvelles langues sont régulièrement ajoutées. Cette liste n'est donc pas exhaustive.

Localisation régionale

Lorsque vous chargez Google Maps JavaScript API à partir de maps.googleapis.com, elle applique une préférence par défaut envers les États-Unis pour le comportement de l'application. Si vous souhaitez modifier votre application pour qu'elle fournisse d'autres tuiles de carte ou pour en changer la préférence (par exemple en favorisant la région pour les résultats de géocodage), vous pouvez modifier ce comportement par défaut en ajoutant un paramètre region à la balise <script> lorsque vous chargez le code Maps JavaScript API.

En tant que développeur d'une application Maps JavaScript API, vous devez vous assurer que votre application respecte les réglementations locales. Vous êtes donc chargé d'appliquer la localisation régionale pertinente pour le pays qui héberge l'application.

Le paramètre region prend en charge les identifiants de balise secondaire de région Unicode qui (généralement) présentent une correspondance un-à-un avec les domaines nationaux de premier niveau (ccTLD – country code Top-Level Domain). La plupart des identifiants de région Unicode sont identiques aux codes ISO 3166-1, à quelques exceptions près. Ainsi, le ccTLD du Royaume-Uni est « uk » (ce qui correspond au domaine .co.uk), tandis que son identifiant de région est « GB ».

Par exemple, la balise de script suivante localise la carte pour le Royaume-Uni :

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&region=GB">
</script>

Les exemples suivants présentent deux cartes. La première affiche le géocode « Toledo » en se basant sur la région par défaut (US, pour États-Unis), c'est-à-dire « Toledo, Ohio ». Dans la seconde, nous avons défini region sur ES (Espagne) pour biaiser les résultats afin d'afficher « Toledo, Spain ».

Voir l'exemple pour les États-Unis et l'exemple pour l'Espagne.

Charger l'API en Chine

Google Maps JavaScript API est servi en Chine depuis http://maps.google.cn. Lorsque vous proposez du contenu en Chine, remplacez https://maps.googleapis.com par http://maps.google.cn. Par exemple :

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY">
</script>

Si vous ciblez spécifiquement des utilisateurs basés en Chine, vous devriez ajouter les paramètres de région et de langue également. L'API prend en charge zh-CN et zh-TW comme valeurs du paramètre language.

<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY">
</script>

Envoyer des commentaires concernant…

Google Maps JavaScript API
Google Maps JavaScript API
Besoin d'aide ? Consultez notre page d'assistance.