Riferimento rapido di Maps 3D SDK for iOS

Maps 3D SDK per iOS ti consente di creare esperienze di mappe 3D nelle app per iOS utilizzando le immagini 3D di Google. Fornisce API SwiftUI per indicatori, popover, polilinee, poligoni, modelli 3D (glTF), animazioni dei percorsi della fotocamera e controlli della fotocamera e dell'interazione.

SDK Maps 3D per iOS: informazioni chiave

  • Prodotto: SDK Maps 3D per iOS
  • Category: Maps
  • Piattaforma: iOS
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica dell'SDK Maps 3D per iOS

SDK Maps 3D per iOS: quando utilizzarlo

Utilizza Maps 3D SDK for iOS quando:

  • Hai bisogno di una mappa 3D interattiva e fotorealistica in un'app per iOS nativa (SwiftUI).
  • Devi posizionare indicatori, popover, polilinee, poligoni o modelli 3D glTF su una mappa 3D in iOS.
  • Hai bisogno di animazioni della videocamera con volo verso o intorno a un punto o di limitazioni della videocamera su una mappa 3D in iOS.
  • Devi consentire agli utenti di toccare i punti d'interesse della mappa 3D e visualizzare i Place Details tramite il widget Places UI Kit integrato.

Non utilizzare Maps 3D SDK for iOS quando:

SDK Maps 3D per iOS: configurazione

Pacchetti SDK Maps 3D per iOS ufficiali:

  • 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 Maps 3D per iOS: errori comuni

  • Problema: se non viene impostata alcuna modalità mappa al caricamento della mappa, quest'ultima non viene caricata. Correzione: passa sempre una modalità durante la creazione di Map, ad esempio Map(mode: .hybrid). Consulta /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Problema: l'impostazione della chiave API sia nell'entry point dell'app sia nelle singole visualizzazioni mappa genera un errore della console. Correzione: imposta Map.apiKey in un solo punto, ovvero il punto di accesso dell'app o ogni visualizzazione mappa. Consulta /maps/documentation/maps-3d/ios-sdk/setup.
  • Problema: Camera altitudeMode viene ignorato al di fuori delle animazioni della fotocamera; si applica solo a flyCameraTo e flyCameraAround. Correzione: utilizza flyCameraTo o flyCameraAround quando dipendi da Camera altitudeMode. Consulta /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Problema: in GoogleMaps3DKit, il widget UI di Places viene visualizzato per impostazione predefinita quando un utente tocca un punto d'interesse. Correzione: utilizza placeInformationEnabled(false) o restituisci .none da onPlaceTap(_:) per eliminare il widget. Consulta /maps/documentation/maps-3d/ios-sdk/points-of-interest.

Cosa puoi fare con Maps 3D SDK for iOS

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.