Overlay al suolo

Gli overlay al suolo sono overlay sulla mappa che sono legati alle coordinate di latitudine/longitudine, quindi si spostano quando trascini o esegui lo zoom della mappa.

Introduzione

Un overlay del suolo è un'immagine fissata su una mappa. A differenza degli indicatori, gli overlay del suolo sono orientati in base alla superficie terrestre anziché allo schermo; pertanto, la rotazione, l'inclinazione o lo zoom della mappa cambiano l'orientamento dell'immagine.

Per aggiungere un overlay del terreno, crea un oggetto GMSGroundOverlay che definisca sia un'icona sia un delimitatore. In caso contrario, l'overlay del terreno non verrà visualizzato sulla mappa. Facoltativamente, puoi specificare impostazioni aggiuntive che influiranno sul posizionamento dell'immagine sulla mappa. Dopo aver definito le opzioni necessarie, imposta la proprietà map di questo oggetto per aggiungere l'overlay.

Aggiungere un overlay

1. Crea un'istanza di un nuovo oggetto GMSGroundOverlay
2. Imposta la proprietà icon su un'istanza di UIImage.
3. Imposta la proprietà bounds su un'istanza di GMSCoordinateBounds. I bordi rappresentano gli angoli sud-ovest e nord-est dell'immagine.
4. Imposta le proprietà facoltative, come bearing e zoomLevel, se vuoi.
5. Imposta la proprietà map: l'immagine viene visualizzata sulla mappa.

L'esempio seguente mostra come aggiungere un overlay del terreno a un oggetto GMSMapView esistente.

let southWest = CLLocationCoordinate2D(latitude: 40.712216, longitude: -74.22655)
let northEast = CLLocationCoordinate2D(latitude: 40.773941, longitude: -74.12544)
let overlayBounds = GMSCoordinateBounds(coordinate: southWest, coordinate: northEast)

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
let icon = UIImage(named: "newark_nj_1922")

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView
      

CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(40.712216,-74.22655);
CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(40.773941,-74.12544);
GMSCoordinateBounds *overlayBounds = [[GMSCoordinateBounds alloc] initWithCoordinate:southWest
                                                                        coordinate:northEast];

// Image from http://www.lib.utexas.edu/maps/historical/newark_nj_1922.jpg
UIImage *icon = [UIImage imageNamed:@"newark_nj_1922"];
GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;
      

Rimozione di un overlay

Puoi rimuovere un overlay del suolo dalla mappa impostando la proprietà map della proprietà GMSGroundOverlay su nil. In alternativa, puoi rimuovere tutti gli overlay (inclusi quelli in overlay sulla mappa utilizzando il metodo GMSMapView clear).

mapView.clear()
      

[mapView clear];
      

Se vuoi apportare modifiche a un overlay del terreno dopo averlo aggiunto alla mappa, assicurati di mantenere l'oggetto GMSGroundOverlay. Puoi modificare l'overlay del terreno in un secondo momento apportando modifiche a questo oggetto.

let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon)
overlay.bearing = 0
overlay.map = mapView

// ...

overlay.isTappable = true
      

GMSGroundOverlay *overlay = [GMSGroundOverlay groundOverlayWithBounds:overlayBounds icon:icon];
overlay.bearing = 0;
overlay.map = mapView;

// ...
overlay.tappable = YES;
      

Eventi

Puoi ascoltare gli eventi che si verificano sulla mappa, ad esempio quando un utente tocca un overlay. Per ascoltare gli eventi, devi implementare il protocollo GMSMapViewDelegate. Consulta la guida agli eventi e l'elenco dei metodi disponibili in GMSMapViewDelegate.