Superposiciones de suelo

Las superposiciones de suelo son superposiciones que están relacionadas con coordenadas de latitud y longitud, por lo que se mueven cuando arrastras el mapa o le aplicas zoom.

Introducción

Una superposición de suelo es una imagen que se fija a un mapa. A diferencia de los marcadores, las superposiciones de suelo se orientan respecto de la superficie de la Tierra en lugar de la pantalla. Por lo tanto, la rotación, la inclinación o el zoom del mapa cambiarán la orientación de la imagen.

Para agregar una superposición de suelo, crea un objeto GMSGroundOverlay que defina un ícono y un límite. Si no especificas ambos elementos, la superposición de suelo no aparecerá en el mapa. Si lo deseas, puedes especificar otras opciones de configuración que afectarán la posición de la imagen en el mapa. Una vez que hayas definido las opciones necesarias, configura la propiedad map de este objeto para agregar la superposición.

Cómo agregar una superposición

1. Crea una instancia de un objeto GMSGroundOverlay nuevo.
2. Establece la propiedad icon en una instancia de UIImage.
3. Establece la propiedad bounds en una instancia de GMSCoordinateBounds. Los límites representan las esquinas sudoeste y noreste de la imagen.
4. Configura las propiedades opcionales, como bearing y zoomLevel, según lo desees.
5. Establece la propiedad map: la imagen aparece en el mapa.

En el siguiente ejemplo, se muestra cómo agregar una superposición de suelo a un objeto GMSMapView existente:

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;
      

Cómo quitar una superposición

Puedes quitar una superposición de suelo del mapa si configuras la propiedad map de tu GMSGroundOverlay como nil. Como alternativa, puedes quitar todas las superposiciones (incluidas las que se hallen actualmente en el mapa) llamando al método GMSMapView clear.

mapView.clear()
      

[mapView clear];
      

Si deseas realizar modificaciones en una superposición de suelo tras agregarla al mapa, asegúrate de conservar el objeto GMSGroundOverlay. Puedes modificar la superposición de suelo más tarde; para ello, realiza cambios en este objeto.

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;
      

Eventos

Puedes escuchar eventos que tienen lugar en el mapa, como los que se producen cuando el usuario presiona una superposición. Para escuchar eventos, debes implementar el protocolo GMSMapViewDelegate. Consulta la guía de eventos y la lista de métodos en GMSMapViewDelegate.