Navigation SDK is currently available only to select customers. Contact sales to learn more.

Referencia de la clase GMSMapView

Stay organized with collections Save and categorize content based on your preferences.

Descripción general

Esta es la clase principal del SDK de Google Maps para iOS y es el punto de entrada de todos los métodos relacionados con el mapa.

Se debe crear una instancia del mapa a través del constructor de conveniencia [GMSMapView mapWithFrame:camera:]. También se puede crear con el método predeterminado [[GMSMapView alloc] initWithFrame:] (en el que su cámara se establecerá en una ubicación predeterminada).

GMSMapView solo se puede leer y modificar desde el subproceso principal, al igual que todos los objetos UIKit. Llamar a estos métodos desde otro subproceso dará como resultado una excepción o un comportamiento no definido.

Funciones de miembro públicas

(tipo de instancia)- initWithFrame:camera:
 Compila y muestra una vista de mapa con un marco y un objetivo de cámara.
(tipo de instancia)- initWithFrame:mapID:camera:
 Crea y muestra una vista de mapa con un marco, un ID de mapa y un objetivo de la cámara.
(void)- startRendering
 Indica a este mapa que potencia su procesador.
(void)- stopRendering
 Indica a este mapa que apague el procesador.
(void)- Borrar
 Borra todo el lenguaje de marcado que se haya agregado al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo.
(void)- setMinZoom:maxZoom:
 Configura minZoom y maxZoom.
(GMSCameraPosition anulable)- cameraForBounds:insets:
 Compila una GMSCameraPosition que presente bounds con padding.
(void)- moveCamera:
 Cambia la cámara según update.
(BOOL)- areEqualForRenderingPosition:position:
 Verifica si las posiciones de la cámara dadas prácticamente harían que la cámara se renderice de la misma manera, teniendo en cuenta el nivel de precisión y las transformaciones usadas internamente.
(void)- invalidateLayoutForAccessoryView:
 Invalida una vista de accesorio y activa un nuevo diseño para esa vista.
(void)- setHeaderAccessoryView:
 Establece la posición de la vista del accesorio debajo del encabezado principal de la IU de navegación.
(void)- animateToCameraPosition:
 Anima la cámara de este mapa a cameraPosition.
(void)- animateToLocation:
 Como animateToCameraPosition:, pero cambia solo la ubicación de la cámara (es decir, de la ubicación actual a location).
(void)- animateToZoom:
 Como animateToCameraPosition:, pero solo cambia el nivel de zoom de la cámara.
(void)- animateToBearing:
 Como animateToCameraPosition:, pero solo cambia el rumbo de la cámara (en grados).
(void)- animateToViewAngle:
 Como animateToCameraPosition:, pero solo cambia el ángulo de visión de la cámara (en grados).
(void)- animateWithCameraUpdate:
 Aplica cameraUpdate a la cámara actual y, luego, usa el resultado según animateToCameraPosition:

Funciones públicas de miembros estáticas

(tipo de instancia)+ mapWithFrame:camera:
 Compila y muestra una vista de mapa con un marco y un objetivo de cámara.
(tipo de instancia)+ mapWithFrame:mapID:camera:
 Inicializador de conveniencia para compilar y mostrar una vista de mapa con un marco, un ID de mapa y un objetivo de cámara.

Propiedades

IBOutlet id< GMSMapViewDelegate >delegado
 GMSMapView.
GMSCameraPosition*camera
 Controla la cámara, que define la orientación del mapa.
GMSProjectionprojection
 Muestra un objeto GMSProjection que puedes usar para convertir coordenadas de pantalla y coordenadas de latitud y longitud.
BOOLmiUbicaciónHabilitada
 Controla si se habilitan el punto de acceso y el círculo de precisión en Mi ubicación.
CLUbicación * miUbicación
 Si Mi ubicación está habilitada, revela dónde se está dibujando el punto de ubicación del usuario.
GMSMarker*marcador seleccionado
 El marcador seleccionado
BOOLtráfico habilitado
 Controla si el mapa está dibujando datos de tráfico, si están disponibles.
GMSMapViewTypeMapType
 Controla el tipo de mosaicos de mapas que se deben mostrar.
GMSMapStylemapStyle
 Controla el estilo del mapa.
número de punto flotanteminZoom
 Zoom mínimo (a lo más puede alejarse la cámara)
número de punto flotantemaxZoom
 Zoom máximo (la distancia más cercana entre la cámara y la Tierra)
BOOLedificios habilitados
 Si se establece esta opción, se mostrarán los edificios 3D cuando estén disponibles.
BOOLindoorEnabled
 Establece si se mostrarán mapas de interiores, cuando estén disponibles.
GMSIndoorDisplaypantalla para interiores
 Obtiene la instancia GMSIndoorDisplay, que permite observar o controlar aspectos de la visualización de datos de interiores.
GMSUISettingsconfiguración
 Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario para el mapa.
IUEdgeInsetsrelleno
 Controla la región (visible) de la vista.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 Controla cómo se agregan las inserciones de áreas seguras a los valores de padding.
BOOLaccessibilityElementsHidden
 La configuración predeterminada es YES.
GMSMapLayercapa
 Descriptor de acceso para el tipo de CALayer personalizado utilizado para la capa.
GMSFrameRatePreferredFrameRate
 Controla la velocidad de fotogramas de procesamiento.
GMSCoordinateBounds*cameraTargetBounds
 Si no es nulo, restringe el objetivo de la cámara para que los gestos no puedan hacer que salga de los límites especificados.
ID de IBOutlet
GMSMapViewNavigationUIDelegate >
navigationUIDelegate
 Un delegado de GMSMapView que recibe devoluciones de llamada para eventos de la IU de navegación.
BOOLnavigationEnabled
 Indica si la función de navegación está habilitada para este mapa.
GMSNavigatornavegador
 El navegador para esta GMSMapView que permite solicitar rutas y obtener instrucciones paso a paso.
GMSRoadSnappedLocationProvider*roadSnappedLocationProvider;
 Permite la suscripción a actualizaciones de ubicación ajustadas a la ruta.
GMSLocationSimulatorlocationSimulator
 Permite simular la ubicación del usuario.
GMSNavigationCameraModecameraMode
 El modo de la cámara que determina su comportamiento cuando la propiedad navigationEnabled está establecida en SÍ.
GMSNavigationCameraPerspectivefollowPerspective
 Es la perspectiva de la cámara que se usará cuando se sigue la ubicación del usuario.
GMSNavigationTravelModetravelMode
 El modo de viaje que determina el tipo de rutas que se recuperarán y la forma en que se determina el rumbo del usuario.
GMSNavigationLightingModelightingMode.
 El modo de iluminación determina el esquema de colores que se debe utilizar para representar el mapa.
BOOLshouldDisplaySpeedLimit
 Determina si el límite de velocidad se debe mostrar cuando la guía está activa y si hay datos disponibles sobre el límite.
BOOLdebeDisplaySpeedometer
 Especifica si se muestra el ícono del velocímetro.
UILayoutGuide * navigationHeaderLayoutGuide
 El rectángulo cubierto por el encabezado de navegación.
UILayoutGuide * navigationFooterLayoutGuide
 El rectángulo que se cubre en el pie de página de navegación.
GMSNavigationRouteCalloutFormatrouteCalloutFormat.
 Especifica qué formato de texto destacado de ruta (predeterminado, de tiempo o de distancia) se usará.
número de punto flotantefollowZoomLevel
 Nivel de zoom personalizado durante la navegación

(Ten en cuenta que estas no son funciones de los miembros).

NSString *constkGMSAccessibilityMyLocation
 Identificador de accesibilidad para el botón "mi ubicación"

Documentación de la función de miembro

+ (tipo de instancia) mapWithFrame: (CGRect) marco
cámara: (GMSCameraPosition*) cámara

Compila y muestra una vista de mapa con un marco y un objetivo de cámara.

+ (tipo de instancia) mapWithFrame: (CGRect) marco
ID de mapa: (GMSMapID *) mapaID
cámara: (GMSCameraPosition*) cámara

Inicializador de conveniencia para compilar y mostrar una vista de mapa con un marco, un ID de mapa y un objetivo de cámara.

- (instancetype) initWithFrame: (CGRect) marco
cámara: (GMSCameraPosition *) cámara

Compila y muestra una vista de mapa con un marco y un objetivo de cámara.

- (instancetype) initWithFrame: (CGRect) marco
ID de mapa: (GMSMapID *) mapaID
cámara: (GMSCameraPosition *) cámara

Crea y muestra una vista de mapa con un marco, un ID de mapa y un objetivo de la cámara.

- (void) startRendering

Indica a este mapa que potencia su procesador.

Esto es opcional e idempotente.

Nota:
Ya no está disponible. Este método es obsoleto y se quitará en una versión futura.
- (void) stopRendering

Indica a este mapa que apague el procesador.

Esto es opcional e idempotente.

Nota:
Ya no está disponible. Este método es obsoleto y se quitará en una versión futura.
- (void) clear

Borra todo el lenguaje de marcado que se haya agregado al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo.

No se borrará el punto de ubicación visible ni se restablecerá el mapType actual.

- (void) setMinZoom: (flotante) minZoom
MaxZoom: (flotante) maxZoom

Configura minZoom y maxZoom.

Este método espera que el mínimo sea menor o igual que el máximo y, de lo contrario, arrojará una excepción con el nombre NSRangeException.

- (anulable GMSCameraPosition *) cameraForBounds: (GMSCoordinateBounds *) límites
inserciones: (UIEdgeInsets) inserciones

Compila una GMSCameraPosition que presente bounds con padding.

La cámara tendrá un rumbo y una inclinación cero (es decir, orientada hacia el norte y mirando directamente a la Tierra). Se tienen en cuenta el marco y el relleno de este GMSMapView.

Si los límites no son válidos, este método mostrará una cámara nula.

- (void) moveCamera: (GMSCameraUpdate *) actualizar

Cambia la cámara según update.

El cambio de cámara es instantáneo (sin animación).

- (BOOL) areEqualForRenderingPosition: (GMSCameraPosition*) position
posición: (GMSCameraPosition*) otherPosition

Verifica si las posiciones de la cámara dadas prácticamente harían que la cámara se renderice de la misma manera, teniendo en cuenta el nivel de precisión y las transformaciones usadas internamente.

- (void) invalidateLayoutForAccessoryView: (UIView< GMSNavigationAccessoryView > *) accessoryView.

Invalida una vista de accesorio y activa un nuevo diseño para esa vista.

La vista debe ser una de las vistas de accesorios actuales. Si la guía está inactiva, esta llamada es una instrucción NO-OP.

- (void) setHeaderAccessoryView: (IUView anulable GMSNavigationAccessoryView > *) headerAccessoryView

Establece la posición de la vista del accesorio debajo del encabezado principal de la IU de navegación.

Si pasas un valor nulo, se quitará la vista del accesorio. Si la guía está inactiva, esta llamada es una instrucción NO-OP.

@note Si la vista de mapa es corta, el SDK oculta la vista de accesorios debido a limitaciones de espacio. Las vistas se administran internamente para optimizar la visualización del mapa.

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Anima la cámara de este mapa a cameraPosition.

- (void) animateToLocation: (CLLocationCoordinate2D) ubicación

Como animateToCameraPosition:, pero cambia solo la ubicación de la cámara (es decir, de la ubicación actual a location).

- (void) animateToZoom: (flotante) zoom

Como animateToCameraPosition:, pero solo cambia el nivel de zoom de la cámara.

[kGMSMinZoomLevel, kGMSMaxZoomLevel] fija este valor.

- (void) animateToBearing: (CLLocationDirection) bearing

Como animateToCameraPosition:, pero solo cambia el rumbo de la cámara (en grados).

Cero indica el norte verdadero.

- (void) animateToViewAngle: (doble) viewingAngle

Como animateToCameraPosition:, pero solo cambia el ángulo de visión de la cámara (en grados).

Este valor se fijará a un mínimo de cero (es decir, hacia abajo) y entre 30 y 45 grados hacia el horizonte, según la cercanía relativa a la Tierra.

- (void) animateWithCameraUpdate: (GMSCameraUpdate*) cameraUpdate.

Aplica cameraUpdate a la cámara actual y, luego, usa el resultado según animateToCameraPosition:


- (NSString* const) kGMSAccessibilityMyLocation [related]

Identificador de accesibilidad para el botón "mi ubicación"


Documentación de la propiedad

- (IBOutlet id<GMSMapViewDelegate>) delegado [read, write, assign]
- (GMSCameraPosition*) cámara [read, write, copy]

Controla la cámara, que define la orientación del mapa.

La modificación de esta propiedad es instantánea.

- (GMSProjection*) proyección [read, assign]

Muestra un objeto GMSProjection que puedes usar para convertir coordenadas de pantalla y coordenadas de latitud y longitud.

Este es un resumen de la proyección actual y no se actualizará automáticamente cuando se mueva la cámara. Representa la proyección del último fotograma de GMSMapView dibujado o, donde la cámara se configuró explícitamente o el mapa que acaba de crear, el próximo fotograma. Nunca será nulo.

- (BOOL) myLocationEnabled [read, write, assign]

Controla si se habilitan el punto de acceso y el círculo de precisión en Mi ubicación.

La configuración predeterminada es NO.

- (CLLocation*) myLocation [read, assign]

Si Mi ubicación está habilitada, revela dónde se está dibujando el punto de ubicación del usuario.

Si se inhabilita o se habilita, pero no hay datos de ubicación disponibles, este valor será nulo. Esta propiedad se puede observar con KVO.

- (GMSMarker*) selectedMarker [read, write, assign]

El marcador seleccionado

Si se configura esta propiedad, se selecciona un marcador en particular y se muestra una ventana de información sobre él. Si esta propiedad no es nula, establecerla en "nil" anula la selección del marcador y oculta la ventana de información. Esta propiedad se puede observar con KVO.

- (BOOL) trafficEnabled [read, write, assign]

Controla si el mapa está dibujando datos de tráfico, si están disponibles.

Esto está sujeto a la disponibilidad de los datos de tráfico. La configuración predeterminada es NO.

- (GMSMapViewType) mapType [read, write, assign]

Controla el tipo de mosaicos de mapas que se deben mostrar.

La configuración predeterminada es kGMSTypeNormal.

- (GMSMapStyle*) mapStyle [read, write, assign]

Controla el estilo del mapa.

Un mapStyle sin valor nulo solo se aplicará si mapType es Normal.

- (float) minZoom [read, assign]

Zoom mínimo (a lo más puede alejarse la cámara)

La configuración predeterminada es kGMSMinZoomLevel. Modificado con -setMinZoom:maxZoom:

- (float) maxZoom [read, assign]

Zoom máximo (la distancia más cercana entre la cámara y la Tierra)

La configuración predeterminada es kGMSMaxZoomLevel. Modificado con -setMinZoom:maxZoom:

- (BOOL) buildingsEnabled [read, write, assign]

Si se establece esta opción, se mostrarán los edificios 3D cuando estén disponibles.

La configuración predeterminada es YES.

Esto puede ser útil cuando se agrega una capa de mosaicos personalizada al mapa, para que sea más claro con altos niveles de zoom. Si cambias este valor, se invalidarán brevemente todos los mosaicos.

- (BOOL) indoorEnabled [read, write, assign]

Establece si se mostrarán mapas de interiores, cuando estén disponibles.

La configuración predeterminada es YES.

Si se establece en NO, es posible que se borren definitivamente las cachés de los datos de interiores y que se restablezca el piso que haya seleccionado el usuario final.

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Obtiene la instancia GMSIndoorDisplay, que permite observar o controlar aspectos de la visualización de datos de interiores.

- (GMSUISettings*) configuración [read, assign]

Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario para el mapa.

- (UIEdgeInsets) relleno [read, write, assign]

Controla la región (visible) de la vista.

Al aplicar padding, se puede crear un área alrededor del borde de la vista que contendrá datos de mapa, pero no controles de IU.

Si el relleno no está equilibrado, el centro visual de la vista se moverá según corresponda. El padding también afectará la propiedad projection, por lo que la región visible no incluirá el área de padding. GMSCameraUpdate de FitToBounds garantizará que se tengan en cuenta tanto el padding como cualquier padding solicitado.

Esta propiedad se puede animar dentro de un bloque de animación basado en UIView.

Controla cómo se agregan las inserciones de áreas seguras a los valores de padding.

Al igual que el padding, los controles de posición del mapa de posiciones seguras, como la brújula, el botón de ubicación y el selector de piso dentro del área segura del dispositivo.

La configuración predeterminada es kGMSMapViewPaddingAdjustmentBehaviorAlways.

- (BOOL) accessibilityElementsHidden [read, write, assign]

La configuración predeterminada es YES.

Si se configura en NO, GMSMapView generará elementos de accesibilidad para objetos superpuestos, como GMSMarker y GMSPolyline.

Esta propiedad cumple con el protocolo informal UIAcessibility, excepto por el valor predeterminado de YES.

- (GMSMapLayer*) capa [read, retain]

Descriptor de acceso para el tipo de CALayer personalizado utilizado para la capa.

- (GMSFrameRate) preferredFrameRate [read, write, assign]

Controla la velocidad de fotogramas de procesamiento.

El valor predeterminado es kGMSFrameRateMaximum.

- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign]

Si no es nulo, restringe el objetivo de la cámara para que los gestos no puedan hacer que salga de los límites especificados.

- (IBOutlet id<GMSMapViewNavigationUIDelegate>) navigationUIDelegate [read, write, assign]

Un delegado de GMSMapView que recibe devoluciones de llamada para eventos de la IU de navegación.

- (BOOL) navigationEnabled [read, write, assign]

Indica si la función de navegación está habilitada para este mapa.

Si la respuesta es SÍ, las rutas y las instrucciones sobre cómo llegar paso a paso se pueden mostrar en el mapa, la cámara puede ingresar al modo siguiente y el botón para volver a centrar aparece cuando la cámara no sigue la ubicación del usuario.

Si el usuario no acepta los Términos y Condiciones de Navegación GPS de Google, la configuración de esta propiedad no tendrá efecto. Para mostrar el diálogo de los Términos y condiciones, consulta los métodos en GMSNavigationServices.

- (GMSNavigator*) navegador [read, assign]

El navegador para esta GMSMapView que permite solicitar rutas y obtener instrucciones paso a paso.

Si el usuario no ha aceptado los términos y condiciones de Navegación GPS de Google, este valor será nulo. Para mostrar el diálogo de los Términos y condiciones, consulta los métodos en GMSNavigationServices.

Permite la suscripción a actualizaciones de ubicación ajustadas a la ruta.

Si el usuario no ha aceptado los términos y condiciones de Navegación GPS de Google, este valor será nulo. Para mostrar el diálogo de los Términos y condiciones, consulta los métodos en GMSNavigationServices.

Permite simular la ubicación del usuario.

La ubicación simulada afecta la posición de la comilla angular en el mapa, el progreso de la guía giro por giro y las actualizaciones proporcionadas por el proveedor de la ubicación ajustada.

Si el usuario no ha aceptado los términos y condiciones de Navegación GPS de Google, este valor será nulo. Para mostrar el diálogo de los Términos y condiciones, consulta los métodos en GMSNavigationServices.

- (GMSNavigationCameraMode) cameraMode [read, write, assign]

El modo de la cámara que determina su comportamiento cuando la propiedad navigationEnabled está establecida en SÍ.

Consulta GMSNavigationCameraMode para conocer los modos disponibles.

Es la perspectiva de la cámara que se usará cuando se sigue la ubicación del usuario.

La propiedad navigationEnabled debe establecerse en YES y cameraMode en GMSNavigationCameraModeFollowing para que se aplique esta perspectiva.

- (GMSNavigationTravelMode) travelMode [read, write, assign]

El modo de viaje que determina el tipo de rutas que se recuperarán y la forma en que se determina el rumbo del usuario.

En el modo de conducción "En automóvil", se basa en la dirección de movimiento, mientras que en el modo de bicicleta o a pie se basa en la dirección de la brújula que apunta el dispositivo. El curso del usuario está representado por la dirección del marcador de la ubicación del usuario y está informado por el GMSRoadSnappedLocationProvider.

- (GMSNavigationLightingMode) lightingMode [read, write, assign]

El modo de iluminación determina el esquema de colores que se debe utilizar para representar el mapa.

También se usa para determinar los colores predeterminados de varios elementos de la interfaz.

- (BOOL) shouldDisplaySpeedLimit [read, write, assign]

Determina si el límite de velocidad se debe mostrar cuando la guía está activa y si hay datos disponibles sobre el límite.

El valor predeterminado es NO.

- (BOOL) shouldDisplaySpeedometer [read, write, assign]

Especifica si se muestra el ícono del velocímetro.

Cuando está habilitado, aparece un ícono de velocímetro que indica la velocidad del vehículo en la esquina inferior durante la orientación. Cuando haya datos confiables disponibles sobre el límite de velocidad, este también aparecerá y se adjuntará al ícono del velocímetro. El ícono del velocímetro puede tener diferentes colores para el texto y el fondo, según la gravedad de la alerta de velocidad.

Si se habilita el botón para volver a centrar, el límite de velocidad y el ícono del velocímetro estarán ocultos de forma temporal cuando aparezca el botón para volver a centrar.

- (UILayoutGuide*) navigationHeaderLayoutGuide [read, assign]

El rectángulo cubierto por el encabezado de navegación.

La altura es cero cuando el encabezado está oculto.

- (UILayoutGuide*) navigationFooterLayoutGuide [read, assign]

El rectángulo que se cubre en el pie de página de navegación.

La altura es cero cuando el pie de página está oculto.

Especifica qué formato de texto destacado de ruta (predeterminado, de tiempo o de distancia) se usará.

- (float) followZoomLevel [read, write, assign]

Nivel de zoom personalizado durante la navegación

La configuración de este valor anulará el nivel de zoom predeterminado del SDK de Navigation cuando la cámara esté siguiendo la ubicación del usuario (es decir, cameraMode es igual a GMSNavigationCameraModeFollowing). Se puede establecer en GMSNavigationNoFollowingZoomLevel si no se debe usar la anulación del nivel de zoom.