Localizar um mapa

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

É possível personalizar o mapa para um país ou região específica das seguintes maneiras:

  • Altere as configurações padrão de idioma.
  • Especifique um código de região, que altera o comportamento do mapa com base em um determinado país ou território.

Localização de idioma

Por padrão, a API Maps JavaScript usa a configuração de idioma preferido do usuário, conforme especificado no navegador, ao exibir informações textuais, como nomes de controles, avisos de direitos autorais, rotas de carro e etiquetas em mapas. Na maioria dos casos, é preferível respeitar a configuração do navegador. No entanto, se quiser que a API Maps JavaScript ignore a configuração de idioma do navegador, você poderá forçar a exibição de informações em um idioma específico adicionando um parâmetro language à tag <script> ao carregar o código da API Maps JavaScript.

O parâmetro language afeta os nomes de controles, avisos de direitos autorais, rotas de carro e rótulos de controle, bem como as respostas às solicitações de serviço. O efeito nos serviços não é aparente. Por exemplo, ao geocodificar endereços no nível da rua, o nome do país é retornado no idioma solicitado, mas o restante do endereço será específico para o local que você está geocodificando. Por outro lado, os resultados postais e políticos são retornados no idioma solicitado. Tente esta demonstração para testar as mudanças no mapa ao atualizar o parâmetro language.

O exemplo a seguir exibe um mapa em japonês e define a região como Japão:

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

Ver exemplo.

Se você definir o idioma do mapa, também será importante definir a região. Isso ajuda a garantir que o aplicativo obedeça à legislação local.

Observação: quando você carrega 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 API Maps JavaScript também é compatível nativamente com texto bidirecional (Bidi) contendo caracteres em idiomas da esquerda para a direita (LTR, na sigla em inglês) e da direita para a esquerda (RTL, na sigla em inglês). Exemplos de idiomas RTL incluem árabe, hebraico e farsi. Geralmente, é preciso especificar páginas em idiomas RTL para renderizar corretamente, adicionando dir='rtl' ao elemento <html> da página. O exemplo a seguir renderiza um mapa de Cairo, Egito usando controles árabes:

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

Ver exemplo

Consulte a lista de idiomas compatíveis. Como novos idiomas são adicionados com frequência, essa lista pode não estar completa.

Localização de regiões

Adicione um parâmetro region à tag <script> ao carregar o código da API Maps JavaScript se quiser alterar seu aplicativo para exibir blocos de mapas diferentes ou polarizar o aplicativo (por exemplo, direcionar resultados de geocodificação para a região).

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) tendem a oferecer resultados melhores quando region está definido. Também é sua responsabilidade garantir que o aplicativo obedeça às leis locais. Certifique-se de que a localização correta da região esteja aplicada para o país em que o aplicativo está hospedado.

O parâmetro region aceita identificadores de subtag de região Unicode, que (geralmente) têm um mapeamento de um para um para domínios de nível superior de código do país (ccTLDs, na sigla em inglês). 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), enquanto o identificador da região é "GB." Consulte os detalhes da cobertura da Plataforma Google Maps para ver as regiões compatíveis. Tente esta demonstração para testar as mudanças no mapa ao atualizar o parâmetro region.

Por exemplo, a seguinte tag de script 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, um que geocodifica "Toledo" com base em um region definido como US (EUA) para "Toledo, Ohio" e outro que polariza os resultados com base em um region definido como ES (Espanha) para "Toledo, Espanha."

Veja os exemplos nos EUA e ES.

Demonstração de localização

Ao definir o idioma do mapa, é importante considerar também definir a região. Veja uma demonstração que permite carregar o mapa com sua escolha de idioma e região.

Veja esta demonstração em tela cheia.