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:
- Você precisa de um mapa 3D em um app Android. Use o SDK do Maps 3D para Android.
- Você precisa de um mapa 3D em uma página da Web. Use a API Maps JavaScript.
- Você precisa de um mapa 2D padrão em um app iOS. Use o SDK do Maps para iOS.
SDK do Maps 3D para iOS: configuração
- Serviço a ser ativado:
mapsios.googleapis.com - Autenticação: chave de API
- Começar: configurar o SDK do Maps 3D para iOS
- Referência: Referência do SDK do Maps 3D para iOS
- Preços: uso e faturamento do SDK do Maps 3D para iOS
- Políticas: Políticas do SDK do Maps 3D para iOS
- Notas da versão: notas da versão do SDK do Maps 3D para iOS
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: produtos relacionados
- Costuma ser usado com: SDK do Places para iOS
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.apiKeyem apenas um lugar: o ponto de entrada do app ou cada visualização de mapa. Consulte /maps/documentation/maps-3d/ios-sdk/setup. - Problema:
CameraaltitudeModeé ignorado fora das animações da câmera. Ele se aplica apenas aflyCameraToeflyCameraAround. Correção: useflyCameraToouflyCameraAroundquando você depender doCameraaltitudeMode. 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: useplaceInformationEnabled(false)ou retorne.nonedeonPlaceTap(_:)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.
- 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.