Localiser une 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 la démonstration de localisation 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

Langues disponibles

Google met souvent à jour les langues acceptées. Cette liste n'est peut-être pas exhaustive et est sujette à modification.

Code de langue	Langue	Code de langue	Langue
af	Afrikaans	ja	Japonais
sq	Albanais	kn	Kannada
am	Amharique	kk	Kazakh
ar	Arabe	km	Khmer
hy	Arménien	ko	Coréen
az	Azéri	ky	Kirghiz
eu	Basque	lo	Laotien
be	Biélorusse	lv	Letton
bn	Bengali	lt	Lituanien
bs	Bosnien	mk	Macédonien
bg	Bulgare	ms	Malais
my	Birman	ml	Malayalam
ca	Catalan	mr	Marathi
zh	Chinois	mn	Mongol
zh-CN	Chinois (simplifié)	ne	Népalais
zh-HK	Chinois (Hong Kong)	no	Norvégien
zh-TW	Chinois (traditionnel)	pl	Polonais
hr	Croate	pt	Portugais
cs	Tchèque	pt-BR	Portugais (Brésil)
da	Danois	pt-PT	Portugais (Portugal)
nl	Néerlandais	pa	Panjabi
en	Anglais	ro	Roumain
en-AU	Anglais (Australie)	ru	Russe
en-GB	Anglais (Grande-Bretagne)	sr	Serbe (cyrillique)
et	Estonien	sr-Latn	Serbe (alphabet latin)
fa	Farsi	si	Cingalais
fi	Finnois	sk	Slovaque
fil	Tagalog	sl	Slovène
fr	Français	es	Espagnol
fr-CA	Français (Canada)	es-419	Espagnol (Amérique latine)
gl	Galicien	sw	Swahili
ka	Géorgien	sv	Suédois
de	Allemand	ta	Tamoul
el	Grec	te	Telugu
gu	Gujarati	th	Thaï
iw	Hébreu	tr	Turc
hi	Hindi	uk	Ukrainien
hu	Hongrois	ur	Urdu
est	Islandais	uz	Ouzbek
id	Indonésien	vi	Vietnamien
it	Italien	zu	Zoulou

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.