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. | |
GMSCameraPosition* | camera |
Controla la cámara, que define la orientación del mapa. | |
GMSProjection | projection |
Muestra un objeto GMSProjection que puedes usar para la conversión entre coordenadas de pantalla y coordenadas de latitud y longitud. | |
BOOL | miUbicació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. | |
GMSMarker* | Marcador seleccionado |
Marcador seleccionado | |
BOOL | trafficEnabled |
Controla si el mapa está dibujando 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 estilo del mapa. | |
flotante | mín.Zoom |
Zoom mínimo (a lo más se puede alejar la cámara) | |
flotante | maxZoom |
Zoom máximo (lo más cerca posible de la cámara a la Tierra) | |
BOOL | edificiosHabilitado |
Si la estableces, se mostrarán los edificios 3D disponibles. | |
BOOL | para interiores |
Permite establecer si se mostrarán mapas de interiores, cuando estén disponibles. | |
GMSIndoorDisplay* | para interiores |
Obtiene la instancia GMSIndoorDisplay que permite observar o controlar los aspectos de la visualización de los datos de interiores. | |
GMSUISettings * | configuración |
Obtiene el objeto GMSUISettings, que controla la configuración de la interfaz de usuario para el mapa. | |
Inserciones de UIEdge | relleno |
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 en la capa. | |
GMSFrameRate | preferredFrameRate |
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. | |
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 |
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.
Documentación sobre Amigos y Funciones Relacionadas
- (NSString* const) kGMSAccessibilityCompass [related] |
Identificador de accesibilidad para el botón de brújula
- (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.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] |
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 se basa en 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 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.