Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Seleziona il luogo attuale e mostra i dettagli su una mappa

Questo tutorial ti mostra come creare un'app per iOS per:

  • Trova la posizione attuale del dispositivo.
  • Visualizzare un elenco di luoghi in cui è probabile che il dispositivo si trovi.
  • Mostra all'utente la corrispondenza migliore.
  • Mostra un indicatore sulla mappa.

Segui questo tutorial per creare un'app per iOS utilizzando l'SDK Places per iOS, l'SDK Maps per iOS e l'Apple Core Location Framework.

Ricezione del codice

Clona o scarica l'SDK di Google Maps per iOS da GitHub.

Configurazione del progetto di sviluppo

Per installare l'SDK Places per iOS e l'SDK Maps per iOS, procedi nel seguente modo:

  1. Scarica e installa Xcode 13.0 o versioni successive.
  2. Se non hai ancora CocoaPods, installalo su macOS eseguendo questo comando dal terminale: 
    sudo gem install cocoapods
  3. Nella directory in cui hai salvato il repository di esempio (Get the code), vai alla directory tutorials/current-place-on-map.
  4. Esegui il comando pod install. Vengono installate le API specificate in Podfile, insieme a eventuali dipendenze.
  5. Esegui pod outdated per confrontare la versione del pod installata con nuovi aggiornamenti. Se viene rilevata una nuova versione, esegui pod update per aggiornare Podfile e installare l'SDK più recente. Per ulteriori dettagli, consulta la CocoaPods Guide.
  6. Apri (fai doppio clic) sull'attuale-posizione-sulla-mappa.xcworkspace del progetto per aprirlo in Xcode. Devi utilizzare il file .xcworkspace per aprire il progetto.

Per istruzioni dettagliate sull'installazione, consulta la pagina Introduzione (Maps) e Guida introduttiva (Luoghi).

Abilitare le API necessarie e ottenere una chiave API

Per completare questo tutorial, hai bisogno di una chiave API di Google autorizzata a utilizzare l'SDK Maps per iOS e l'API Places.

  1. Segui le istruzioni riportate in Inizia a utilizzare Google Maps Platform per configurare un account di fatturazione e un progetto abilitato per entrambi questi prodotti.
  2. Segui le istruzioni su Ottieni una chiave API per creare una chiave API per il progetto di sviluppo configurato in precedenza.

Aggiunta della chiave API alla tua applicazione

Aggiungi la chiave API al tuo AppDelegate.swift come segue:

  1. Tieni presente che è stata aggiunta la seguente istruzione di importazione al file: 
    import GooglePlaces
import GoogleMaps
  2. Modifica la seguente riga nel metodo application(_:didFinishLaunchingWithOptions:), sostituendo YOUR_API_KEY con la chiave API: 
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
GMSServices.provideAPIKey("YOUR_API_KEY")

Creare ed eseguire la tua app

  1. Collega un dispositivo iOS al computer oppure seleziona un simulatore dal menu popup dello schema Xcode.
  2. Se utilizzi un dispositivo, assicurati che i servizi di geolocalizzazione siano abilitati. Se utilizzi un simulatore, seleziona una posizione dal menu Funzionalità.
  3. In Xcode, fai clic sull'opzione di menu Product/Run (Prodotto/Esegui) o sull'icona del pulsante di riproduzione.
    • Xcode crea l'app, quindi la esegue sul dispositivo o sul simulatore.
    • Dovresti vedere una mappa con una serie di indicatori centrati sulla posizione attuale.

Risoluzione dei problemi:

  • Se non vedi la mappa, verifica di avere una chiave API e la aggiungi all'app, come descritto in precedenza. Controlla la console di debug di Xcode per verificare se sono presenti messaggi di errore relativi alla chiave API.
  • Se hai limitato la chiave API in base all'identificatore bundle iOS, modifica la chiave per aggiungere l'identificatore bundle per l'app: com.google.examples.current-place-on-map.
  • La mappa non verrà visualizzata correttamente se la richiesta di autorizzazioni per i servizi di geolocalizzazione viene rifiutata.
    • Se stai utilizzando un dispositivo, vai a Impostazioni/Generali/Privacy/Servizi di geolocalizzazione e riattiva i servizi di geolocalizzazione.
    • Se utilizzi un simulatore, vai a Simulatore/Reimposta contenuti e impostazioni...
    La prossima volta che l'app viene eseguita, assicurati di accettare la richiesta dei servizi di geolocalizzazione.
  • Assicurati di avere una buona connessione Wi-Fi o GPS.
  • Se l'app viene avviata, ma non viene visualizzata alcuna mappa, assicurati di aver aggiornato l'info.plist per il progetto con le autorizzazioni di accesso alla posizione appropriate. Per scoprire di più sulla gestione delle autorizzazioni, consulta la guida per richiedere l'autorizzazione di accesso alla posizione nella tua app di seguito.
  • Utilizza gli strumenti di debug Xcode per visualizzare i log ed eseguire il debug dell'app.

Nozioni di base sul codice

Questa parte del tutorial illustra le parti più significative dell'app current-place-on-map, per aiutarti a capire come creare un'app simile.

L'app current-place-on-map include due controller di visualizzazione: uno per visualizzare una mappa che mostra il luogo attualmente selezionato dall'utente, uno per mostrare all'utente un elenco di luoghi probabili tra cui scegliere. Tieni presente che ogni controller di visualizzazione ha le stesse variabili per monitorare l'elenco dei luoghi probabili (likelyPlaces) e per indicare la selezione dell'utente (selectedPlace). Il passaggio tra le visualizzazioni viene eseguito utilizzando segues.

Richiesta dell'autorizzazione di accesso alla posizione

La tua app deve chiedere all'utente il consenso per utilizzare i servizi di geolocalizzazione. Per farlo, includi la chiave NSLocationAlwaysUsageDescription nel file Info.plist per l'app e imposta il valore di ogni chiave su una stringa che descriva il modo in cui l'app utilizza i dati sulla posizione.

Configurare il gestore della sede

Usa CLLocationManager per trovare la posizione attuale del dispositivo e per richiedere aggiornamenti regolari quando il dispositivo passa a una nuova posizione. Questo tutorial fornisce il codice necessario per ottenere la posizione del dispositivo. Per maggiori dettagli, consulta la guida Conoscere la località dell'utente nella documentazione per gli sviluppatori Apple.

  1. Dichiara la gestione delle località, la posizione corrente, la visualizzazione mappa, i luoghi del cliente e il livello di zoom predefinito a livello di classe.

    2. Swift

    var locationManager: CLLocationManager!
var currentLocation: CLLocation?
var mapView: GMSMapView!
var placesClient: GMSPlacesClient!
var preciseLocationZoomLevel: Float = 15.0
var approximateLocationZoomLevel: Float = 10.0

    Objective-C

    CLLocationManager *locationManager;
CLLocation * _Nullable currentLocation;
GMSMapView *mapView;
GMSPlacesClient *placesClient;
float preciseLocationZoomLevel;
float approximateLocationZoomLevel;
  2. Inizializza il gestore della località e GMSPlacesClient in viewDidLoad().

    3. Swift

    // Initialize the location manager.
locationManager = CLLocationManager()
locationManager.desiredAccuracy = kCLLocationAccuracyBest
locationManager.requestWhenInUseAuthorization()
locationManager.distanceFilter = 50
locationManager.startUpdatingLocation()
locationManager.delegate = self

placesClient = GMSPlacesClient.shared()

    Objective-C

    // Initialize the location manager.
locationManager = [[CLLocationManager alloc] init];
locationManager.desiredAccuracy = kCLLocationAccuracyBest;
[locationManager requestWhenInUseAuthorization];
locationManager.distanceFilter = 50;
[locationManager startUpdatingLocation];
locationManager.delegate = self;

placesClient = [GMSPlacesClient sharedClient];
  3. Dichiara le variabili per includere l'elenco dei luoghi probabili e del luogo selezionato dell'utente.

    4. Swift

    // An array to hold the list of likely places.
var likelyPlaces: [GMSPlace] = []

// The currently selected place.
var selectedPlace: GMSPlace?

    Objective-C

    // An array to hold the list of likely places.
NSMutableArray<GMSPlace *> *likelyPlaces;

// The currently selected place.
GMSPlace * _Nullable selectedPlace;
  4. Aggiungi delegati per gestire gli eventi per il gestore della sede, utilizzando una clausola di estensione.

    5. Swift

    // Delegates to handle events for the location manager.
extension MapViewController: CLLocationManagerDelegate {

  // Handle incoming location events.
  func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
    let location: CLLocation = locations.last!
    print("Location: \(location)")

    let zoomLevel = locationManager.accuracyAuthorization == .fullAccuracy ? preciseLocationZoomLevel : approximateLocationZoomLevel
    let camera = GMSCameraPosition.camera(withLatitude: location.coordinate.latitude,
                                          longitude: location.coordinate.longitude,
                                          zoom: zoomLevel)

    if mapView.isHidden {
      mapView.isHidden = false
      mapView.camera = camera
    } else {
      mapView.animate(to: camera)
    }

    listLikelyPlaces()
  }

  // Handle authorization for the location manager.
  func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
    // Check accuracy authorization
    let accuracy = manager.accuracyAuthorization
    switch accuracy {
    case .fullAccuracy:
        print("Location accuracy is precise.")
    case .reducedAccuracy:
        print("Location accuracy is not precise.")
    @unknown default:
      fatalError()
    }

    // Handle authorization status
    switch status {
    case .restricted:
      print("Location access was restricted.")
    case .denied:
      print("User denied access to location.")
      // Display the map using the default location.
      mapView.isHidden = false
    case .notDetermined:
      print("Location status not determined.")
    case .authorizedAlways: fallthrough
    case .authorizedWhenInUse:
      print("Location status is OK.")
    @unknown default:
      fatalError()
    }
  }

  // Handle location manager errors.
  func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
    locationManager.stopUpdatingLocation()
    print("Error: \(error)")
  }
}

    Objective-C

    // Delegates to handle events for the location manager.
#pragma mark - CLLocationManagerDelegate

// Handle incoming location events.
- (void)locationManager:(CLLocationManager *)manager didUpdateLocations:(NSArray<CLLocation *> *)locations
{
  CLLocation *location = locations.lastObject;
  NSLog(@"Location: %@", location);

  float zoomLevel = locationManager.accuracyAuthorization == CLAccuracyAuthorizationFullAccuracy ? preciseLocationZoomLevel : approximateLocationZoomLevel;
  GMSCameraPosition * camera = [GMSCameraPosition cameraWithLatitude:location.coordinate.latitude
                                                           longitude:location.coordinate.longitude
                                                                zoom:zoomLevel];

  if (mapView.isHidden) {
    mapView.hidden = NO;
    mapView.camera = camera;
  } else {
    [mapView animateToCameraPosition:camera];
  }

  [self listLikelyPlaces];
}

// Handle authorization for the location manager.
- (void)locationManager:(CLLocationManager *)manager didChangeAuthorizationStatus:(CLAuthorizationStatus)status
{
  // Check accuracy authorization
  CLAccuracyAuthorization accuracy = manager.accuracyAuthorization;
  switch (accuracy) {
    case CLAccuracyAuthorizationFullAccuracy:
      NSLog(@"Location accuracy is precise.");
      break;
    case CLAccuracyAuthorizationReducedAccuracy:
      NSLog(@"Location accuracy is not precise.");
      break;
  }

  // Handle authorization status
  switch (status) {
    case kCLAuthorizationStatusRestricted:
      NSLog(@"Location access was restricted.");
      break;
    case kCLAuthorizationStatusDenied:
      NSLog(@"User denied access to location.");
      // Display the map using the default location.
      mapView.hidden = NO;
    case kCLAuthorizationStatusNotDetermined:
      NSLog(@"Location status not determined.");
    case kCLAuthorizationStatusAuthorizedAlways:
    case kCLAuthorizationStatusAuthorizedWhenInUse:
      NSLog(@"Location status is OK.");
  }
}

// Handle location manager errors.
- (void)locationManager:(CLLocationManager *)manager didFailWithError:(NSError *)error
{
  [manager stopUpdatingLocation];
  NSLog(@"Error: %@", error.localizedDescription);
}

Aggiungere una mappa

Crea una mappa e aggiungila alla vista in viewDidLoad() nel controller principale. La mappa rimane nascosta fino alla ricezione di un aggiornamento della località (gli aggiornamenti alla posizione vengono gestiti nell'estensione CLLocationManagerDelegate).

Swift

// A default location to use when location permission is not granted.
let defaultLocation = CLLocation(latitude: -33.869405, longitude: 151.199)

// Create a map.
let zoomLevel = locationManager.accuracyAuthorization == .fullAccuracy ? preciseLocationZoomLevel : approximateLocationZoomLevel
let camera = GMSCameraPosition.camera(withLatitude: defaultLocation.coordinate.latitude,
                                      longitude: defaultLocation.coordinate.longitude,
                                      zoom: zoomLevel)
mapView = GMSMapView.map(withFrame: view.bounds, camera: camera)
mapView.settings.myLocationButton = true
mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
mapView.isMyLocationEnabled = true

// Add the map to the view, hide it until we've got a location update.
view.addSubview(mapView)
mapView.isHidden = true

Objective-C

// A default location to use when location permission is not granted.
CLLocationCoordinate2D defaultLocation = CLLocationCoordinate2DMake(-33.869405, 151.199);

// Create a map.
float zoomLevel = locationManager.accuracyAuthorization == CLAccuracyAuthorizationFullAccuracy ? preciseLocationZoomLevel : approximateLocationZoomLevel;
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:defaultLocation.latitude
                                                        longitude:defaultLocation.longitude
                                                             zoom:zoomLevel];
mapView = [GMSMapView mapWithFrame:self.view.bounds camera:camera];
mapView.settings.myLocationButton = YES;
mapView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
mapView.myLocationEnabled = YES;

// Add the map to the view, hide it until we've got a location update.
[self.view addSubview:mapView];
mapView.hidden = YES;

Richiesta all'utente di selezionare il luogo corrente

Utilizza l'SDK Places per iOS per ottenere le prime cinque posizioni in base alla posizione attuale dell'utente e presentare l'elenco in un UITableView. Quando l'utente seleziona un luogo, aggiungi un indicatore alla mappa.

  1. Visualizza un elenco di luoghi probabili in cui compilare un elemento UITableView, da cui l'utente può selezionare il luogo in cui si trova attualmente.

    2. Swift

    // Populate the array with the list of likely places.
func listLikelyPlaces() {
  // Clean up from previous sessions.
  likelyPlaces.removeAll()

  let placeFields: GMSPlaceField = [.name, .coordinate]
  placesClient.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: placeFields) { (placeLikelihoods, error) in
    guard error == nil else {
      // TODO: Handle the error.
      print("Current Place error: \(error!.localizedDescription)")
      return
    }

    guard let placeLikelihoods = placeLikelihoods else {
      print("No places found.")
      return
    }

    // Get likely places and add to the list.
    for likelihood in placeLikelihoods {
      let place = likelihood.place
      self.likelyPlaces.append(place)
    }
  }
}

    Objective-C

    // Populate the array with the list of likely places.
- (void) listLikelyPlaces
{
  // Clean up from previous sessions.
  likelyPlaces = [NSMutableArray array];

  GMSPlaceField placeFields = GMSPlaceFieldName | GMSPlaceFieldCoordinate;
  [placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:placeFields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) {
    if (error != nil) {
      // TODO: Handle the error.
      NSLog(@"Current Place error: %@", error.localizedDescription);
      return;
    }

    if (likelihoods == nil) {
      NSLog(@"No places found.");
      return;
    }

    for (GMSPlaceLikelihood *likelihood in likelihoods) {
      GMSPlace *place = likelihood.place;
      [likelyPlaces addObject:place];
    }
  }];
}
  2. Apri una nuova visualizzazione per presentare i luoghi possibili all'utente. Quando l'utente tocca "Ottieni luogo", passiamo a una nuova visualizzazione e mostriamo all'utente un elenco di possibili luoghi tra cui scegliere. La funzione prepare si aggiorna PlacesViewController con l'elenco di posizioni correnti probabili e viene chiamata automaticamente quando viene eseguita una successiva.

    3. Swift

    // Prepare the segue.
override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
  if segue.identifier == "segueToSelect" {
    if let nextViewController = segue.destination as? PlacesViewController {
      nextViewController.likelyPlaces = likelyPlaces
    }
  }
}

    Objective-C

    // Prepare the segue.
- (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender
{
  if ([segue.identifier isEqualToString:@"segueToSelect"]) {
    if ([segue.destinationViewController isKindOfClass:[PlacesViewController class]]) {
      PlacesViewController *placesViewController = (PlacesViewController *)segue.destinationViewController;
      placesViewController.likelyPlaces = likelyPlaces;
    }
  }
}
  3. In PlacesViewController, riempi la tabella utilizzando l'elenco dei luoghi più probabili, utilizzando l'estensione delegato UITableViewDataSource.

    4. Swift

    // Populate the table with the list of most likely places.
extension PlacesViewController: UITableViewDataSource {
  func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
    return likelyPlaces.count
  }

  func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: cellReuseIdentifier, for: indexPath)
    let collectionItem = likelyPlaces[indexPath.row]

    cell.textLabel?.text = collectionItem.name

    return cell
  }
}

    Objective-C

    #pragma mark - UITableViewDataSource

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
  return self.likelyPlaces.count;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
  return [tableView dequeueReusableCellWithIdentifier:cellReuseIdentifier forIndexPath:indexPath];
}
@end
  4. Gestisci la selezione dell'utente utilizzando l'estensione delega UITableViewDelegate.

    5. Swift

    class PlacesViewController: UIViewController {

  // ...

  // Pass the selected place to the new view controller.
  override func prepare(for segue: UIStoryboardSegue, sender: Any?) {
    if segue.identifier == "unwindToMain" {
      if let nextViewController = segue.destination as? MapViewController {
        nextViewController.selectedPlace = selectedPlace
      }
    }
  }
}

// Respond when a user selects a place.
extension PlacesViewController: UITableViewDelegate {
  func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
    selectedPlace = likelyPlaces[indexPath.row]
    performSegue(withIdentifier: "unwindToMain", sender: self)
  }

  // Adjust cell height to only show the first five items in the table
  // (scrolling is disabled in IB).
  func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
    return self.tableView.frame.size.height/5
  }

  // Make table rows display at proper height if there are less than 5 items.
  func tableView(_ tableView: UITableView, heightForFooterInSection section: Int) -> CGFloat {
    if (section == tableView.numberOfSections - 1) {
      return 1
    }
    return 0
  }
}

    Objective-C

    @interface PlacesViewController () <UITableViewDataSource, UITableViewDelegate>
// ...

-(void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender
{

}

#pragma mark - UITableViewDelegate

// Respond when a user selects a place.
-(void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
  self.selectedPlace = [self.likelyPlaces objectAtIndex:indexPath.row];
  [self performSegueWithIdentifier:@"unwindToMain" sender:self];
}

// Adjust cell height to only show the first five items in the table
// (scrolling is disabled in IB).
-(CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath
{
  return self.tableView.frame.size.height/5;
}

// Make table rows display at proper height if there are less than 5 items.
-(CGFloat)tableView:(UITableView *)tableView heightForFooterInSection:(NSInteger)section
{
  if (section == tableView.numberOfSections - 1) {
    return 1;
  }
  return 0;
}

Aggiungere un indicatore alla mappa

Quando l'utente effettua una selezione, utilizza una sequenza di relax per tornare alla visualizzazione precedente e aggiungere l'indicatore alla mappa. unwindToMainL'IBAction viene richiamato automaticamente al ritorno al controller di visualizzazione principale.

Swift

// Update the map once the user has made their selection.
@IBAction func unwindToMain(segue: UIStoryboardSegue) {
  // Clear the map.
  mapView.clear()

  // Add a marker to the map.
  if let place = selectedPlace {
    let marker = GMSMarker(position: place.coordinate)
    marker.title = selectedPlace?.name
    marker.snippet = selectedPlace?.formattedAddress
    marker.map = mapView
  }

  listLikelyPlaces()
}

Objective-C

// Update the map once the user has made their selection.
- (void) unwindToMain:(UIStoryboardSegue *)segue
{
  // Clear the map.
  [mapView clear];

  // Add a marker to the map.
  if (selectedPlace != nil) {
    GMSMarker *marker = [GMSMarker markerWithPosition:selectedPlace.coordinate];
    marker.title = selectedPlace.name;
    marker.snippet = selectedPlace.formattedAddress;
    marker.map = mapView;
  }

  [self listLikelyPlaces];
}

Congratulazioni! Hai creato un'app per iOS che consente all'utente di scegliere la sua posizione attuale e mostrare il risultato su una mappa di Google. Nel corso di questa operazione, hai imparato come utilizzare l'SDK Places per iOS, l'SDK Maps per iOS e l'Apple Core Location Framework.