Você pode personalizar o mapa para um país ou região específico das seguintes formas:
- Altere as configurações padrão de idioma.
- Especifique um código de região, o que altera o comportamento do mapa com base em um certo país ou território.
Localização de idioma
Por padrão, a Google Maps JavaScript API usa a configuração de idioma preferencial do usuário como especificada no navegador para exibir informações textuais, como nomes de controles, notificações de direitos autorais, rotas de condução e rótulos em mapas. Na maioria dos casos, é preferível respeitar a configuração do navegador. No entanto, se você quiser que a Maps JavaScript API ignore a configuração de idioma do navegador, poderá forçá-lo a exibir as informações em um idioma em particular adicionando um parâmetro language à tag <script> quando carregar o código da Maps JavaScript API.
O exemplo a seguir exibe um mapa em japonês e define a região para o Japão:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ja®ion=JP"> </script>
Se você define o idioma do mapa, é importante considerar configurar também a região. Isso ajuda a garantir que o aplicativo esteja em conformidade com as leis locais.
Observação: Ao carregar a API da maneira mostrada acima, o mapa usa o idioma japonês para todos os usuários, independentemente das preferências do usuário. Tenha certeza de que é esse o comportamento desejado antes de configurar essa opção.
A Maps JavaScript API também oferece suporte nativo a texto bidirecional (Bidi) contendo caracteres de idiomas da esquerda para a direita (LTR) e da direita para a esquerda (RTL). Entre os exemplos de idiomas RTL estão árabe, hebraico e farsi. De forma geral, para que páginas com idiomas RTL sejam renderizadas corretamente, adicione dir='rtl' ao elemento <html> da página. O exemplo a seguir renderiza um mapa de Cairo, Egito, usando controles em árabe:
<!DOCTYPE html>
<html dir="rtl">
<body>
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&language=ar®ion=EG">
</script>
</body>
</html>
Confira a lista de idiomas suportados. Observe que novos idiomas são adicionados com frequência e esta lista pode não ser exaustiva.
Localização de regiões
Ao carregar a Google Maps JavaScript API d maps.googleapis.com, ela aplica uma polarização padrão para o comportamento do aplicativo em relação aos Estados Unidos. Para alterar o aplicativo para fornecer blocos de mapa diferentes ou polarizar o aplicativo (como polarizar resultados de geocodificação para a região), substitua o comportamento padrão adicionando um parâmetro region à tag <script> ao carregar o código da Maps JavaScript API.
Como desenvolvedor de um aplicativo da Maps JavaScript API, é sua responsabilidade verificar se o aplicativo cumpre as leis locais, garantindo a aplicação da localização de região correta para o país onde o aplicativo está hospedado.
O parâmetro region aceita identificadores de subtag de região Unicode que, normalmente, têm uma relação de um para um com os domínios de nível superior de código de país (ccTLDs). A maioria dos identificadores de região Unicode é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD da Grã-Bretanha é "uk" (correspondente ao domínio .co.uk) e o identificador de região é "GB."
Por exemplo, a tag de script a seguir localiza o mapa para o Reino Unido:
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY®ion=GB"> </script>
Os exemplos a seguir mostram dois mapas. Em um deles, "Toledo" é geocodificado de acordo com a região padrão (US) como "Toledo, Ohio". No outro, os resultados são direcionados com base em uma region definida como ES (Espanha) para "Toledo, Espanha".
Veja o exemplo de US e o exemplo de ES.
Carregamento da API na China
A Google Maps JavaScript API é atendida dentro da China em http://maps.google.cn. Para fornecer conteúdo para a China, substitua https://maps.googleapis.com por http://maps.google.cn. Por exemplo:
<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY"> </script>
Para direcionar o aplicativo a usuários na China, adicione também os parâmetros de região e idioma. A API permite os valores zh-CN e zh-TW para o parâmetro language.
<script src="http://maps.google.cn/maps/api/js?region=cn&language=zh-CN&key=YOUR_API_KEY"> </script>
Precisa de ajuda? Acesse nossa