A câmera permite mudar o ponto de vista do usuário no mapa. Você pode usar os modos de câmera para controlar o comportamento da visualização de mapa durante a navegação. Para definir o modo da câmera, chame um dos seguintes métodos associados a ela:
Seguir meu local (
GoogleMap.followMyLocation
): o modo de câmera padrão para navegação. Este modo define a câmera para o dispositivo ou veículo. Durante a navegação, a câmera fica voltada automaticamente para a direção da viagem. Quando a configuração de detalhes altos está ativada (NavigationMapStyle.HIGH_DETAIL
), os contornos de edifícios em 2D aparecem quando o nível de zoom é 19 ou maior.Fixado no local (
GoogleMap.animateCamera
eGoogleMap.moveCamera
): a câmera é fixada 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 navegador é inicializado, o botão Recentralizar fica visível.Mostrar visão geral do trajeto (
NavigationView.showRouteOverview
ouSupportNavigationFragment.showRouteOverview
): mostra uma visão geral do trajeto restante, movimentando e aplicando zoom conforme necessário para ajustar o trajeto na visualização de mapa. Quando essa visualização é selecionada, o botão Re-center fica visível.
Clicar no botão Recentralizar coloca a câmera no modo followMyLocation
.
Seguir meu modo de localização
A configuração mais comum é definir a câmera como o dispositivo ou veículo, mostrando a posição atual dele no percurso. No
modo de câmera, é possível conferir o trajeto com o carro sempre virado para cima
na tela com uma perspectiva inclinada (CameraPerspective.TILTED
) ou
com 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 a seguir usa a perspectiva TILTED
:
// Set the camera to follow the device (vehicle):
mNavFragment.getMapAsync(googleMap -> googleMap.followMyLocation(CameraPerspective.TILTED))
Fixado no modo de localização
O modo Pinned
oferece o máximo de controle sobre a
câmera. Nesse modo, você coloca a câmera em um local específico, atribui um rolamento 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 maneiras 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 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 não percorrida do trajeto.
// Place the camera to see the remaining route:
mNavFragment.showRouteOverview();
Configuração de detalhes altos
Quando a configuração de muitos detalhes está ativada, os contornos de edifícios em 2D são mostrados
quando o nível de zoom da câmera está definido como 19 ou maior. Você pode modificar 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 contornos de construções em 2D à medida que o usuário se aproxima do destino.
Este exemplo ativa a configuração de muitos detalhes:
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 é definido como 15, que é alto o suficiente para mostrar contornos de edifícios em 2D.
googleMap.followMyLocation(
FollowMyLocationOptions.builder(CameraPerspective.TILTED)
.setZoomLevel(15.0f)
.build());
Próxima etapa
Consulte Personalizar a interface de navegação para saber como os usuários interagem com o mapa determinando quais componentes integrados da interface aparecem no mapa.