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 públicas de los miembros | |
| (tipo de instancia) | - init |
| Inicializa con CGRectZero y las opciones predeterminadas. | |
| (tipo de instancia) | - initWithOptions: |
| Crea una nueva vista de mapa con las opciones proporcionadas. | |
| (tipo de instancia) | - initWithFrame: |
| (tipo de instancia anulable) | - initWithCoder: |
| (tipo de instancia) | - initWithFrame:camera: |
| Compila y muestra una vista de mapa con un objetivo de fotograma y 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 cámara. | |
| (void) | - startRendering |
| Indica a este mapa que potencie su procesador. | |
| (void) | - stopRendering |
| Indica a este mapa que apague su procesador. | |
| (void) | - Borrar |
| Borra todas las marcas que se hayan agregado al mapa, incluidos los marcadores, las polilíneas y las superposiciones de suelo. | |
| (void) | - setMinZoom:maxZoom: |
Establece 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 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. | |
| (void) | - animateToCameraPosition: |
Anima la cámara de este mapa a 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: |
| As animateToCameraPosition: Sin embargo, solo cambia el nivel de zoom de la cámara. | |
| (void) | - animateToBearing: |
| Debe ser animateToCameraPosition: pero solo cambia el rumbo de la cámara (en grados). | |
| (void) | - animateToViewingAngle: |
| As animateToCameraPosition: Sin embargo, 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 estáticas de miembros | |
| (tipo de instancia) | + mapWithFrame:camera: |
| Compila y muestra una vista de mapa con un fotograma y un objetivo de cámara. | |
| (tipo de instancia) | + 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. | |
| BOOL | myLocationEnabled |
| 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. | |
| BOOL | trafficEnabled |
| Controla si el mapa genera datos de tráfico, si están disponibles. | |
| GMSMapViewType | mapType |
| Controla el tipo de mosaicos de mapa que se deben mostrar. | |
| GMSMapStyle * | mapStyle |
| Controla el diseño del mapa. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| Cambia el mapa al UIUserInterfaceStyle deseado. | |
| float | minZoom |
| Zoom mínimo (es posible que se aleje la cámara más alejada). | |
| float | maxZoom |
| Zoom máximo (lo más cercano posible a la Tierra) | |
| BOOL | buildingsEnabled |
| Si la estableces, se mostrarán los edificios 3D cuando estén disponibles. | |
| BOOL | indoorEnabled |
| 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. | |
| UIEdgeInsets | padding |
| Controla la región "visible" de la vista. | |
| GMSMapViewPaddingAdjustmentBehavior | paddingAdjustmentBehavior |
| Controla cómo se agregan las inserciones de área segura a los valores de padding. | |
| BOOL | accessibilityElementsHidden |
| La configuración predeterminada es YES. | |
| GMSMapLayer * | capa |
| 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 (según el ID de mapa u otra configuración de mapa) que se encuentran disponibles en el momento actual. | |
Funciones relacionadas | |
(Ten en cuenta que estas no son funciones de los miembros). | |
| NSString *const | kGMSAccessibilityCompass |
| Identificador de accesibilidad para el botón de brújula. | |
| NSString *const | kGMSAccessibilityMyLocation |
| Es el identificador de accesibilidad del botón “mi ubicación”. | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| Es el identificador de accesibilidad de la etiqueta de error de "fuera de la cuota". | |
Documentación de la función de miembro
| - (tipo de instancia) init |
Inicializa con CGRectZero y las opciones predeterminadas.
| - (instancetype) initWithOptions: | (GMSMapViewOptions no nulo *) | 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 | |
| ID de mapa: | (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 | |
| ID de mapa: | (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: | (float) | minZoom | |
| maxZoom: | (float) | 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.
| - (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 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.
| - (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 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 valor 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
| - (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
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 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: | (float) | zoom |
As animateToCameraPosition: Sin embargo, solo cambia el nivel de zoom de la cámara.
Este valor está restringido por [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (void) animateToBearing: | (CLLocationAddress) | 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:
Documentación de la función de amigos y relacionadas
- (NSString* const) kGMSAccessibilityCompass [related] |
Identificador de accesibilidad para el botón de brújula.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
Es el identificador de accesibilidad del botón “mi ubicación”.
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
Es el identificador de accesibilidad de la etiqueta de error de "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 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 o el siguiente fotograma, cuando se configuró explícitamente la cámara o el mapa se acaba de crear. 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 a la UIUserInterfaceStyle deseada.
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 la región "visible" 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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
Todas las funciones con disponibilidad condicional (según el ID de mapa u otra configuración de mapa) que se encuentran disponibles en el momento actual.
No incluye las funciones siempre disponibles.