Ajustar a câmera

A câmera permite mudar o ponto de vista do usuário do mapa. Você pode usar os modos da câmera para controlar o comportamento da visualização do mapa durante a navegação. Para definir o modo da câmera, chame um dos seguintes métodos associados à câmera:

• Seguir meu local (GoogleMap.followMyLocation): o modo de câmera padrão para navegação. Esse modo define a câmera para o dispositivo ou veículo. Durante o trajeto, a câmera aponta automaticamente para a direção de viagem. Quando a configuração de detalhes altos está ativada (NavigationMapStyle.HIGH_DETAIL), os contornos de edifícios 2D são mostrados quando o nível de zoom é 19 ou mais recente.

• Fixado no local (GoogleMap.animateCamera e GoogleMap.moveCamera) — fixa a câmera em um local específico. Ao usar esse modo, você pode definir a localização da câmera com outras propriedades, como direção, inclinação, zoom etc. Quando essa visualização é selecionada e o Navigator é inicializado, o botão Re-center fica visível.

• Mostrar visão geral da rota (NavigationView.showRouteOverview ou SupportNavigationFragment.showRouteOverview): mostra uma visão geral da rota restante, movendo e aplicando zoom conforme necessário para ajustar a rota à visualização do mapa. Quando essa visualização é selecionada, o botão Re-center fica visível.

Clicar no botão Re-center define a câmera no modo followMyLocation.

Modo "Seguir minha localização"

A configuração mais comum é definir a câmera para o dispositivo ou veículo, mostrando a posição atual dele na viagem. Nesse modo de câmera, é possível ver o trajeto com o carro sempre na parte de cima da tela com uma perspectiva angular (CameraPerspective.TILTED) ou com o carro viajando para o norte (CameraPerspective.TOP_DOWN_NORTH_UP) ou com a direção (CameraPerspective.TOP_DOWN_HEADING_UP) sempre na parte de cima da tela.

O fragmento de código abaixo usa a perspectiva TILTED:

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

Modo de localização fixado

O modo Pinned oferece mais controle sobre a câmera. Nesse modo, você coloca a câmera em um local específico, atribui uma direção para orientar a visualização da câmera, muda a inclinação para definir o ângulo de visão e define o nível de zoom da câmera.

O snippet de código a seguir demonstra algumas das formas comuns de mover a câmera.

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 o modo de visão geral do trajeto

A configuração da câmera showRouteOverview mostra toda a jornada. Para viagens com vários destinos, esse modo mostra a parte da rota que não foi percorrida.

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

Configuração de detalhes altos

Quando a configuração de detalhes altos está ativada, os contornos de edifícios 2D são mostrados quando o nível de zoom da câmera está definido como 19 ou mais. É possível substituir o nível de zoom durante a navegação usando um objeto FollowMyLocationOptions. Isso permite aumentar o nível de zoom o suficiente para mostrar os contornos de edifícios em 2D à medida que o usuário se aproxima do destino.

Este exemplo ativa a configuração de detalhes altos:

  navigationView.setNavigationMapStyle(NavigationMapStyle.HIGH_DETAIL);

O exemplo a seguir substitui o nível de zoom da câmera durante a navegação. O nível de zoom está definido como 15, que é alto o suficiente para mostrar contornos de edifícios 2D.

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

Próxima etapa

Consulte Personalizar a interface de navegação para saber como personalizar a forma como os usuários interagem com seu mapa determinando quais componentes integrados da interface aparecem no mapa.