Referencia de la clase GMSMapView

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 [[GMSMapView alloc] initWithFrame:] predeterminado (en el que su cámara se establecerá en una ubicación predeterminada).

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

Funciones de miembros públicos

(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:
 Compila y muestra una vista de mapa con un marco, un ID de mapa y el objetivo de la cámara.
(nulo)- startRendering
 Indica a este mapa que active su procesador.
(nulo)- stopRendering
 Indica a este mapa que apague el procesador.
(nulo)- borrar
 Borra todo el lenguaje de marcado que se haya agregado al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo.
(nulo)- setMinZoom:maxZoom:
 Configura minZoom y maxZoom.
(GMSCameraPosition anulable *)- cameraForBounds:insets:
 Compila una GMSCameraPosition que muestre bounds con padding.
(nulo)- moveCamera:
 Cambia la cámara según update.
(BOOL)- areEqualForRenderingPosition:position:
 Verifica si las posiciones de la cámara dadas harían que la cámara se renderice de la misma manera, teniendo en cuenta el nivel de precisión y las transformaciones que se usan internamente.
(nulo)- animateToCameraPosition:
 Anima la cámara de este mapa a cameraPosition.
(nulo)- animateToLocation:
 Como animateToCameraPosition, pero solo cambia la ubicación de la cámara (es decir, de la ubicación actual a location).
(nulo)- animateToZoom:
 Como animateToCameraPosition, pero solo cambia el nivel de zoom de la cámara.
(nulo)- animateToBearing:
 Como animateToCameraPosition, solo cambia el rumbo de la cámara (en grados).
(nulo)- animateToViewAngle:
 Como animateToCameraPosition, pero solo cambia el ángulo de visión de la cámara (en grados).
(nulo)- animateWithCameraUpdate:
 Aplica cameraUpdate a la cámara actual y, luego, usa el resultado según animateToCameraPosition.

Funciones de miembros públicos 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 el objetivo de la cámara.

Propiedades

ID de IBOutlet< GMSMapViewDelegate >delegado
 GMSMapView.
GMSCameraPositioncamera
 Controla la cámara, que define la orientación del mapa.
GMSProjectionprojection
 Muestra un objeto GMSProjection que puedes usar para la conversión entre coordenadas de pantalla y coordenadas de latitud y longitud.
BOOLmiUbicaciónHabilitada
 Controla si se habilitan los puntos de mi ubicación y el círculo de precisión.
CLUbicación * miUbicación
 Si está habilitada la función Mi ubicación, revela dónde se está dibujando el punto de ubicación del usuario.
GMSMarkerMarcador seleccionado
 Marcador seleccionado
BOOLtrafficEnabled
 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.
flotantemín.Zoom
 Zoom mínimo (a lo más se puede alejar la cámara)
flotantemaxZoom
 Zoom máximo (lo más cerca posible de la cámara a la Tierra)
BOOLedificiosHabilitado
 Si la estableces, se mostrarán los edificios 3D disponibles.
BOOLpara interiores
 Permite establecer si se mostrarán mapas de interiores, cuando estén disponibles.
GMSIndoorDisplaypara interiores
 Obtiene la instancia GMSIndoorDisplay que permite observar o controlar los aspectos de la visualización de los datos de interiores.
GMSUISettingsconfiguración
 Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario para el mapa.
Inserciones de UIEdgerelleno
 Controla la región "visible" de la vista.
GMSMapViewPaddingAdjustmentBehaviorpaddingAdjustmentBehavior
 Controla cómo se agregan las inserciones del área segura a los valores de padding.
BOOLaccessibilityElementsHidden
 La configuración predeterminada es YES.
GMSMapLayer*capa
 Descriptor de acceso para el tipo de CALayer personalizado que se usa en la capa.
GMSFrameRatepreferredFrameRate
 Controla la velocidad de fotogramas del procesamiento.
GMSCoordinateBounds*cameraTargetBounds
 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.

(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) fotograma
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) fotograma
ID de mapa: (GMSMapID*). ID del mapa
cámara: (GMSCameraPosition*) cámara

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

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

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

- (instancetype) initWithFrame: (CGRect) fotograma
ID de mapa: (GMSMapID *). ID del mapa
cámara: (GMSCameraPosition *) cámara

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

- (void) startRendering

Indica a este mapa que active su procesador.

Esto es opcional y idempotente.

Nota:
Esta opción 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 el procesador.

Esto es opcional y idempotente.

Nota:
Esta opción dejó de estar 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.

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

- (void) setMinZoom: (float) mín.Zoom
MaxZoom: (float) 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: (Inserciones de UIEdge) inserciones

Compila una GMSCameraPosition que muestre bounds con padding.

La cámara tendrá una orientación de cero cero y la inclinación (es decir, mirando hacia el norte y mirando directamente a la Tierra). Se tienen en cuenta el marco y el relleno de esta 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 la 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 harían que la cámara se renderice de la misma manera, teniendo en cuenta el nivel de precisión y las transformaciones que se usan internamente.

- (void) animateToCameraPosition: (GMSCameraPosition *) cameraPosition

Anima la cámara de este mapa a cameraPosition.

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

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

- (nulo) animateToZoom: (float) 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, solo cambia el rumbo de la cámara (en grados).

Cero indica el norte geográfico.

- (void) animateToViewAngle: (doble) veringAngle

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, apuntando hacia abajo) y entre 30 y 45 grados en 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

- (ID de IBOutlet<GMSMapViewDelegate>) delegar [read, write, assign]
- (GMSCameraPosition*) camera [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 la conversión entre coordenadas de pantalla y coordenadas de latitud y longitud.

Esta es una instantánea de la proyección actual y no se actualizará automáticamente cuando se mueva la cámara. Representa la proyección del último marco GMSMapView dibujado o, cuando la cámara se establece 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 los puntos de mi ubicación y el círculo de precisión.

La configuración predeterminada es NO.

- (CLLocation*) myLocation [read, assign]

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

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

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

Marcador seleccionado

Cuando se configura esta propiedad, se selecciona un marcador en particular y se muestra una ventana de información en él. Si esta propiedad no es "nil", si se establece en "nil", se anula la selección del marcador y se 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 que no sea nulo se aplicará solo si mapType es Normal.

- (float) minZoom [read, assign]

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

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

- (float) maxZoom [read, assign]

Zoom máximo (lo más cerca posible de la cámara 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 disponibles.

La configuración predeterminada es YES.

Esto puede ser útil cuando se agrega una capa de mosaicos personalizada al mapa, para que quede más clara en altos niveles de zoom. Si cambias este valor, se invalidarán todos los mosaicos por un período breve.

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

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

La configuración predeterminada es YES.

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

- (GMSIndoorDisplay*) indoorDisplay [read, assign]

Obtiene la instancia GMSIndoorDisplay que permite observar o controlar los aspectos de la visualización de los 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.

- (Relleno de IUEdge) relleno [read, write, assign]

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

Si se aplica un padding para un área alrededor del borde de la vista, este podrá contener datos del mapa, pero no controles de la IU.

Si el padding 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 FitToBounds garantizará que se tomen en cuenta tanto el padding como el padding solicitado.

Se puede animar esta propiedad dentro de un bloque de animación basado en UIView.

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

Al igual que el relleno, el área segura inserta los controles del mapa de posición, 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 establece en NO, GMSMapView generará elementos de accesibilidad para los objetos de superposición, 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 que se usa en la capa.

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

Controla la velocidad de fotogramas del procesamiento.

El valor predeterminado es kGMSFrameRateMáximo.

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