Las superposiciones de suelo son superposiciones que están vinculadas a coordenadas de latitud y longitud, por lo que se mueven cuando arrastras el mapa o haces 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 que 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
- Crea una instancia de un objeto
GMSGroundOverlay
nuevo. - Configura la propiedad
icon
en una instancia deUIImage
. - Configura la propiedad
bounds
en una instancia deGMSCoordinateBounds
. Los límites representan las esquinas suroeste y noreste de la imagen. - Configura las propiedades opcionales, como
bearing
yzoomLevel
, según lo desees. - 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:
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;
Cómo quitar una superposición
Para quitar una superposición de suelo del mapa, configura la propiedad map
de tu GMSGroundOverlay
como nil
. De manera alternativa, puedes quitar todas las superposiciones (incluidas las de suelo que se encuentran actualmente en el mapa) llamando al método GMSMapView
clear
.
Swift
mapView.clear()
Objective‑C
[mapView clear];
Si deseas realizar modificaciones en una superposición de suelo tras agregarla al mapa, asegúrate de conservar el objeto GMSGroundOverlay
. Para modificar la superposición de suelo en otro momento, realiza cambios en este objeto.
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;
Eventos
Puedes escuchar eventos que tienen lugar en el mapa, como los que se producen cuando un 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 la
GMSMapViewDelegate
.