Descripción general
Esta es la clase principal del SDK de Google Maps para iOS y el punto de entrada para todos los métodos relacionados con el mapa.
Se debe crear una instancia del mapa a través de 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. Llamar a estos métodos desde otro subproceso dará como resultado una excepción o un comportamiento indefinido.
Funciones públicas de miembros | |
| (tipo de instancia) | - init |
| Se inicializa con CGRectZero y con opciones predeterminadas. | |
| (tipo de instancia) | - initWithOptions: |
| Crea una nueva vista de mapa con las opciones determinadas. | |
| (tipo de instancia) | - initWithFrame: |
| (tipo de instancia) | - initWithCoder: |
| (tipo de instancia) | - initWithFrame:camera: |
| Crea y muestra una vista de mapa, con un fotograma y un objetivo de cámara. | |
| (tipo de instancia) | - initWithFrame:mapID:camera: |
| Crea y muestra una vista de mapa con un fotograma, un ID de mapa y un objetivo de la cámara. | |
| (void) | - startRendering |
| Indica a este mapa que active su renderizador. | |
| (void) | - stopRendering |
| Indica a este mapa que apague su renderizador. | |
| (void) | - claro |
| Elimina todas las marcas que se agregaron al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo. | |
| (void) | - setMinZoom:maxZoom: |
Configura minZoom y maxZoom. | |
| (nullable GMSCameraPosition *) | - 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 indicadas de la cámara harían que la cámara se renderizara de forma prácticamente igual, teniendo en cuenta el nivel de precisión y transformaciones que se usan internamente. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| Muestra una capa de componentes del tipo especificado. | |
| (void) | - animateToCameraPosition: |
Anima la cámara de este mapa en cameraPosition. | |
| (void) | - animateToLocation: |
Como animateToCameraPosition: Sin embargo, solo cambia la ubicación de la cámara (es decir, de la ubicación actual a location). | |
| (void) | - animateToZoom: |
| Como animateToCameraPosition: pero cambia solo el nivel de zoom de la cámara. | |
| (void) | - animateToBearing: |
| Como animateToCameraPosition: pero solo cambia el rumbo de la cámara (en grados). | |
| (void) | - animateToViewingAngle: |
| 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 de miembro públicas estáticas | |
| (tipo de instancia) | + mapWithFrame:camera: |
| Crea y muestra una vista de mapa con un fotograma 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 fotograma, un ID de mapa y un objetivo de cámara | |
Propiedades | |
| ID de IBOutlet< GMSMapViewDelegate > | delegado |
| GMSMapView. | |
| GMSCameraPosition * | camera |
| Controla la cámara, que define la orientación del mapa. | |
| GMSProjection * | projection |
| Muestra un objeto GMSProjection que puedes usar para convertir entre coordenadas de pantalla y coordenadas de latitud y longitud. | |
| BOOL | myLocationEnabled |
| Controla si se habilitan el punto y el círculo de precisión de Mi ubicación. | |
| CLLocation * | myLocation |
| Si Mi ubicación está habilitada, revela dónde se dibuja el punto de ubicación del dispositivo. | |
| GMSMarker * | selectedMarker |
| Es el marcador seleccionado. | |
| BOOL | trafficEnabled |
| Controla si el mapa genera datos de tráfico (si están disponibles). | |
| GMSMapViewType | mapType |
| Controla el tipo de mosaicos de mapas que se deben mostrar. | |
| GMSMapStyle * | mapStyle |
| Controla el diseño del mapa. | |
| float | minZoom |
| Zoom mínimo (es posible que la cámara se aleje a la mayor distancia). | |
| float | maxZoom |
| Zoom máximo (lo más cerca que esté la cámara de la Tierra) | |
| BOOL | buildingsEnabled |
| Si la estableces, se mostrarán los edificios 3D donde estén disponibles. | |
| BOOL | indoorEnabled |
| Establece si se muestran los mapas de interiores cuando están disponibles. | |
| GMSIndoorDisplay * | indoorDisplay |
| Obtiene la instancia de GMSIndoorDisplay, que permite observar o controlar aspectos de la pantalla de datos de interiores. | |
| GMSUISettings * | configuración |
| Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario del mapa. | |
| UIEdgeInsets | padding |
| Controla la región "visible" de la vista. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Controla cómo se agregan las inserciones del área segura a los valores de padding. | |
| BOOL | accessibilityElementsHidden |
| La configuración predeterminada es YES. | |
| GMSMapLayer * | capa |
| Descriptor de acceso para el tipo de CALayer personalizado que se usa para la capa. | |
| GMSFrameRate | preferredFrameRate |
| 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 puedan hacer que salga de los límites especificados. | |
| GMSMapCapabilityFlags | mapCapabilities |
| Todas las funciones con disponibilidad condicional (que dependen de mapID o de otra configuración del mapa) que están disponibles en el momento actual. | |
Funciones relacionadas | |
(ten en cuenta que estas no son funciones de los miembros). | |
| NSString *const | kGMSAccessibilityCompass |
| Es el identificador de accesibilidad del botón de brújula. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Identificador de accesibilidad para el botón “Mi ubicación”. | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| Identificador de accesibilidad para la etiqueta de error “fuera de la cuota”. | |
Documentación de las funciones de los miembros
| - (tipo de instancia) init |
Se inicializa con CGRectZero y con opciones predeterminadas.
| - (tipo de instancia) initWithOptions: | (GMSMapViewOptions no nula *) | options |
Crea una nueva vista de mapa con las opciones determinadas.
Este método copia el valor del objeto de opciones.
| - (tipo de instancia) initWithFrame: | (CGRect) | marco |
| - (tipo de instancia) initWithCoder: | (NSCoder *) | codificador |
| + MapWithFrame (tipo de instancia): | (CGRect) | marco | |
| cámara: | (GMSCameraPosition *) | cámara | |
Crea y muestra una vista de mapa con un fotograma y un objetivo de cámara.
| + MapWithFrame (tipo de instancia): | (CGRect) | marco | |
| ID de mapa: | (GMSMapID *) | mapID | |
| cámara: | (GMSCameraPosition *) | cámara | |
Inicializador de conveniencia para compilar 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 *) | cámara | |
Crea y muestra una vista de mapa, con un fotograma y un objetivo de cámara.
- Nota:
- Esto dejó de estar disponible. En su lugar, usa -init o -initWithOptions.
| - (tipo de instancia) initWithFrame: | (CGRect) | marco | |
| ID de mapa: | (GMSMapID *) | mapID | |
| cámara: | (GMSCameraPosition *) | cámara | |
Crea y muestra una vista de mapa con un fotograma, un ID de mapa y un objetivo de la cámara.
- Nota:
- Esto dejó de estar disponible. En su lugar, usa -init o -initWithOptions.
| - (void) startRendering |
Indica a este mapa que active su renderizador.
Esto es opcional e idempotente.
- 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 renderizador.
Esto es opcional e idempotente.
- Nota:
- Esto dejó de estar disponible. Este método es obsoleto y se quitará en una versión futura.
| - (void) clear |
Elimina todas las marcas que se agregaron al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo.
Esta acción no borrará el punto visible de la ubicación ni restablecerá el mapType actual.
| - (void) setMinZoom: | (float) | minZoom | |
| maxZoom: | (float) | maxZoom | |
Configura minZoom y maxZoom.
Este método espera que el mínimo sea menor o igual que el máximo; de lo contrario, arrojará una excepción con el nombre NSRangeException.
| - (nullable 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 al norte y mirando directamente a la Tierra). Esto tiene en cuenta el marco y el padding 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 indicadas de la cámara harían que la cámara se renderizara de forma prácticamente igual, teniendo en cuenta el nivel de precisión y transformaciones que se usan internamente.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType). | featureType |
Muestra una capa de componentes del tipo especificado.
Las capas de funciones se deben configurar en la consola de Cloud.
Si no existe una capa del tipo especificado 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 procesador de Metal. Obtén información sobre cómo habilitar Metal en https://developers.google.com/maps/documentation/ios-sdk/config#use-metal
| - (void) animateToCameraPosition: | (GMSCameraPosition *) | cameraPosition |
Anima la cámara de este mapa en 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: | (float) | zoom |
Como animateToCameraPosition: pero cambia solo el nivel de zoom de la cámara.
Este valor está restringido por [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) animateToBearing: | (CLLocationDirection) | bearing |
Como animateToCameraPosition: pero solo cambia el rumbo de la cámara (en grados).
Cero indica el norte geográfico.
| - (void) animateToViewingAngle: | (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, orientado hacia abajo) y entre 30 y 45 grados hacia el horizonte, según la distancia relativa a la Tierra.
| - (void) animateWithCameraUpdate: | (GMSCameraUpdate *). | cameraUpdate |
Aplica cameraUpdate a la cámara actual y, luego, usa el resultado según animateToCameraPosition:.
Documentación de las funciones de amigos y relacionadas
- (NSString* const) kGMSAccessibilityCompass [related] |
Es el identificador de accesibilidad del botón de brújula.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
Identificador de accesibilidad para el botón “Mi ubicación”.
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Identificador de accesibilidad para la etiqueta de error “fuera de la cuota”.
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 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 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 la cámara se mueva. 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 y el círculo de precisión de Mi ubicació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á inhabilitado o habilitado, pero no hay datos de ubicación disponibles, el valor será nulo. Esta propiedad se puede observar mediante KVO.
- (GMSMarker*) selectedMarker [read, write, assign] |
Es el marcador seleccionado.
Cuando se configura esta propiedad, se selecciona un marcador específico y se muestra una ventana de información. Si esta propiedad no es nula, si se la fija en ese valor, se anulará la selección del marcador y se ocultará la ventana de información. Esta propiedad se puede observar mediante 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 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 diseño del mapa.
Un mapStyle no nulo solo se aplicará si mapType es Normal.
- (flotante) minZoom [read, assign] |
Zoom mínimo (es posible que la cámara se aleje a la mayor distancia).
La configuración predeterminada es kGMSMinZoomLevel. Modificado con -setMinZoom:maxZoom:.
- (flotante) maxZoom [read, assign] |
Zoom máximo (lo más cerca que esté la cámara de 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 donde estén disponibles.
La configuración predeterminada es YES.
Esto puede resultar útil al agregar una capa de mosaicos personalizados al mapa para que se vea más claro a altos niveles de zoom. Si cambias este valor, se invalidarán brevemente todos los mosaicos.
- (BOOL) indoorEnabled [read, write, assign] |
Establece si se muestran los 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 memorias caché de los 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 pantalla de datos de interiores.
- (GMSUISettings*) configuración [read, assign] |
Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario del mapa.
- (UIEdgeInsets) padding [read, write, assign] |
Controla la región "visible" de la vista.
Cuando se aplica padding, se puede crear un área alrededor del borde de la vista que contendrá datos del mapa pero no contendrá 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 tengan en cuenta este relleno y cualquier padding solicitado.
Esta propiedad puede animarse dentro de un bloque de animación basado en UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
Controla cómo se agregan las inserciones del área segura a los valores de padding.
Al igual que con los paddings, las inserciones de áreas seguras colocan los controles del mapa, como la brújula, el botón Mi ubicación y el selector de piso, dentro del área segura del dispositivo.
La configuración predeterminada es kGMSMapViewPaddingAdjustBehaviorAlways.
- (BOOL) accessibilityElementsHidden [read, write, assign] |
La configuración predeterminada es YES.
Si se establece en NO, GMSMapView generará elementos de accesibilidad para objetos superpuestos, como GMSMarker y GMSPolyline.
Esta propiedad sigue el protocolo informal UIAccessibility, excepto por el valor predeterminado de YES.
- (GMSMapLayer*) capa [read, retain] |
Descriptor de 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.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign]; |
Todas las funciones con disponibilidad condicional (que dependen de mapID o de otra configuración del mapa) que están disponibles en el momento actual.
No incluye las funciones que están siempre disponibles.