Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar a Google Maps JavaScript API

Para começar, orientaremos você pelo Console do Desenvolvedor do Google para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar a Google Maps JavaScript API e serviços relacionados
  3. Criar chaves apropriadas
Continuar

Localização de um mapa

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&region=JP">
</script>

Ver exemplo.

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&region=EG">
    </script>
  </body>
</html>

Ver exemplo.

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&region=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>

Enviar comentários sobre…

Google Maps JavaScript API
Google Maps JavaScript API
Precisa de ajuda? Acesse nossa página de suporte.