Aggiungere una mappa

Le mappe sono rappresentate nell'API dalla classe GMSMapView, una sottoclasse di UIView. La mappa è l'oggetto più significativo in Maps SDK for iOS e fornisce i metodi necessari per aggiungere, rimuovere e gestire altri oggetti come i marcatori e le polilinee.

Introduzione

Maps SDK for iOS ti consente di visualizzare una mappa di Google nella tua applicazione per iOS. Queste mappe hanno lo stesso aspetto di quelle visualizzate nell'app iOS Google Maps e l'SDK espone molte delle stesse funzionalità.

Oltre alla funzionalità di mappatura, l'API supporta anche una serie di interazioni coerenti con il modello di interfaccia utente di iOS. Ad esempio, puoi impostare le interazioni con una mappa definendo i comandi che reagiscono ai gesti dell'utente, come tocco e doppio tocco.

La classe chiave quando si lavora con un oggetto Map è la classe GMSMapView. GMSMapView gestisce automaticamente le seguenti operazioni:

• Connessione al servizio Google Maps.
• Download dei riquadri della mappa.
• Visualizzazione dei riquadri sullo schermo del dispositivo.
• Visualizzazione di vari controlli, come panoramica e zoom.
• Rispondere ai gesti di panoramica e zoom spostando la mappa e aumentando o diminuendo lo zoom.
  • Rispondere ai gesti con due dita inclinando l'angolo di visualizzazione della mappa.

Oltre a queste operazioni automatiche, puoi controllare il comportamento e l'aspetto della mappa tramite le proprietà e i metodi esposti dalla classe GMSMapView. GMSMapView ti consente di aggiungere e rimuovere indicatori, overlay del terreno e polilinee, modificare il tipo di mappa visualizzato e controllare cosa viene mostrato sulla mappa tramite la classe GMSCameraPosition.

Creare mappe con SwiftUI

SwiftUI offre un modo aggiuntivo per creare l'interfaccia utente utilizzando un approccio dichiarativo. Devi solo dire a SwiftUI come vuoi che sia la tua visualizzazione e tutti i diversi stati, e il sistema fa il resto. SwiftUI gestisce l'aggiornamento della visualizzazione ogni volta che lo stato sottostante cambia a causa di un evento o di un'azione dell'utente.

Maps SDK for iOS è basato su UIKit e non fornisce una visualizzazione compatibile con SwiftUI. L'aggiunta di mappe in SwiftUI richiede la conformità a UIViewRepresentable o UIViewControllerRepresentable. Per saperne di più, consulta il Codelab Aggiunta di una mappa all'app per iOS con SwiftUI.

Aggiunta di una mappa

I passaggi di base per aggiungere una mappa sono:

1. Per ottenere l'SDK, una chiave API e aggiungere i framework richiesti, segui la procedura descritta in:

   1. Configurazione nella console Google Cloud

   2. Utilizzare una chiave API

   3. Configurare un progetto Xcode

   4. In AppDelegate, fornisci la tua chiave API al metodo della classe provideAPIKey: su GMSServices.

   5. Crea o aggiorna un ViewController. Se la mappa viene visualizzata quando questo view controller diventa visibile, assicurati di crearla all'interno del metodo viewDidLoad.

   6. Quando avvii la visualizzazione della mappa, imposta le opzioni di configurazione con GMSMapViewOptions. Le proprietà includono frame, camera, mapID,backgroundColor o screen.

   7. Imposta la proprietà camera Opzioni mappa con un oggetto GMSCameraPosition. Questo specifica il centro e il livello di zoom della mappa.

   8. Crea e crea un'istanza di una classe GMSMapView utilizzando il metodo GMSMapView options:. Se questa mappa deve essere utilizzata come única vista del visualizzatore, il valore predefinito dell'opzione mappa frame di CGRectZero può essere utilizzato come vista frame: la mappa viene ridimensionata automaticamente.

   9. Imposta l'oggetto GMSMapView come vista del controller della vista. Ad esempio, self.view = mapView;.

L'esempio riportato di seguito aggiunge una mappa, centrata sul centro di Singapore, a un'app.

import GoogleMaps

class MapObjects : UIViewController {
  override func viewDidLoad() {
    super.viewDidLoad()

    let options = GMSMapViewOptions()
    options.camera = GMSCameraPosition(latitude: 1.285, longitude: 103.848, zoom: 12)
    options.frame = self.view.bounds;

    let mapView = GMSMapView(options:options)
    self.view = mapView
  }
}

- (void)viewDidLoad {
  [super viewDidLoad];

  GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
  options.camera = [GMSCameraPosition cameraWithLatitude:1.285
                                                        longitude:103.848
                                                             zoom:12];
  options.frame = self.view.bounds;

  GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
  self.view = mapView;
}

Dopo aver seguito questi passaggi, puoi configurare ulteriormente l'oggetto GMSMapView.

Passaggi successivi

Dopo aver completato questi passaggi, puoi configurare le impostazioni della mappa.