Con el SDK de Maps para iOS, puedes cambiar el punto de vista del usuario del mapa cambiando la cámara del mapa.
Con el SDK de Maps para iOS, tus usuarios pueden inclinar y rotar tus mapas para ajustarlos a una orientación útil para su contexto. Con cualquier nivel de zoom los usuarios pueden desplazarse lateralmente por el mapa o cambiar su perspectiva con muy poca latencia.
Los cambios en la cámara no modifican los marcadores, las polilíneas ni otros gráficos adicionales, aunque es posible que quieras cambiarlas para que se ajusten mejor al vista nueva.
La vista del mapa
El SDK de Maps para iOS utiliza el servicio Mercator proyección para representar la superficie del mundo (una esfera) en la pantalla de tu dispositivo (una superficie plana ).
La posición de la cámara
La vista de mapa responde a un modelo en el cual una cámara apunta hacia abajo sobre un plano. La posición de la cámara (y, por lo tanto, la renderización del mapa) se especifica mediante las siguientes propiedades: objetivo (ubicación de latitud/longitud), rumbo, inclinación y zoom.
Objetivo (ubicación)
El objetivo de la cámara es la ubicación del centro del mapa, especificada como coordenadas de latitud y longitud.
La latitud puede variar entre -85 y 85 grados, inclusive. Los valores superiores o inferiores a este rango se fijarán al valor más cercano dentro de este rango. Por ejemplo, si se especifica una latitud de 100, el valor se fijará en 85. La longitud varía entre -180 y 180 grados, inclusive. Los valores superiores o inferiores a este rango se ajustarán de forma tal que queden dentro del rango (-180, 180). Por ejemplo, 480, 840 y 1200 se ajustarán a 120 grados.Rumbo (orientación)
El rumbo de la cámara especifica la dirección de la brújula, medida en grados a partir del norte verdadero, que corresponde al borde superior del mapa. Si dibujas una línea vertical desde el centro del mapa hasta el borde superior del mapa, el rumbo corresponde a la orientación de la cámara (medida en grados) en relación con el norte verdadero.
Un rumbo igual a 0 significa que la parte superior del mapa apunta al norte verdadero. Un valor de rumbo igual a 90 significa que la parte superior del mapa apunta hacia el este (90 grados en una brújula). Un valor igual a 180 significa que la parte superior del mapa apunta al sur.
La API de Google Maps te permite cambiar el rumbo de un mapa. Quienes conducen un auto a menudo giran el mapa de la ruta para alinearlo con la dirección en la que se desplazan, mientras que los senderistas que usan mapas y brújula suelen orientar los mapas de modo que la línea vertical apunte hacia el norte.
Inclinación (ángulo de visión)
La inclinación es la posición de la cámara en un arco directamente sobre la posición central del mapa, medida en grados a partir del nadir (la dirección que apunta justo debajo de la cámara). Un valor igual a 0 corresponde a una cámara que apunta hacia abajo. Los valores superiores a 0 corresponden a una cámara que se inclina hacia el horizonte según la cantidad de grados especificada. Cuando cambias el ángulo de visión, el mapa aparece en perspectiva; los componentes apartados se ven más pequeños y los cercanos, más grandes. En las siguientes ilustraciones se demuestra esto.
En las siguientes imágenes, el ángulo de visión es de 0 grados. En la primera imagen, se muestra un esquema de esto. La posición 1 es la posición de la cámara, y la 2 es la del mapa actual. El mapa resultante se muestra debajo.
 |
 |
En las siguientes imágenes, el ángulo de visión es de 45 grados. Ten en cuenta que la cámara se desplaza a la mitad del trayecto de un arco entre el cénit (0 grados) y el suelo (90 grados), hasta la posición 3. La cámara continúa apuntando hacia el punto central del mapa, pero ahora puede verse el área representada por la línea en la posición 4.
 |
 |
El mapa de esta captura de pantalla continúa centrado en el mismo punto que el mapa original, aunque aparecieron más componentes en la parte superior. A medida que el ángulo supera los 45 grados, los componentes que se encuentran entre la posición del mapa y la cámara tienen un tamaño proporcionalmente mayor, mientras que los componentes que se encuentran más allá de la posición del mapa tienen un tamaño proporcionalmente menor. Esto genera un efecto tridimensional.
Zoom
El nivel de zoom de la cámara determina la escala del mapa. A mayores niveles de zoom pueden observarse más detalles en la pantalla, mientras que a menores niveles de zoom el mundo se ve de manera más abarcadora. En el nivel de zoom 0, la escala del mapa hace que el mundo tenga con un ancho aproximado de 256 puntos.
Un aumento de 1 punto en el nivel de zoom duplica el ancho del mundo en la pantalla. Por lo tanto, con el nivel de zoom N, el ancho del mundo es de aproximadamente 256 * 2N puntos Por ejemplo, en el nivel de zoom 2, el mundo entero es aproximadamente 1,024 puntos de ancho.
No es necesario que el nivel de zoom sea un número entero. El rango de niveles de zoom que permite el mapa depende de varios factores, como el objetivo, el tipo de mapa y el tamaño de la pantalla. Cualquier número que esté fuera del rango se convertirá en el siguiente valor válido más cercano, que puede ser el nivel de zoom mínimo o el nivel de zoom máximo. En la siguiente lista, se muestra el nivel aproximado de detalle que puedes esperar ver en cada nivel de zoom:
- 1: Mundo
- 5: Tierra firme y continente
- 10: Ciudad
- 15: Calles
- 20: Edificios
 |
 |
 |
Establece la posición inicial de la cámara
Establece la posición inicial de la cámara con la tecla
GMSCameraPosition
que te permite establecer la latitud y longitud del objetivo junto con
el rumbo, la inclinación y el zoom.
Para establecer la posición inicial de la cámara, crea un objeto GMSMapViewOptions y configura
la propiedad camera a una GMSCameraPosition. Luego, pasa tus opciones al
GMSMapView
de conveniencia.
Swift
let options = GMSMapViewOptions() options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 16) let mapView = GMSMapView(options:options)
Objective-C
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:16]; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
También puedes crear el objeto GMSMapView con el init predeterminado UIView
. En este caso, la posición de la cámara
comienza en la ubicación predeterminada
cambiarla después de la creación.
Swift
let options = GMSMapViewOptions() options.frame = self.view.bounds let mapView = GMSMapView(options:options)
Objective-C
GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init]; options.frame = self.view.bounds; GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
Cómo cambiar la posición de la cámara
Puedes cambiar de forma programática la posición de la cámara para establecer la ubicación,
el rumbo, la inclinación y el zoom. Si bien GMSMapView proporciona varios métodos que puedes
que puedes usar para cambiar la posición de la cámara, por lo general, usas GMSCameraPosition o
GMSCameraUpdate:
GMSCameraPositioncontiene las propiedades y los métodos que se usan para cambiar cada posición de la cámara parámetro: objetivo, rumbo, inclinación y zoom.GMSCameraUpdatete permite cambiar el objetivo, el rumbo, la inclinación y el zoom, y también convenientes para admitir el desplazamiento, el zoom avanzado y centrar la imagen cámara con límites predefinidos y mucho más.
Cuando mueves la cámara, puedes elegir "tomar" la cámara al nuevo de posición, lo que significa que no hay animación o animar el movimiento. Por ejemplo, se anima un cambio a la ubicación objetivo de la cámara, la animación se desplaza desde la ubicación anterior a la nueva.
En la animación se interpolan los atributos actuales y los nuevos de la cámara. Puedes controlar la duración de la animación con Core Animación
Usa GMSCameraPosition
Para cambiar la cámara con
GMSCameraPosition:
crea un objeto nuevo o copia uno existente y, luego, configúralo en la
GMSMapView. Usa el objeto GMSCameraPosition para ajustar la cámara
la nueva ubicación con o sin animación.
Usa un objeto GMSCameraPosition para configurar las propiedades de la cámara, como
latitud, longitud, zoom, rumbo y ángulo de visión. Luego, usarás ese objeto
para configurar la propiedad camera de GMSMapView.
Swift
let fancy = GMSCameraPosition( latitude: -33, longitude: 151, zoom: 6, bearing: 270, viewingAngle: 45 ) mapView.camera = fancy
Objective-C
GMSCameraPosition *fancy = [GMSCameraPosition cameraWithLatitude:-33.8683 longitude:151.2086 zoom:6 bearing:30 viewingAngle:45]; [mapView setCamera:fancy];
Omite cualquier propiedad GMSCameraPosition que quieras establecer con su valor predeterminado.
Para animar el movimiento, usa el método animateToCameraPosition: en lugar de
configurando la propiedad camera.
Usa GMSCameraUpdate
GMSCameraUpdate
te permite actualizar la posición de la cámara y elegir si deseas ajustar o animar
a ese nuevo puesto. La ventaja de GMSCameraUpdate es la conveniencia. Puedes
usar GMSCameraPosition para realizar las mismas tareas que GMSCameraUpdate, pero
GMSCameraUpdate proporciona métodos auxiliares adicionales para que sea más fácil
manipular la cámara.
Por ejemplo, si deseas usar GMSCameraPosition para aumentar el nivel de zoom actual, debes
primero tendrás que determinar el nivel de zoom actual y, luego, crear una
Un objeto GMSCameraPosition en el que estableces el zoom en un valor mayor que
el zoom actual.
También puedes construir un objeto GMSCameraUpdate con el método zoomIn:.
Luego, actualiza la cámara pasando el objeto GMSCameraUpdate al
GMSMapView animateWithCameraUpdate:.
Swift
// Zoom in one zoom level let zoomCamera = GMSCameraUpdate.zoomIn() mapView.animate(with: zoomCamera)
Objective-C
// Zoom in one zoom level GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn]; [mapView animateWithCameraUpdate:zoomCamera];
Usa el método GMSMapView moveCamera: para ajustar la cámara a la nueva posición.
en su lugar.
En el siguiente ejemplo, usarás GMSCameraUpdate para animar un movimiento de la cámara.
para centrarlo en Vancouver.
Swift
// Center the camera on Vancouver, Canada let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11) let vancouverCam = GMSCameraUpdate.setTarget(vancouver) mapView.animate(with: vancouverCam)
Objective-C
// Center the camera on Vancouver, Canada CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11); GMSCameraUpdate *vancouverCam = [GMSCameraUpdate setTarget:vancouver]; [mapView animateWithCameraUpdate:vancouverCam];
Construye un objeto GMSCameraUpdate
Construye un objeto GMSCameraUpdate mediante uno de sus métodos.
zoomIn:yzoomOut:- Cambiar el nivel de zoom en un 1.0 sin modificar todas las demás propiedades son iguales.
zoomTo:- Cambia el nivel de zoom conforme al valor especificado y mantiene todos los demás propiedades de la misma forma.
zoomBy:- Aumenta el nivel de zoom (o lo disminuye, si el valor es negativo). por el valor dado.
zoomBy:atPoint:- Aumenta (o disminuye, si el valor es negativo) la nivel de zoom según el valor especificado y, al mismo tiempo, se retiene el valor del punto especificado posición en la pantalla.
setTarget:- Cambia la latitud y longitud de la cámara y, al mismo tiempo, se mantiene todas las demás propiedades.
setTarget:zoom:- Cambia la latitud, la longitud y el zoom de la cámara, y y preservar todas las demás propiedades.
setCamera:- Establece un nuevo
GMSCameraPosition. scrollByX:Y:- Cambia la latitud y longitud de la cámara para mover el mapa por el número de puntos especificado. Un valor X positivo causa la mover la cámara hacia la derecha, de modo que el mapa parezca desplazarse izquierda. Un valor de "y" positivo hace que la cámara se desplace hacia abajo, de modo que el mapa parece que se movió hacia arriba. El desplazamiento es relativo al estado la carga de trabajo. Por ejemplo, si la cámara tiene un rumbo de 90 grados, entonces el este es “arriba”.
fitBounds:- Transforma la cámara para centrar los límites especificados en la pantalla en el mayor nivel de zoom posible. Aplica un valor predeterminado un padding a los límites de 64 puntos.
fitBounds:withPadding:- Transforma la cámara para centrar los límites especificados en la pantalla con el máximo nivel de zoom posible. Usa este método para especificar el mismo relleno en puntos para todos los lados del cuadro delimitador.
fitBounds:withEdgeInsets:- Transforma la cámara para centrar los límites especificados en la
pantalla con el máximo nivel de zoom posible. Con
UIEdgeInsets, especificas el relleno para cada lado del cuadro de límite de manera independiente.
Usa GMSMapView para cambiar una sola propiedad
GMSMapView
proporciona varios métodos que te permiten mover la cámara sin usar un
El objeto GMSCameraPosition o el objeto GMSCameraUpdate. Con estos métodos,
como animateToLocation: o animateToZoom:, puedes animar un cambio a una
propiedad de una sola cámara.
Por ejemplo, usa el método toViewingAngle: para animar un cambio en la cámara
y la inclinación.
Swift
mapView.animate(toViewingAngle: 45)
Objective-C
[mapView animateToViewingAngle:45];
Establecer objetivo (ubicación)
La ubicación determina el centro del mapa. Las ubicaciones se especifican mediante
de latitud y longitud, y se representa de forma programática con un
CLLocationCoordinate2D, creada con CLLocationCoordinate2DMake.
Usa GMSCameraPosition para cambiar la ubicación. En este ejemplo, el mapa se ajusta
a la nueva ubicación.
Swift
let target = CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208) mapView.camera = GMSCameraPosition(target: target, zoom: 6)
Objective-C
CLLocationCoordinate2D target = CLLocationCoordinate2DMake(-33.868, 151.208); mapView.camera = [GMSCameraPosition cameraWithTarget:target zoom:6];
Para animar el cambio y desplazar el mapa hasta la nueva ubicación, puedes usar el
animateToCameraPosition: en lugar de configurar la propiedad camera. O bien:
usa el método animateToLocation: en GMSMapView.
Swift
mapView.animate(toLocation: CLLocationCoordinate2D(latitude: -33.868, longitude: 151.208))
Objective-C
[mapView animateToLocation:CLLocationCoordinate2DMake(-33.868, 151.208)];
También puedes crear un objeto GMSCameraUpdate para mover la cámara. Usa su
método incorporado, scrollByX:Y:, para especificar la cantidad de puntos para desplazar la
cámara en la dirección X e Y. En este ejemplo, te desplazas 200 por la cámara
apunta a la derecha y 100 puntos hacia abajo:
Swift
// Move the camera 200 points to the right, and 100 points downwards let downwards = GMSCameraUpdate.scrollBy(x: 200, y: 100) mapView.animate(with: downwards)
Objective-C
// Move the camera 200 points to the right, and 100 points downwards GMSCameraUpdate *downwards = [GMSCameraUpdate scrollByX:200.0 Y:100.0]; [mapView animateWithCameraUpdate:downwards];
Establecer rumbo (orientación)
El rumbo es la dirección de la brújula, medida en grados a partir del norte geográfico, por el borde superior del mapa. Por ejemplo, un rumbo de 90 grados da como resultado un mapa donde el borde superior apunta hacia el este.
Configura el rumbo de manera programática con GMSCameraPosition o GMSCameraUpdate.
o con el método animateToBearing: de GMSMapView.
Swift
mapView.animate(toBearing: 0)
Objective-C
[mapView animateToBearing:0];
Establecer inclinación (ángulo de visión)
El ángulo de visión es la posición de la cámara en un arco entre el punto justo sobre el la posición central del mapa y la superficie de la Tierra, medida en grados a partir de la nadir (la dirección apuntando directamente debajo de la cámara). Cuando cambias el ángulo de visión, el mapa aparece en perspectiva, con características entre la cámara y la posición en el mapa mostrar un tamaño proporcionalmente mayor, y aparecer los componentes que se encuentran fuera de la posición del mapa proporcionalmente más pequeña, lo que produce un efecto tridimensional.
El ángulo de visión puede variar entre 0 (orientación directamente hacia abajo en el mapa) y hasta un máximo dependiente del nivel de zoom. Para el nivel de zoom 16 o superior, el valor máximo es de 65 grados. Para el nivel de zoom 10 o versiones anteriores, el ángulo máximo es de 30 grados.
Configura el ángulo de visión de manera programática con GMSCameraPosition.
GMSCameraUpdate o con el método animateToViewingAngle: de GMSMapView
Swift
mapView.animate(toViewingAngle: 45)
Objective-C
[mapView animateToViewingAngle:45];
Establecer zoom
El nivel de zoom de la cámara determina la escala del mapa. Con un zoom más grande puedes ver más detalles en la pantalla, mientras que, en los niveles de zoom más pequeños, puedan ver más del mundo.
Configura el zoom de manera programática con GMSCameraPosition o GMSCameraUpdate.
con el método animateToZoom: de GMSMapView.
Swift
mapView.animate(toZoom: 12)
Objective-C
[mapView animateToZoom:12];
En el siguiente ejemplo, se usa el método zoomIn: para construir un GMSCameraUpdate
para animar el acercamiento de un nivel desde el nivel actual.
Swift
// Zoom in one zoom level let zoomCamera = GMSCameraUpdate.zoomIn() mapView.animate(with: zoomCamera)
Objective-C
// Zoom in one zoom level GMSCameraUpdate *zoomCamera = [GMSCameraUpdate zoomIn]; [mapView animateWithCameraUpdate:zoomCamera];
Establece límites
Para mover la cámara de modo que se vea un área de interés completa como máximo el nivel de zoom posible y los límites para la vista de la cámara. Por ejemplo, si quiere mostrar todas las gasolineras dentro de un radio de ocho kilómetros alrededor del mueve la cámara para que todos sean visibles en la pantalla:
- Calcula el
GMSCoordinateBoundsque quieres calcular. será visible en la pantalla. - Usa el método
cameraForBounds:insets:deGMSMapViewpara mostrar un valor nuevo.GMSCameraPosition
Configurar estos límites garantiza que el GMSCoordinateBounds dado se ajuste por completo
dentro del tamaño actual del mapa. Ten en cuenta que este método establece la inclinación y el rumbo
del mapa en 0.
En el siguiente ejemplo, se muestra cómo cambiar la cámara para que las ciudades de Vancouver y Calgary aparecen en la misma vista.
Swift
let vancouver = CLLocationCoordinate2D(latitude: 49.26, longitude: -123.11) let calgary = CLLocationCoordinate2D(latitude: 51.05,longitude: -114.05) let bounds = GMSCoordinateBounds(coordinate: vancouver, coordinate: calgary) let camera = mapView.camera(for: bounds, insets: UIEdgeInsets())! mapView.camera = camera
Objective-C
CLLocationCoordinate2D vancouver = CLLocationCoordinate2DMake(49.26, -123.11); CLLocationCoordinate2D calgary = CLLocationCoordinate2DMake(51.05, -114.05); GMSCoordinateBounds *bounds = [[GMSCoordinateBounds alloc] initWithCoordinate:vancouver coordinate:calgary]; GMSCameraPosition *camera = [mapView cameraForBounds:bounds insets:UIEdgeInsetsZero]; mapView.camera = camera;
Restringir el desplazamiento lateral del usuario a un área determinada
En estas situaciones, se establecen los límites del mapa, pero el usuario puede desplazarse vertical o lateralmente. fuera de estos límites. Puedes limitar las coordenadas límites centrales del punto focal del mapa (objetivo de la cámara) para que los usuarios solo pueden desplazarse vertical y lateralmente dentro de estos límites.
Por ejemplo, una app minorista para un centro comercial o un aeropuerto podría querer restringir el mapa a límites específicos, lo que permite a los usuarios desplazarse y desplazarse lateralmente dentro de esos límites.
Para restringir el desplazamiento lateral a límites específicos, establece la propiedad cameraTargetBounds de
GMSMapView a un objeto GMSCoordinateBounds que define los límites requeridos
Para quitar la restricción más adelante, establece cameraTargetBounds en nil.
Swift
mapView.cameraTargetBounds = bounds
Objective-C
mapView.cameraTargetBounds = bounds;
En el siguiente diagrama, se ilustra una situación en la cual el objetivo de la cámara está restringido a un área ligeramente más grande que el viewport. El usuario puede desplazarse vertical o lateralmente, siempre que el objetivo de la cámara permanezca dentro del área limitada. La cruz representa el objetivo de la cámara:
El mapa siempre ocupa por completo el viewport, incluso aunque se terminen mostrando áreas que se encuentren fuera de los límites definidos. Por ejemplo, si ubicas el objetivo de tu cámara en una esquina del área limitada, el área más allá de la esquina se puede ver en el viewport, pero los usuarios no se pueden desplazar hacia ella. En el siguiente diagrama, se ilustra esta situación. La cruz representa el objetivo de la cámara:
En el siguiente diagrama, el objetivo de la cámara tiene límites muy restringidos, lo que ofrece el usuario tiene muy pocas oportunidades de desplazarse lateralmente por el mapa. La cruz representa el objetivo de la cámara:
Cómo establecer un zoom mínimo o máximo
Las constantes globales kGMSMinZoomLevel y kGMSMaxZoomLevel definen la
valores de zoom mínimos o máximos. De forma predeterminada, los valores minZoom y maxZoom
Las propiedades de GMSMapView están configuradas en estas constantes.
Para restringir el intervalo de niveles de zoom disponibles en el mapa, configura un rango mínimo y máximo nivel de zoom. En el siguiente código, se restringe el nivel de zoom a un valor entre 10 y 15.
Swift
let camera = GMSCameraPosition( latitude: 41.887, longitude: -87.622, zoom: 12 ) let mapView = GMSMapView(frame: .zero, camera: camera) mapView.setMinZoom(10, maxZoom: 15)
Objective-C
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:41.887 longitude:-87.622 zoom:12]; GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera]; [mapView setMinZoom:10 maxZoom:15];
Debes establecer el rango de zoom con el método setMinZoom:maxZoom:. Sin embargo,
puede leer los valores actuales con las propiedades minZoom y maxZoom. Esta
es útil cuando se restringe solo uno de los valores. El siguiente código
solo cambia el nivel de zoom mínimo.
Swift
mapView.setMinZoom(12, maxZoom: mapView.maxZoom)
Objective-C
[mapView setMinZoom:12 maxZoom:mapView.maxZoom];
Si, tras actualizar los niveles de zoom mínimo y máximo, el nivel de zoom de la cámara se establece en fuera del rango nuevo, el zoom actual se actualizará automáticamente muestra el valor válido más cercano. Por ejemplo, en el siguiente código, el zoom original se define como 4. Cuando el rango de zoom se fija entre 10 y 15, el valor el zoom actual se actualiza a 10.
Swift
// Sets the zoom level to 4. let camera2 = GMSCameraPosition( latitude: 41.887, longitude: -87.622, zoom: 4 ) let mapView2 = GMSMapView(frame: .zero, camera: camera) // The current zoom, 4, is outside of the range. The zoom will change to 10. mapView.setMinZoom(10, maxZoom: 15)
Objective-C
// Sets the zoom level to 4. GMSCameraPosition *camera2 = [GMSCameraPosition cameraWithLatitude:41.887 longitude:-87.622 zoom:4]; GMSMapView *mapView2 = [GMSMapView mapWithFrame:CGRectZero camera:camera]; // The current zoom, 4, is outside of the range. The zoom will change to 10. [mapView setMinZoom:10 maxZoom:15];