Localiser la carte

Vous pouvez personnaliser une carte afin de l'adapter à un pays ou une région spécifiques en :

  • modifiant les paramètres de langue par défaut ;
  • spécifiant 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, l'API Maps JavaScript utilise le paramètre de langue choisi par l'utilisateur (tel qu'il est défini dans le navigateur) pour afficher des informations textuelles comme les noms des commandes, les avis de droits d'auteur, les itinéraires et les libellés sur les cartes. Dans la plupart des cas, il est préférable de respecter le paramètre du navigateur. Toutefois, si vous souhaitez que l'API Maps JavaScript ignore le paramètre de langue du navigateur, vous pouvez forcer l'affichage des informations dans une langue spécifique en ajoutant un paramètre language à la balise <script> lors du chargement du code de l'API Maps JavaScript.

Le paramètre language affecte le nom des commandes, les avis de droits d'auteur, les itinéraires et les libellés de commandes, ainsi que les réponses aux demandes de service. L'effet sur les services est moins visible. Par exemple, lors du geocoding d'adresses postales, le nom du pays est renvoyé dans la langue demandée, mais le reste de l'adresse est spécifique au lieu géocodé. En revanche, les résultats postaux et politiques sont renvoyés dans la langue demandée. Essayez cette démonstration pour tester les modifications apportées à la carte lorsque vous modifiez le paramètre language.

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

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

Voir un exemple

Si vous définissez la langue de la carte, il est important d'en définir aussi la région. Cela permet de vérifier que votre application est 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é.

L'API Maps JavaScript est également compatible avec du texte bidirectionnel (Bidi) contenant des caractères pour les langues qui se lisent de gauche à droite (LTR, left-to-right) et celles qui se lisent 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 :

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

Voir un exemple

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

Localisation régionale

Ajoutez un paramètre region à la balise <script> lors du chargement du code de l'API Maps JavaScript si vous souhaitez modifier votre application pour diffuser différentes tuiles de carte ou pondérer l'application (par exemple, pondérer les résultats du geocoding vers la région).

En tant que développeur d'une application API Maps JavaScript, nous vous encourageons à toujours définir un paramètre region, car divers services (tels que Place Autocomplete) offrent généralement de meilleurs résultats lorsque la region est définie. Vous devez aussi vous assurer que votre application respecte la législation locale en veillant à ce que la bonne localisation régionale soit appliquée au pays où l'application est hébergée.

Le paramètre region accepte les identifiants Unicode des sous-tags de région. De manière générale, il sont mappés un à un vers les domaines nationaux de premier niveau (ccTLD). La plupart des identifiants de région Unicode sont identiques aux codes alpha-2 ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD de Grande-Bretagne est "uk" (correspondant au domaine .co.uk), alors que son identifiant de région est "GB". Consultez Détails de la couverture Google Maps Platform pour obtenir une liste des régions compatibles. Essayez cette démonstration pour tester les modifications apportées à la carte lorsque vous modifiez le paramètre region.

Par exemple, le tag de script suivant localise la carte pour le Royaume-Uni :

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

Les exemples suivants montrent deux cartes. La première géocode "Toledo" en fonction d'une region définie sur US (États-Unis) pour "Toledo, Ohio", et l'autre pondère les résultats en fonction d'une region définie sur ES (Espagne) et donne "Tolède, Espagne".

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

Démonstration de la localisation

Lorsque vous définissez la langue de la carte, il est important d'en définir aussi la région. Voici une démonstration qui vous permet de charger la carte dans la langue et la région de votre choix.

Regardez cette démonstration en plein écran.