Referência rápida do SDK do Maps 3D para Android

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 ROADMAP neste SDK é experimental). Use o SDK do Maps para Android.

SDK do Maps 3D para Android: configuração

Pacotes oficiais do SDK do Maps 3D para Android:

  • maven: com.google.android.gms:play-services-maps3d

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, HYBRID ou ROADMAP) no XML de layout (map3d:mapMode) ou com setMapMode/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 um Map3DView ativo, chame onDestroy() na instância antiga, limpe manualmente os marcadores e as sobreposições e redefina a câmera usando GoogleMap3D. 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 true de onMap3DClick em OnMap3DClickListener para 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.