Ajustar la cámara

La cámara te permite cambiar el punto de vista del usuario del mapa. Puedes utilizar los modos de cámara para controlar el comportamiento de la vista de mapa durante la navegación. Para configurar el modo de la cámara, llama a uno de los siguientes métodos asociados con la cámara:

• Seguir mi ubicación (GoogleMap.followMyLocation): Es el modo de cámara predeterminado para la navegación. Este modo establece la cámara en el dispositivo o vehículo. Durante la navegación, la cámara apunta automáticamente en la dirección de desplazamiento. Si habilitas la configuración de alto nivel de detalle (NavigationMapStyle.HIGH_DETAIL), los contornos de los edificios en 2D se mostrarán cuando el nivel de zoom sea 19 o superior.

• Fijado en la ubicación (GoogleMap.animateCamera y GoogleMap.moveCamera): Fija la cámara en una ubicación específica. Cuando usas este modo, puedes configurar la ubicación de la cámara junto con otras propiedades de la cámara, como el rumbo, la inclinación, el zoom, etc. Cuando se selecciona esta vista y se inicializa Navigator, se muestra el botón Volver a centrar.

• Mostrar descripción general de la ruta (NavigationView.showRouteOverview o SupportNavigationFragment.showRouteOverview): Muestra una descripción general de la ruta restante con desplazamiento lateral y zoom según sea necesario para ajustarla a la vista de mapa. Cuando se selecciona esta vista, se puede ver el botón Volver a centrar.

Cuando haces clic en el botón Volver a centrar, la cámara activa el modo followMyLocation.

Seguir mi modo de ubicación

El parámetro de configuración de cámara más común es hacer que la cámara se configure en el dispositivo o vehículo, y muestre su posición actual en el viaje. En este modo de cámara, puedes ver la ruta con el automóvil siempre hacia arriba en la pantalla con una perspectiva angular (CameraPerspective.TILTED), o bien con el automóvil viajando hacia el norte (CameraPerspective.TOP_DOWN_NORTH_UP) o con la orientación (CameraPerspective.TOP_DOWN_HEADING_UP) siempre en la parte superior de la pantalla).

En el siguiente fragmento de código, se usa la perspectiva TILTED:

// Set the camera to follow the device (vehicle):
mNavFragment.getMapAsync(googleMap -> googleMap.followMyLocation(CameraPerspective.TILTED))

Fijado en el Modo de ubicación

El modo Pinned te proporciona el mayor control de la cámara. En este modo, colocas la cámara en una ubicación específica, asignas una orientación para orientar la vista de la cámara, cambias la inclinación para configurar el ángulo de visión y ajustas el nivel de zoom de la cámara.

En el siguiente fragmento de código, se muestran algunas de las formas comunes de mover la cámara.

private static final LatLng SYDNEY = new LatLng(-33.88, 151.21);
private static final LatLng MOUNTAIN_VIEW = new LatLng(37.4, -122.1);

private GoogleMap map;
... // Obtain the map from a SupportNavigationFragment or NavigationView.

// Move the camera instantly to Sydney with a zoom of 15.
map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, 15));

// Zoom in, animating the camera.
map.animateCamera(CameraUpdateFactory.zoomIn());

// Zoom out to zoom level 10, animating with a duration of 2 seconds.
map.animateCamera(CameraUpdateFactory.zoomTo(10), 2000, null);

// Construct a CameraPosition focusing on Mountain View and animate the camera to that position.
CameraPosition cameraPosition = new CameraPosition.Builder()
    .target(MOUNTAIN_VIEW)      // Sets the center of the map to Mountain View
    .zoom(17)                   // Sets the zoom
    .bearing(90)                // Sets the orientation of the camera to east
    .tilt(30)                   // Sets the tilt of the camera to 30 degrees
    .build();                   // Creates a CameraPosition from the builder
map.animateCamera(CameraUpdateFactory.newCameraPosition(cameraPosition));

Mostrar el modo de resumen de la ruta

El parámetro de configuración de la cámara showRouteOverview muestra todo el recorrido. Para los viajes con varios destinos, este modo muestra la parte no transitada de la ruta.

// Place the camera to see the remaining route:
mNavFragment.showRouteOverview();

Configuración de detalles altos

Cuando se habilita esta opción, se muestran los contornos de los edificios en 2D cuando el nivel de zoom de la cámara se establece en 19 o en un valor superior. Puedes anular el nivel de zoom durante la navegación usando un objeto FollowMyLocationOptions. De esta manera, puedes aumentar el nivel de zoom lo suficiente como para mostrar contornos de los edificios en 2D a medida que el usuario se acerca a su destino.

En este ejemplo, se habilita el parámetro de configuración de alto nivel de detalle:

  navigationView.setNavigationMapStyle(NavigationMapStyle.HIGH_DETAIL);

En el siguiente ejemplo, se anula el nivel de zoom de la cámara durante la navegación. El nivel de zoom se estableció en 15, lo cual es lo suficientemente alto como para mostrar contornos de edificios en 2D.

  googleMap.followMyLocation(
              FollowMyLocationOptions.builder(CameraPerspective.TILTED)
                      .setZoomLevel(15.0f)
                      .build());

Próximo paso

Consulta Cómo personalizar la IU de Navigation para obtener información sobre cómo personalizar la forma en que los usuarios interactúan con tu mapa. Para ello, determina qué componentes integrados de la IU aparecen en el mapa.