Criar e usar estilos de mapa

Selecione a plataforma: Android Android 3D iOS iOS 3D JavaScript Web Service

Um estilo de mapa é um conjunto de personalizações visuais dos elementos do mapa que você associa a um ID de mapa. Depois, você adiciona o ID ao código do aplicativo para mostrar o mapa personalizado.

É possível criar um estilo de mapa antes de ter um ID do mapa, mas, para usar esse estilo, você precisa associá-lo a um ID do mapa. Para usar um estilo de mapa, é necessário seguir estas etapas:

1. Criar e publicar um estilo de mapa. Para mais detalhes, confira Criar um estilo e Publicar um estilo.

2. Criar um ID do mapa. Para saber mais, confira o artigo Criar um ID do mapa.

3. Associe o estilo de mapa a um ID do mapa. Para mais detalhes, consulte Associar um ID do mapa a um estilo de mapa.

4. Incluir o ID do mapa no app para mostrar o estilo. Para saber mais, consulte Adicionar o ID ao mapa.

Dica: quando o ID do mapa for incluído no código do aplicativo, você poderá mudar o estilo de mapa sem precisar alterar esse código. Além disso, seus usuários finais não precisam fazer upgrade para acessar os estilos de mapa atualizados. Em vez disso, você edita o estilo de mapa associado ao ID do mapa. As mudanças aparecem nos mapas do aplicativo.

Este documento descreve como criar, editar e publicar estilos de mapa e como associá-los a um ID do mapa.

Criar um estilo de mapa

Crie um estilo de mapa seguindo um destes métodos:

• Crie um estilo usando o estilo de mapa padrão do Google.

• Copie e modifique um estilo personalizado existente.

• Importe um estilo de mapa JSON para usar como um estilo personalizado.

Criar um novo estilo

1. No console do Google Cloud, acesse Estilos de mapa e selecione um projeto, se necessário.

2. Em Estilos de mapa, clique em Criar estilo.

3. Na caixa de diálogo, na guia Estilos do Google, selecione um modo.

   • Claro: cria um estilo com tema claro, ideal para ambientes claros ou ao ar livre.
   • Escuro cria um estilo de tema escuro, ideal para ambientes com pouca luz.

   Para mais informações sobre estilos de modo claro e escuro, consulte Aprenda Mais sobre modos e tipos de mapa.

4. (Opcional) Para aplicar uma variação de tema ao estilo de mapa, em Tema opcional, selecione uma das seguintes opções:

   • Monocromático: cria uma versão em escala de cinza do estilo de mapa.
   • Ambiente: cria uma versão mais discreta do estilo de mapa. Essa opção só vai estar disponível se o SDK de navegação estiver ativado no seu projeto.

   Como alternativa, clique na guia JSON para importar um estilo de mapa JSON.

   

5. Selecione Personalizar para criar um novo estilo sem título.

6. Escolha os elementos do mapa e mude o estilo para criar o estilo de mapa que você quer.

   Um ponto azul aparece ao lado dos elementos do mapa com estilos personalizados. Se você personalizar um estilo filho, o estilo pai vai mostrar um círculo azul. Para mais informações sobre a hierarquia de estilos de mapa, consulte Entenda a hierarquia e a herança do estilo de mapa.

   Observação:alguns estilos não aparecem em todos os níveis de zoom. Para mais informações, consulte Estilizar níveis de zoom.

7. Clique em Salvar.

8. Na caixa Salvar e publicar estilo de mapa, insira um nome e, se quiser, uma descrição para o estilo. Depois, clique em Salvar.

O estilo é publicado automaticamente, e a página de detalhes dele aparece.

Atenção: fazer mudanças no estilo sem salvar explicitamente cria alterações não salvas no histórico de versões do estilo de mapa. Essas versões são perdidas quando você fecha a guia do navegador ou quando a sessão do console do Cloud termina.

Copiar um estilo

1. Acesse Estilos de mapa e selecione um projeto, se necessário.

2. Selecione uma das opções.

3. Na página de estilo, clique em Fazer uma cópia.

4. Na caixa de diálogo Fazer uma cópia, insira um nome e, se quiser, uma descrição para o novo estilo de mapa.

5. (Opcional) Para criar a versão complementar do modo claro ou escuro do estilo copiado, marque a caixa de seleção na seção Opções do modo de estilo.

6. Clique em Salvar.

   O novo estilo é publicado automaticamente, e a página principal dele aparece. Associe o estilo a um ID do mapa para usá-lo nos seus mapas. Para mais detalhes, consulte Associar um ID do mapa a um estilo de mapa.

7. Se quiser modificar o estilo, clique em Personalizar, faça as mudanças e clique em Salvar.

Publicar um estilo

Quando você cria um estilo de mapa pela primeira vez, a primeira instância dele é publicada automaticamente. Depois disso, você salva as mudanças como rascunho e, quando achar que está tudo pronto, publica.

1. Faça as mudanças no estilo de mapa ou no estilo duplicado. Para mais detalhes, consulte Alterar um estilo.

2. Clique em Salvar para salvar as mudanças como rascunho.

3. Quando estiver tudo pronto para publicar e aplicar as alterações nos IDs de mapa que usam esse estilo de mapa, clique em Publicar.

Estilos de mapa publicados x rascunhos

Publicados: quando um estilo de mapa está ativo. Todos os mapas que usam esse estilo de mapa mostram a versão publicada dele.

Observação: as alterações podem levar algumas horas para aparecer nos apps e sites. Nos aplicativos, esse tempo pode ser maior se os dispositivos não estão conectados à Internet. Se, depois de algumas horas, as mudanças no estilo ainda não tiverem sido publicadas, confira o artigo Minhas mudanças de estilo não são atualizadas.

Rascunho: versões em rascunho de um estilo de mapa estão em desenvolvimento e não aparecem nos mapas até serem publicadas.

Alterar um estilo

Para fazer mudanças em um estilo de mapa, use o editor. Você tem algumas opções disponíveis ao atualizar um estilo:

• Se quiser publicar as alterações assim que terminar: clique em Personalizar e faça as mudanças. Clique em Salvar para salvar as mudanças como rascunho e clique em Publicar quando estiver tudo pronto.

• Se quiser conferir as alterações em um ambiente de teste: em vez de fazer as mudanças diretamente no estilo de mapa, duplique o estilo primeiro. Para mais detalhes, consulte Copiar um estilo e Testar atualizações de estilo de mapa.

Depois de criar um estilo de mapa, é possível fazer mudanças na página de detalhes dele das seguintes maneiras:

• Editar: clique em Personalizar.

• Fazer uma cópia: para mais detalhes, consulte Copiar um estilo.

• Renomear: dê outro nome ao estilo de mapa.

• Excluir: remova o estilo de mapa.

Associar seu estilo a um ID do mapa

Associe seu estilo a um ID de mapa para mostrar o estilo personalizado no site e no app. Um ID de mapa pode ter apenas um estilo de modo claro e um estilo de modo escuro associados a ele.

Para mudar os estilos associados a um ID do mapa, faça o seguinte no console do Google Cloud:

1. Acesse Gerenciamento de mapas e selecione um ID.

2. Na seção Estilos de mapa, clique em Editar para o modo claro ou escuro.

3. No painel, selecione um estilo para associar a esse ID do mapa.

   Observação: o painel mostra apenas estilos com um tipo claro para o modo claro e apenas estilos com um tipo escuro para o modo escuro.

4. Clique em Concluído.

5. (Opcional) Aplique o estilo a diferentes tipos de mapa.

   Por padrão, seu estilo é aplicado a todos os tipos de mapa disponíveis (roadmap, navigation, terrain, hybrid, 3D roadmap, 3D hybrid). Para aplicar seu estilo a tipos de mapa específicos, clique em Mostrar mais e marque a caixa de seleção de cada tipo de mapa listado para os modos claro e escuro. Para aplicar o estilo de mapa padrão do Google para esse modo, desmarque a caixa de seleção de um tipo de mapa.

   Para mais informações sobre tipos de mapa, consulte Aprenda Mais sobre modos e tipos de mapa.

6. Clique em Salvar para aplicar todas as mudanças.

Para usar a Estilização de mapas baseada na nuvem, adicione o ID do mapa ao seu app.