Com o SDK do Maps 3D para Android, os apps Android podem mostrar mapas 3D interativos criados com as imagens 3D do Google. Ela oferece marcadores, popovers, polilinhas, polígonos, modelos 3D glTF, animações de trajeto da câmera e controles para interação do usuário e movimento da câmera.
SDK do Maps 3D para Android: principais fatos
- Produto: SDK do Maps 3D para Android
- Também conhecido como: SDK do Maps 3D para Android
- Categoria: Maps
- Plataforma: Android
- Executado em: cliente (código do app ou do navegador)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral do SDK do Maps 3D para Android
- Disponibilidade regional: limitada. A disponibilidade varia de acordo com o país e a região. Consulte a coluna "Maps 3D (JavaScript, Android, iOS)" na página de cobertura da Plataforma Google Maps. (detalhes da cobertura)
SDK do Maps 3D para Android: quando usar
Use o SDK do Maps 3D para Android quando:
- Você precisa mostrar um mapa 3D interativo e fotorrealista de locais do mundo real em um app Android.
- Você precisa de marcadores, popovers, polilinhas, polígonos ou modelos glTF 3D em um mapa 3D em um app Android.
- Você precisa de animações de câmera predefinidas (sobrevoo, rotação) que guiem os usuários entre pontos em um mapa 3D.
- Você precisa controlar quais movimentos de câmera e controles de interface os usuários podem usar em um mapa 3D em um app Android.
Não use o SDK do Maps 3D para Android quando:
- Você está criando um app da Web que precisa de mapas em 3D. Use a API Maps JavaScript.
- Você está criando um app iOS que precisa de mapas 3D. Use o SDK do Maps 3D para iOS.
- Você precisa de um mapa de ruas 2D padrão pronto para produção em um app Android (o modo
ROADMAPneste SDK é experimental). Use o SDK do Maps para Android.
SDK do Maps 3D para Android: configuração
- Serviço a ser ativado:
mapsandroid.googleapis.com - Autenticação: chave de API
- Começar: configurar o SDK do Maps 3D para Android
- Referência: referência do SDK do Maps 3D para Android
- Preços: uso e faturamento do SDK do Maps 3D para Android
- Políticas: políticas do SDK do Maps 3D para Android
- Notas da versão: notas da versão do SDK do Maps 3D para Android
Pacotes oficiais do SDK do Maps 3D para Android:
- maven:
com.google.android.gms:play-services-maps3d
SDK do Maps 3D para Android: produtos relacionados
- Costuma ser usado com: SDK do Places para Android
SDK do Maps 3D para Android: erros comuns
- Problema: se o modo mapa não for especificado quando o mapa for carregado, ele não será carregado. Correção: sempre defina um
Map3DMode(SATELLITE,HYBRIDouROADMAP) no XML de layout (map3d:mapMode) ou comsetMapMode/Map3DInitConfig. Consulte /maps/documentation/maps-3d/android-sdk/map-modes. - Problema: os listeners de cliques (no mapa e no marcador) não são executados na linha de execução principal da interface. Por isso, as atualizações diretas da interface pelo gerenciador falham. Correção: mude para a linha de execução principal antes de atualizar a interface, por exemplo, com
lifecycleScope.launch(Dispatchers.Main). Consulte /maps/documentation/maps-3d/android-sdk/add-a-marker. - Problema: o estado do mapa é compartilhado entre as instâncias de
Map3DView. Por isso, os marcadores, as sobreposições e a posição da câmera de uma visualização antiga são transferidos para uma nova. Correção: mantenha apenas umMap3DViewativo, chameonDestroy()na instância antiga, limpe manualmente os marcadores e as sobreposições e redefina a câmera usandoGoogleMap3D. Consulte /maps/documentation/maps-3d/android-sdk/add-a-3d-map. - Problema: por padrão, tocar em um ponto de interesse do mapa básico mostra o widget da interface do Places, que também requer a dependência do SDK do Places. Correção: adicione a dependência do SDK do Places para Android e retorne
truedeonMap3DClickemOnMap3DClickListenerpara suprimir o widget padrão, se não quiser usá-lo. Consulte /maps/documentation/maps-3d/android-sdk/points-of-interest.
O que você pode fazer com o SDK do Maps 3D para Android
Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
- Adicione um mapa 3D interativo e fotorrealista a uma página da Web.
- Adicionar um marcador a um mapa 3D fotorrealista.
- Personalizar um marcador em um mapa 3D fotorrealista.
- Adicionar um modelo 3D a um mapa 3D fotorrealista.
- Adicionar uma polilinha 3D a um mapa 3D fotorrealista.
- Adicionar um polígono 3D a um mapa 3D fotorrealista.
- Responda a interações e eventos do usuário em um mapa 3D fotorrealista.
- Personalize os controles que aparecem em um mapa 3D fotorrealista.
- Controlar o trajeto da câmera e as animações em um mapa 3D fotorrealista.
- Controlar as restrições da câmera em um mapa 3D fotorrealista.