Gli overlay del suolo sono overlay sulla mappa legati alle coordinate di latitudine/longitudine, in modo che si muovano quando trascini o esegui lo zoom sulla mappa.
Introduzione
Un overlay al suolo è un'immagine fissata a una mappa. A differenza degli indicatori, gli overlay del suolo sono orientati rispetto alla superficie terrestre anziché allo schermo, pertanto la rotazione, l'inclinazione o lo zoom della mappa modificherà l'orientamento dell'immagine.
Per aggiungere un overlay al suolo, crea un oggetto GMSGroundOverlay
che definisca sia un'icona sia un limite. Se non specifichi nessuna di queste, l'overlay del suolo
non verrà visualizzato sulla mappa. Facoltativamente, puoi specificare impostazioni aggiuntive che
influiranno sul posizionamento dell'immagine sulla mappa. Una volta definite le opzioni necessarie, imposta la proprietà map
di questo oggetto per aggiungere l'overlay.
Aggiunta di un overlay
- Crea un'istanza per un nuovo oggetto
GMSGroundOverlay
- Imposta la proprietà
icon
su un'istanza diUIImage
. - Imposta la proprietà
bounds
su un'istanza diGMSCoordinateBounds
. I confini rappresentano gli angoli sud-ovest e nord-est dell'immagine. - Imposta le proprietà facoltative, come
bearing
ezoomLevel
, come preferisci. - Imposta la proprietà
map
: l'immagine viene visualizzata sulla mappa.
L'esempio seguente mostra come aggiungere un overlay al suolo a un oggetto GMSMapView
esistente.
Swift
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
Objective-C
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 al suolo dalla mappa impostando la
proprietà map
di GMSGroundOverlay
su nil
. In alternativa, puoi rimuovere tutti
gli overlay (compresi gli overlay al suolo attualmente sulla mappa) chiamando il
metodo clear
GMSMapView
.
Swift
mapView.clear()
Objective-C
[mapView clear];
Se vuoi apportare modifiche a un overlay al suolo dopo averlo aggiunto alla mappa, assicurati di tenere premuto l'oggetto GMSGroundOverlay
. Puoi
modificare l'overlay al suolo in un secondo momento apportando modifiche all'oggetto.
Swift
let overlay = GMSGroundOverlay(bounds: overlayBounds, icon: icon) overlay.bearing = 0 overlay.map = mapView // ... overlay.isTappable = true
Objective-C
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 nella GMSMapViewDelegate
.