Localizar um mapa

Para personalizar o mapa a um país ou região específico, faça o seguinte:

  • 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 API Maps JavaScript usa o idioma escolhido pela pessoa, conforme especificado no navegador, quando mostra textos, como nomes de controles, notificações de direitos autorais, rotas de carro e etiquetas em mapas. Na maioria dos casos, convém aceitar a configuração do navegador. No entanto, se quiser que a API Maps JavaScript ignore o idioma do navegador e use idioma específico, adicione um parâmetro language à tag <script> quando for carregar o código da API Maps JavaScript.

O parâmetro language afeta os nomes de controles, notificações de direitos autorais, rotas de carro e etiquetas de controle, bem como as respostas às solicitações de serviço. O efeito nos serviços não é perceptível. Por exemplo, na geocodificação de endereços, o nome do país aparece no idioma solicitado, mas o restante do endereço é específico do local que você está geocodificando. Por outro lado, os resultados postais e políticos são mostrados no idioma solicitado. Utilize esta demonstração para testar as mudanças no mapa na hora de atualizar o parâmetro language.

O exemplo a seguir é de um mapa em japonês e a região definida como Japão:

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

Exemplo

Se você define o idioma do mapa, convém escolher também a região. Isso ajuda o aplicativo a obedecer às leis locais.

Observação: quando a API é carregada como mostrado acima, o mapa usa o idioma japonês para todas as pessoas, independentemente das preferências delas. Escolha essa opção apenas se realmente quiser esse comportamento.

A API Maps JavaScript também trabalha com textos bidirecionais (Bidi) com caracteres incorporados de idiomas lidos 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. Geralmente, é preciso especificar as páginas em idiomas RTL para que sejam mostradas corretamente, adicionando dir='rtl' ao elemento <html> da página. O exemplo a seguir renderiza um mapa de Cairo, no Egito, usando controles em árabe:

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

Exemplo

Consulte a lista de idiomas aceitos. Novos idiomas são adicionados com frequência e esta lista não está completa.

Localização de regiões

Adicione um parâmetro region à tag <script> ao carregar o código da API Maps JavaScript para que seu aplicativo mostre blocos de mapas diferentes ou favoreça o app (por exemplo, priorizar os resultados de geocodificação na região específica).

Ao desenvolver um aplicativo da API Maps JavaScript, é recomendável sempre definir um parâmetro region, porque vários serviços (como o Places Autocomplete) costumam oferecer resultados melhores quando region está definido. Também é sua responsabilidade garantir que o aplicativo obedeça à legislação vigente, usando a localização correta de regiões do país em que o app está hospedado.

O parâmetro region aceita identificadores de subtags de região em Unicode (link em inglês), que, geralmente, têm um mapeamento exclusivo para 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 alfa-2, 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". Saiba quais são as regiões disponíveis acessando os detalhes de cobertura da Plataforma Google Maps. Utilize esta demonstração para testar as mudanças no mapa na hora de atualizar o parâmetro region.

Por exemplo, a tag de script a seguir localiza o mapa para o Reino Unido:

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

Os exemplos a seguir mostram dois mapas. Em um deles, "Toledo" é geocodificado de acordo com uma region definida como US (EUA) para "Toledo, Ohio". No outro, os resultados são direcionados com base em uma region definida como ES (Espanha) para "Toledo, Espanha".

Confira o exemplo dos EUA e da Espanha.

Demonstração de localização

Convém definir o idioma e a região do mapa ao mesmo tempo. Abaixo segue uma demonstração que permite carregar o mapa com o idioma e região que você escolher.

Mudar esta demonstração para tela cheia.