Saiba mais sobre modos e tipos de mapa

Selecione a plataforma: Android iOS JavaScript Web Service

Este produto ou recurso está em pré-lançamento (pré-GA). Os produtos e recursos em pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. Todos os itens em pré-GA são cobertos pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

Este documento descreve a relação conceitual entre estilos personalizados e modos claro e escuro, além de definir os diferentes tipos de mapa e como aplicar seus estilos a eles.

Para começar a usar estilos personalizados, consulte Criar um novo estilo.

Entender os modos claro e escuro

É possível criar dois estilos distintos para um único ID do mapa: um otimizado para planos de fundo claros e outro para planos de fundo escuros. Os mapas para planos de fundo claros usam um mapa de base diferente dos mapas para planos de fundo escuros. Portanto, não é possível usar um estilo para os dois modos.

Os estilos de modo claro e escuro oferecem o mapa estilizado mais adequado para diferentes ambientes. Quando você usa o ID do mapa nos seus aplicativos, ele pode carregar o estilo apropriado com base no comportamento programado ou nas configurações do dispositivo do usuário.

Escolher o modo claro ou escuro ao criar um estilo

Você escolhe o modo claro ou escuro ao criar ou copiar um estilo. Não é possível mudar o modo de um estilo depois da criação.

Você pode conferir o tipo de estilo na página de detalhes do estilo.

Para instruções detalhadas sobre como criar estilos personalizados, consulte Criar e usar estilos de mapa.

Associar um estilo de modo claro e um estilo de modo escuro a um ID de mapa

Um ID de mapa oferece suporte a apenas um estilo de modo claro e um estilo de modo escuro. Quando você clica no Editar ícone para mudar um estilo de modo claro ou escuro, o painel mostra apenas os estilos desse modo. Para saber mais, consulte Associar seu estilo a um ID de mapa.

Entender como os estilos personalizados são aplicados a vários tipos de mapa

A Plataforma Google Maps oferece diferentes tipos de mapa para atender a vários casos de uso, incluindo roadmap, navigation, hybrid, terrain, 3D roadmap e 3D hybrid. O nível de personalização depende se o mapa é baseado apenas em dados vetoriais (como roadmap, navigation e 3D roadmap), usa uma combinação de dados vetoriais e imagens rasterizadas (como terrain e hybrid) ou usa uma combinação de imagens rasterizadas, polígonos 3D e imagens vetoriais (como 3D hybrid).

Mapas de dados vetoriais

Os tipos de mapa roadmap, navigation e 3D roadmap usam apenas dados vetoriais, o que permite estilizar de forma abrangente a maioria dos elementos do mapa, incluindo polígonos para terra e água, vias, pontos de referência e pontos de interesse.

Mapas de imagens rasterizadas

Os tipos de mapa terrain, hybrid e 3D hybrid usam imagens rasterizadas com dados vetoriais na parte de cima. Como resultado, os recursos de estilo são limitados. Geralmente, só é possível estilizar dados vetoriais que são sobrepostos à imagem, como rótulos, marcadores e algumas polilinhas (como vias e fronteiras). Não é possível personalizar elementos que fazem parte da imagem de base.

Por exemplo, a imagem abaixo mostra um estilo com um tema azul. A água é estilizada mais escura do que o padrão, e uma paleta azul é aplicada a vias, áreas externas e POIs. Ao visualizar o estilo em híbrido e híbrido 3D, a água e as áreas externas não ficam azuis, mas as vias e os POIs ainda são estilizados.

Observação: Para apps JavaScript que usam o tipo de mapa terrain, é possível aplicar estilos personalizados aos blocos rasterizados de base. Nesta imagem de exemplo, a terra e a água aparecem em rosa. Mostrar imagem.

Definições de tipo de mapa e suporte ao modo

A tabela a seguir define os tipos de mapa e mostra quais deles oferecem suporte aos modos claro e escuro.

Tipo de mapa	Descrição	Imagens do mapa de base	Suporte ao modo
roadmap	Uma visualização de mapa padrão que mostra vias e principais elementos.	Vetor	Modo claro e escuro
navigation	Um tipo de mapa especializado otimizado para navegação guiada usando o SDK de navegação. Para mais informações sobre navegação, consulte a visão geral de estilos de mapa personalizados para o SDK de navegação para Android e o SDK de navegação para iOS.	Vetor	Modo claro e escuro
terrain	Um mapa que enfatiza elementos físicos do terreno, como montanhas, rios e elevação.	Vetor e rasterizado	Modo claro e escuro
hybrid	Uma combinação de imagens de satélite e dados de mapa de vias, mostrando nomes de ruas e outros elementos importantes sobrepostos à imagem.	Vetor e rasterizado	Somente modo claro
3D roadmap	Um mapa 3D padrão que mostra vias e principais elementos. Esse tipo de mapa só está disponível em mapas 3D na API Maps JavaScript.	Vetor	Somente modo claro
3D hybrid	Um mapa 3D fotorrealista em que é possível estilizar a visibilidade de rótulos de pontos de interesse vias e placas de trânsito. Esse tipo de mapa só está disponível em mapas 3D na API Maps JavaScript.	Vetor e rasterizado	Somente modo claro

Considerações de estilo para mapas de imagens rasterizadas

Ao estilizar os tipos de mapa terrain, 2D hybrid, 3D hybrid e 3D roadmap, você pode encontrar os seguintes comportamentos:

• Ao usar estilos personalizados no Android e no iOS com o tipo de mapa terrain, a água pode piscar temporariamente. Esse comportamento esperado ocorre ao estilizar a água porque os blocos de mapa de vias são carregados após os blocos de terreno. Esse carregamento atrasado causa um breve conflito visual nas cores personalizadas.

• Os estilos de polígono podem ocluir elementos de mapa subjacentes nos tipos de mapa terrain, 2D hybrid e 3D hybrid. Por exemplo, um polígono de parque estilizado em um mapa de terreno pode ocultar elementos sutis do terreno. Em mapas híbridos, ele pode ocultar as imagens de satélite subjacentes.

• Para 3D hybrid, as polilinhas de vias podem ser renderizadas abaixo de pontes ou aparecer incorretamente em viadutos e passagens subterrâneas.

• Para os tipos de mapa 3D roadmap e 3D hybrid, não é possível modificar as configurações do mapa para controlar a densidade de pontos de interesse, o estilo de edifícios, o estilo de pontos de referência e a cor de plano de fundo do app.

Visualizar seus estilos em cada tipo de mapa

Depois de criar seus estilos personalizados, teste-os nos diferentes tipos de mapa para ver como eles são aplicados. Isso é especialmente importante porque nem todos os estilos são aplicados a todos os tipos de mapa.

No console do Google Cloud, é possível visualizar seus estilos personalizados no editor de estilo ou na página de detalhes do mapa, da seguinte maneira:

• Editor de estilo: no painel de contexto, selecione a lista suspensa Map type e mude o tipo de mapa. O mapa é atualizado e mostra o tipo de mapa com o estilo aplicado.
• Página de detalhes do mapa:na seção Visualização do mapa, é possível alternar entre estilos de modo claro e escuro e mudar a variante na lista suspensa para diferentes tipos de mapa. É necessário associar seu estilo ao ID do mapa antes de poder visualizá-lo.

Observações:

• Como o tipo de mapa terrain usa uma combinação de componentes rasterizados e vetoriais, o mapa de visualização pode não refletir todas as mudanças de estilo em terrain, como acontece com o tipo de mapa roadmap.
• Não é possível visualizar seus estilos personalizados para 3D roadmap e 3D hybrid tipos de mapa no editor de estilo e na página de detalhes do mapa.

Aplicar seus estilos personalizados a vários tipos de mapa

Na página de detalhes do mapa, depois de associar os estilos de modo claro e escuro ao ID do mapa, clique em Mostrar mais para escolher se quer aplicar seus estilos personalizados a vários tipos de mapa. É possível verificar mais uma vez como o estilo é aplicado aos tipos de mapa na seção Visualização do mapa.