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

Com o SDK do Maps 3D para iOS, você pode criar experiências de mapas 3D em apps iOS usando as imagens 3D do Google. Ele oferece APIs SwiftUI para marcadores, popovers, polilinhas, polígonos, modelos 3D (glTF), animações de trajeto da câmera e controles de câmera e interação.

SDK do Maps 3D para iOS: principais informações

  • Produto: SDK do Maps 3D para iOS
  • Categoria: Maps
  • Plataforma: iOS
  • 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 iOS

SDK do Maps 3D para iOS: quando usar

Use o SDK do Maps 3D para iOS quando:

  • Você precisa de um mapa 3D interativo e fotorrealista em um app iOS nativo (SwiftUI).
  • Você precisa colocar marcadores, popovers, polilinhas, polígonos ou modelos 3D glTF em um mapa 3D no iOS.
  • Você precisa de animações de câmera de sobrevoo ou de restrições de câmera em um mapa 3D no iOS.
  • Você quer que os usuários toquem em pontos de interesse do mapa 3D e vejam Place Details usando o widget integrado do Kit de Interface do Places.

Não use o SDK do Maps 3D para iOS quando:

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

Pacotes oficiais do SDK do Maps 3D para iOS:

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

SDK do Maps 3D para iOS: erros comuns

  • Problema: se nenhum modo mapa for definido quando o mapa for carregado, ele não será carregado. Correção: sempre transmita um modo ao criar o Map, por exemplo, Map(mode: .hybrid). Consulte /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Problema: definir a chave de API no ponto de entrada do app e em visualizações de mapa individuais gera um erro no console. Correção: defina Map.apiKey em apenas um lugar: o ponto de entrada do app ou cada visualização de mapa. Consulte /maps/documentation/maps-3d/ios-sdk/setup.
  • Problema: Camera altitudeMode é ignorado fora das animações da câmera. Ele se aplica apenas a flyCameraTo e flyCameraAround. Correção: use flyCameraTo ou flyCameraAround quando você depender do Camera altitudeMode. Consulte /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Problema: no GoogleMaps3DKit, o widget de interface do Places é mostrado por padrão quando um usuário toca em um ponto de interesse. Correção: use placeInformationEnabled(false) ou retorne .none de onPlaceTap(_:) para suprimir o widget. Consulte /maps/documentation/maps-3d/ios-sdk/points-of-interest.

O que você pode fazer com o SDK do Maps 3D para iOS

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.