Criar e usar estilos de mapa

Selecione a plataforma: Android iOS JavaScript Web Service

Os recursos neste documento marcados com o ícone de ciência estão em pré-lançamento (pré-GA).

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 antes de ter um ID, mas, para usar esse estilo, você precisa associá-lo a um ID de mapa. Também é 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. Associar o estilo a um ID do mapa. Para mais detalhes, consulte Associar um ID do mapa a um estilo.

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 sem precisar alterar esse código. Além disso, seus usuários finais não precisam fazer upgrade para acessar os estilos atualizados. Em vez disso, você edita o estilo 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.

• 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 externos.
   • Escuro cria um estilo com tema escuro, ideal para ambientes com pouca luz.

   Para mais informações sobre os estilos do modo claro e escuro, consulte Saiba mais sobre modos e tipos de mapa.

4. (Opcional) Para aplicar a variação monocromática ao estilo do mapa, selecione Monocromático.

   Ou 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 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 do 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 novo 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 novo nome e, se quiser, uma descrição para o 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 de 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.

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, salve as mudanças como rascunho e publique quando achar que está tudo pronto.

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

2. Clique em Salvar para armazenar as mudanças como um rascunho.

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

Estilos de mapa publicados x rascunhos

Publicados: quando um estilo de mapa está ativo. Todos os mapas que usam esse estilo 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 em Publicar quando estiver tudo pronto.

• Se quiser conferir as alterações em um ambiente de teste: em vez de fazer as mudanças no estilo, duplique-o 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 de modo escuro associado a ele.

Para mudar os estilos associados a um ID de 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 de estilo claro para o modo claro e apenas estilos com um tipo de estilo escuro para o modo escuro.

4. Clique em Concluído.

5. (opcional) Aplique seu estilo a diferentes tipos de mapa.

   Por padrão, seu estilo é aplicado a todos os tipos de mapa disponíveis (roadmap, terrain, hybrid, navigation). Para aplicar seu estilo a tipos específicos de mapa, 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 padrão do Google Maps a esse modo, desmarque a caixa de seleção de um tipo de mapa.

   Para mais informações sobre tipos de mapa, consulte Saiba 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.