Configura un mapa

En esta descripción general, se explica cómo configurar un mapa que se agregó a una app para iOS con el SDK de Maps para iOS.

Descripción general

Después de agregar un mapa a tu app, puedes configurar las opciones iniciales y los parámetros de configuración del tiempo de ejecución del mapa. Para obtener información detallada acerca de cómo agregar el contenedor de un mapa, consulta el artículo Agrega un mapa.

Los parámetros de configuración iniciales del mapa abarcan lo siguiente:

• Cómo posicionar la cámara, lo que incluye la ubicación, el zoom, el rumbo y la inclinación Consulta Cámara y vista para obtener detalles sobre la posición de la cámara.
• El color de fondo del mapa.
• El tipo de mapa
• Los componentes de la IU que se mostrarán, como los botones de zoom y la brújula
• Los gestos que se deben habilitar

Durante el tiempo de ejecución, puedes configurar estos parámetros y algunos parámetros adicionales si actualizas el objeto GMSMapView.

Opciones del mapa

Cuando inicializas la vista del mapa, las opciones de configuración se establecen con GMSMapViewOptions. Las propiedades de opción incluyen frame, camera, mapID o backgroundColor.

Cómo configurar las opciones del mapa

Puedes establecer tus propias propiedades de opción o pasar una instancia de GMSMapViewOptions con valores predeterminados directamente a GMSMapView.

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Este es un ejemplo de cómo pasar un objeto GMSMapViewOptions con valores predeterminados directamente a GMSMapView.

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

Cómo configurar el color de fondo

Cuando trabajas en modo oscuro o cambias entre vistas de mapa, puede ser útil anular el color de fondo predeterminado del mapa. Para ello, configura la propiedad backgroundColor de las opciones del mapa.

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Tipos de mapas

Puedes personalizar tu mapa con uno de los numerosos tipos de mapas. El tipo de mapa rige la representación general del mapa. Por ejemplo, un atlas suele contener mapas políticos que se enfocan en mostrar los límites y mapas rúteños que muestran todas las rutas de una ciudad o región. El SDK de Maps para iOS ofrece los siguientes tipos de mapas:

Cómo cambiar el tipo de mapa

Para establecer el tipo de un mapa, asigna un valor nuevo a la propiedad GMSMapView.mapType. Por ejemplo, para que se muestre un tipo de mapa satelital:

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

En el siguiente selector, se muestra una comparación de los mapas de terreno, normales y híbridos de la misma ubicación:

Mapas de interiores

Cuando se utilizan altos niveles de zoom en espacios cerrados, como aeropuertos, centros comerciales, grandes tiendas minoristas y estaciones de transporte público, el SDK de Maps para iOS mostrará los planos del edificio. Los planos de edificios están integrados en las tarjetas de mapa predeterminadas para el tipo de mapa "normal" (kGMSTypeNormal) y se habilitan automáticamente cuando el usuario acerca el mapa y se desvanecen cuando se aleja.

Para inhabilitar los mapas de interiores, configura la propiedad indoorEnabled de GMSMapView en NO.

mapView.isIndoorEnabled = false
      

mapView.indoorEnabled = NO;
      

Como alternativa, puedes inhabilitar solo el control del selector de piso.

Agrega planos de planta

Los planos de edificios están disponibles en ubicaciones seleccionadas. Si los datos del plano del edificio que deseas destacar en tu aplicación no están disponibles, puedes hacer lo siguiente:

• Agrega planos del piso directamente a Google Maps. De este modo, tus planes estarán disponibles para todos los usuarios de Google Maps.
• Muestra un plano de planta como una superposición de suelo. Esto permite que solo los usuarios de tu aplicación vean tus planos de planta.

Capa de tráfico

Puedes darles a tus usuarios la posibilidad de ver el mapa con información superpuesta sobre la densidad del tráfico. Esto les proporcionará un resumen visual de la situación del tráfico local. Para activar o desactivar la capa de tráfico, llama al método trafficEnabled. En el siguiente ejemplo, se ve cómo podría mostrarse la capa de tráfico en un mapa.

Accesibilidad

De manera predeterminada, los elementos de accesibilidad del mapa vienen ocultos. Para habilitar la accesibilidad, configura la propiedad accessibilityElementsHidden de GMSMapView en NO. Esto hace que se generen elementos de accesibilidad para los objetos superpuestos (como GMSMarker y ventanas de información, GMSPolyline, etcétera).

mapView.accessibilityElementsHidden = false
      

mapView.accessibilityElementsHidden = NO;
      

Esta propiedad se basa en el protocolo informal UIAccessibility, excepto que el valor predeterminado en el SDK de Maps para iOS es YES.

Mi ubicación

De manera predeterminada, no se proporcionan datos sobre la ubicación en el mapa. Para habilitar el punto azul "Mi ubicación" y la dirección de la brújula, configura myLocationEnabled en GMSMapView.

mapView.isMyLocationEnabled = true
      

mapView.myLocationEnabled = YES;
      

Si habilitas esta función, se proporciona la ubicación actual del usuario a través de la propiedad myLocation. Es posible que esta propiedad no esté disponible de inmediato, por ejemplo, si iOS le solicita al usuario que permita el acceso a estos datos. En este caso, es nil.

print("User's location: \(String(describing: mapView.myLocation))")
      

NSLog(@"User's location: %@", mapView.myLocation);
      

Edificios 3D

Muchas ciudades, cuando se vean de cerca, tendrán edificios en 3D visibles, como se puede ver en la imagen de Seattle, Washington, a continuación.

Para inhabilitar los edificios 3D, configura la propiedad GMSMapView correspondiente en Swift o Objective-C, como se muestra a continuación:

mapView.isBuildingsEnabled = false
      

[mapView setBuildingsEnabled:NO];
      

Mapas con padding

Un mapa de Google está diseñado para ocupar toda la región definida por GMSMapView. Las dimensiones de la vista definen varios aspectos de cómo aparece y se comporta el mapa:

• El objetivo de la cámara refleja el centro de la región con padding.
• La posición de los controles de mapa se define respecto de los bordes del mapa.
• La información legal, como las declaraciones de derechos de autor o el logotipo de Google, aparece en el borde inferior del mapa.

Puedes agregar padding en los bordes del mapa con el método GMSMapView.Propiedad padding. El mapa sigue ocupando todo el contenedor, pero el posicionamiento del texto y los controles, los gestos del mapa y los movimientos de la cámara se comportan como si se hubieran colocado en un espacio más pequeño. El resultado es el siguiente:

• Los movimientos de la cámara que usan llamadas a la API o presionan botones (p.ej., brújula, mi ubicación) son relativos a la región con relleno.
• GMSMapView.projection muestra una proyección que solo incluye la región rellena.
• Los controles de la IU se desplazan del borde del contenedor por la cantidad de puntos especificada.

El padding puede resultar útil cuando se diseñan componentes de la IU que se superponen con alguna parte del mapa. Por ejemplo, en la imagen, el mapa tiene relleno a lo largo de los bordes superior y derecho. Los controles del mapa y el texto legal visibles se muestran en los bordes de la región con padding (recuadro verde), mientras que el mapa sigue ocupando todo el contenedor (recuadro azul). En este ejemplo, puedes colocar un menú flotante sobre el lado derecho del mapa sin ocultar los controles del mapa.

Para agregar padding a tu mapa, crea un objeto UIEdgeInsets y pásalo al GMSMapView.Propiedad padding.

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

Esquema de colores del mapa

En el caso de los mapas de tipo normal y de terreno, puedes establecer el esquema de colores del mapa como oscuro, brillante o usar la configuración actual del sistema. Por ejemplo, puedes oscurecer o aclarar el esquema de colores del mapa según la hora del día o el uso del dispositivo en interiores o exteriores.

Usa GMSMapView overrideUserInterfaceStyle: para establecer y actualizar el esquema de colores del mapa.

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;