Referencia de la clase GMSMapView


Descripción general

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

Se debe crear una instancia del mapa con uno de los constructores -init o -initWithOptions:.

GMSMapView solo se puede leer y modificar desde el subproceso principal, de manera similar a todos los objetos UIKit. Si llamas a estos métodos desde otro subproceso, se generará una excepción o un comportamiento indefinido.

Funciones de los miembros públicos

(instancetype)- init
 Inicializa con CGRectZero y las opciones predeterminadas.
(instancetype)- initWithOptions:
 Crea una nueva vista de mapa con las opciones proporcionadas.
(instancetype)- initWithFrame:
(tipo de instancia anulable)- initWithCoder:
(instancetype)- initWithFrame:camera:
 Compila y muestra una vista de mapa con un objetivo de fotograma y cámara.
(instancetype)- initWithFrame:mapID:camera:
 Crea y muestra una vista de mapa con un fotograma, un ID de mapa y un objetivo de cámara.
(vacío)- startRendering
 Indica a este mapa que potencie su procesador.
(vacío)- stopRendering
 Indica a este mapa que apague su procesador.
(vacío)- Borrar
 Borra todas las marcas que se hayan agregado al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo.
(vacío)- setMinZoom:maxZoom:
 Establece minZoom y maxZoom.
(GMSCameraPosition* que acepta valores nulos)- cameraForBounds:insets:
 Compila una GMSCameraPosition que presente bounds con padding.
(vacío)- moveCamera:
 Cambia la cámara según update.
(BOOL)- areEqualForRenderingPosition:position:
 Verifica si las posiciones determinadas de la cámara podrían hacer que la imagen se renderice de la misma manera, teniendo en cuenta el nivel de precisión y las transformaciones que se usan internamente.
(GMSFeatureLayer
) < GMSPlaceFeature * > *).
- featureLayerOfFeatureType:
 Muestra una capa de componentes del tipo especificado.
(GMSDatasetFeatureLayer *)- datasetFeatureLayerOfDatasetID:
 Muestra una capa de componentes de conjunto de datos del conjunto de datos especificado.
(vacío)- animateToCameraPosition:
 Anima la cámara de este mapa a cameraPosition.
(vacío)- animateToLocation:
 Como animateToCameraPosition: Sin embargo, solo cambia la ubicación de la cámara (es decir, de la ubicación actual a location).
(vacío)- animateToZoom:
 As animateToCameraPosition: Sin embargo, solo cambia el nivel de zoom de la cámara.
(vacío)- animateToBearing:
 Debe ser animateToCameraPosition: pero solo cambia el rumbo de la cámara (en grados).
(vacío)- animateToViewingAngle:
 As animateToCameraPosition: Sin embargo, solo cambia el ángulo de visión de la cámara (en grados).
(vacío)- animateWithCameraUpdate:
 Aplica cameraUpdate a la cámara actual y, luego, usa el resultado según animateToCameraPosition:

Funciones estáticas de miembros públicos

(instancetype)+ mapWithFrame:camera:
 Compila y muestra una vista de mapa con un fotograma y un objetivo de cámara.
(instancetype)+ mapWithFrame:mapID:camera:
 Iniciador de conveniencia para crear y mostrar una vista de mapa con un fotograma, un ID de mapa y un objetivo de cámara.

Propiedades

ID de IBOutlet< GMSMapViewDelegate >delegado
 GMSMapView.
GMSCameraPosition *de 64 MP
 Controla la cámara, que define cómo se orienta el mapa.
GMSProjection *projection
 Muestra un objeto GMSProjection que puedes usar para convertir coordenadas en pantalla o de latitud y longitud.
BOOLmyLocationEnabled
 Controla si se habilitan el punto de Mi ubicación y el círculo de precisión.
CLLocation *myLocation
 Si Mi ubicación está habilitada, revela dónde se dibuja el punto de ubicación del dispositivo.
GMSMarker *selectedMarker
 El marcador seleccionado.
BOOLtrafficEnabled
 Controla si el mapa genera datos de tráfico, si están disponibles.
GMSMapViewTypemapType
 Controla el tipo de mosaicos de mapa que se deben mostrar.
GMSMapStyle *mapStyle
 Controla el diseño del mapa.
UIUserInterfaceStyleoverrideUserInterfaceStyle
 Cambia el mapa por el estilo [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc que desees).
número de punto flotanteminZoom
 Zoom mínimo (es posible que se aleje la cámara más alejada).
número de punto flotantemaxZoom
 Zoom máximo (lo más cercano posible a la Tierra)
BOOLbuildingsEnabled
 Si la estableces, se mostrarán los edificios 3D cuando estén disponibles.
BOOLindoorEnabled
 Establece si se muestran los mapas de interiores (si están disponibles).
GMSIndoorDisplay *indoorDisplay
 Obtiene la instancia de GMSIndoorDisplay que permite observar o controlar aspectos de la visualización de datos de interiores.
GMSUISettings *configuración
 Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario para el mapa.
UIEdgeInsetspadding
 Controla lo "visible". región de la vista.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 Controla cómo se agregan las inserciones de área segura a los valores de padding.
BOOLaccessibilityElementsHidden
 La configuración predeterminada es YES.
GMSMapLayer *capa
 Acceso para el tipo de CALayer personalizado que se usa para la capa.
GMSFrameRatepreferredFrameRate
 Controla la velocidad de fotogramas de renderización.
GMSCoordinateBounds *cameraTargetBounds
 Si no es nulo, restringe el objetivo de la cámara de modo que los gestos no hagan que salga de los límites especificados.
GMSMapCapabilityFlagsmapCapabilities
 Todas las funciones con disponibilidad condicional (según el ID de mapa o cualquier otra configuración de mapa) que se encuentren disponibles en el momento actual

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

NSString *constkGMSAccessibilityCompass
 Identificador de accesibilidad para el botón de brújula.
NSString *constkGMSAccessibilityMyLocation
 Identificador de accesibilidad de "mi ubicación" .
NSString *constkGMSAccessibilityOutOfQuota
 Identificador de accesibilidad para el usuario "sin cuota" etiqueta de error.

Documentación de la función de miembro

- (tipo de instancia) init

Inicializa con CGRectZero y las opciones predeterminadas.

- (instancetype) initWithOptions: (nonnull GMSMapViewOptions *) options

Crea una nueva vista de mapa con las opciones proporcionadas.

Con este método, se copia el valor del objeto de opciones.

- (tipo de instancia) initWithFrame: (CGRect) marco
- (tipo de instancia anulable) initWithCoder: (NSCoder *) codificador
+ (tipo de instancia) mapWithFrame: (CGRect) marco
cámara: (GMSCameraPosition *) de 64 MP

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

+ (tipo de instancia) mapWithFrame: (CGRect) marco
mapID: (GMSMapID *) mapID
cámara: (GMSCameraPosition *) de 64 MP

Iniciador de conveniencia para crear y mostrar una vista de mapa con un fotograma, un ID de mapa y un objetivo de cámara.

- (tipo de instancia) initWithFrame: (CGRect) marco
cámara: (GMSCameraPosition *) de 64 MP

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

Nota:
Esto dejó de estar disponible. En su lugar, usa -init o -initWithOptions:.
- (tipo de instancia) initWithFrame: (CGRect) marco
mapID: (GMSMapID *) mapID
cámara: (GMSCameraPosition *) de 64 MP

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

Nota:
Esto dejó de estar disponible. En su lugar, usa -init o -initWithOptions:.
- (void) startRendering

Indica a este mapa que potencie su procesador.

Es idempotente y opcional.

Nota:
Esto dejó de estar disponible. Este método es obsoleto y se quitará en una versión futura.
- (void) stopRendering

Indica a este mapa que apague su procesador.

Es idempotente y opcional.

Nota:
Esto dejó de estar disponible. Este método es obsoleto y se quitará en una versión futura.
- (void) clear

Borra todas las marcas que se hayan agregado al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo.

Esta acción no borrará el punto de ubicación visible ni restablecerá el mapType actual.

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

Establece 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.

- (GMSCameraPosition *) que admite un valor nulo: 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 al norte y directamente a la Tierra). Ten en cuenta el marco y el padding de este GMSMapView.

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

- (void) moveCamera: (GMSCameraUpdate *) actualización

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 determinadas de la cámara podrían hacer que la imagen se renderice de la misma manera, teniendo en cuenta el nivel de precisión y las transformaciones que se usan internamente.

Muestra una capa de componentes del tipo especificado.

Las capas de funciones se deben configurar en la consola de Cloud.

Si una capa del tipo especificado no existe en este mapa, si el diseño basado en datos no está habilitado, o si no se usa el framework de renderización de Metal, el elemento `isAvailable` de la capa resultante será NO y no responderá a ninguna llamada.

Requiere el renderizador de Metal. Obtén más información para habilitar Metal en https://developers.google.com/maps/documentation/ios-sdk/config#use-metal

Muestra una capa de componentes de conjunto de datos del conjunto de datos especificado.

Los IDs del conjunto de datos se deben configurar en la consola de Cloud.

Si no existe un conjunto de datos con el ID especificado en este mapa o si el diseño basado en datos no está habilitado, el valor "isAvailable" de la capa resultante será NO y no responderá a ninguna llamada.

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Anima la cámara de este mapa a cameraPosition.

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

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

- (void) animateToZoom: (flotante) zoom

As animateToCameraPosition: Sin embargo, solo cambia el nivel de zoom de la cámara.

Este valor está restringido por [kGMSMinZoomLevel, kGMSMaxZoomLevel].

- (void) animateToBearing: (CLLocationDirections) bearing

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

Cero indica el norte verdadero.

- (void) animateToViewingAngle: (doble) viewingAngle

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

Este valor se restringirá a un mínimo de cero (es decir, orientado hacia abajo) y entre 30 y 45 grados hacia el horizonte, según la proximidad 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) kGMSAccessibilityCompass [related]

Identificador de accesibilidad para el botón de brújula.

- (NSString* const) kGMSAccessibilityMyLocation [related]

Identificador de accesibilidad de "mi ubicación" .

- (NSString* const) kGMSAccessibilityOutOfQuota [related]

Identificador de accesibilidad para el usuario "sin cuota" etiqueta de error.


Documentación de la propiedad

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

Controla la cámara, que define cómo se orienta el 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 en pantalla o de latitud y longitud.

Esta es una instantánea de la proyección actual. No se actualizará automáticamente cuando se mueva la cámara. Representa la proyección del último fotograma de GMSMapView dibujado. donde la cámara se configuró explícitamente o el mapa recién creado, el próximo fotograma. Nunca será nulo.

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

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

La configuración predeterminada es NO.

- (CLLocation*) myLocation [read, assign]

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

Si está inhabilitada o habilitada, pero no hay datos de ubicación disponibles, el valor será nulo. Esta propiedad se puede observar con KVO.

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

El marcador seleccionado.

Cuando 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 nil, y si la estableces como nil, se anulará la selección del marcador y se ocultará la ventana de información. Esta propiedad se puede observar con KVO.

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

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

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

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

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

La configuración predeterminada es kGMSTypeNormal.

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

Controla el diseño del mapa.

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

- (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign]

Cambia el mapa por el estilo [UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc que desees).

Esto anula el comportamiento predeterminado de UIKit y se establece de forma predeterminada en UIUserInterfaceStyleLight para garantizar la retrocompatibilidad. Esto afecta el esquema de colores de los tipos de mapas Normal y Relieve.

- (flotante) minZoom [read, assign]

Zoom mínimo (es posible que se aleje la cámara más alejada).

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

- (flotante) maxZoom [read, assign]

Zoom máximo (lo más cercano posible a la Tierra)

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

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

Si la estableces, se mostrarán los edificios 3D cuando estén disponibles.

La configuración predeterminada es YES.

Esto puede resultar útil al agregar una capa de mosaicos personalizada al mapa, para que se vea más nítida en niveles de zoom altos. Si cambias este valor, se invalidarán todos los mosaicos brevemente.

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

Establece si se muestran los mapas de interiores (si están disponibles).

La configuración predeterminada es YES.

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

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Obtiene la instancia de 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) padding [read, write, assign]

Controla lo "visible". región de la vista.

Al aplicar relleno, se puede crear un área alrededor del borde de la vista que contendrá datos del mapa, pero no controles de la 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, de modo que la región visible no incluya el área de padding. GMSCameraUpdate FitToBounds garantizará que se tengan en cuenta tanto este padding como cualquier otro solicitado.

Esta propiedad puede estar animada dentro de un bloque de animación basado en UIView.

Controla cómo se agregan las inserciones de área segura a los valores de padding.

Al igual que el relleno, las inserciones de área segura implementan controles de mapa de posición, como la brújula, el botón de ubicación y el selector de pisos, dentro del área segura del dispositivo.

La configuración predeterminada es kGMSMapViewPaddingaddingBehavior Always.

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

La configuración predeterminada es YES.

Si la estableces como NO, GMSMapView generará elementos de accesibilidad para los objetos superpuestos, como GMSMarker y GMSPolyline.

Esta propiedad sigue el protocolo informal UIAccessibility, excepto el valor predeterminado de YES.

- (GMSMapLayer*) capa [read, retain]

Acceso para el tipo de CALayer personalizado que se usa para la capa.

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

Controla la velocidad de fotogramas de renderización.

El valor predeterminado es kGMSFrameRateMaximum.

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

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

Todas las funciones con disponibilidad condicional (según el ID de mapa o cualquier otra configuración de mapa) que se encuentren disponibles en el momento actual

No incluye las funciones siempre disponibles.