Regolare la videocamera

La videocamera ti consente di modificare il punto di vista dell'utente sulla mappa. Puoi utilizzare le modalità della videocamera per controllare il comportamento della visualizzazione della mappa durante la navigazione. Per impostare la modalità della videocamera, chiama uno dei seguenti metodi associati alla videocamera:

  • Segui la mia posizione (GoogleMap.followMyLocation): la modalità fotocamera predefinita per la navigazione. Questa modalità imposta la videocamera sul dispositivo o sul veicolo. Durante la navigazione, la videocamera si orienta automaticamente nella direzione di marcia.

  • Fissata alla posizione (GoogleMap.animateCamera e GoogleMap.moveCamera): fissa la videocamera in una posizione specifica. Quando utilizzi questa modalità, puoi impostare la posizione della videocamera insieme ad altre proprietà della videocamera, come orientamento, inclinazione e zoom. Quando questa visualizzazione è selezionata e il navigatore è stato inizializzato, il pulsante Ricentra è visibile.

  • Mostra panoramica del percorso (NavigationView.showRouteOverview o NavigationFragment.showRouteOverview): mostra una panoramica del percorso rimanente (fino ai prossimi 45 minuti di tempo di guida), con panoramica e zoom in base alle necessità per adattare il percorso alla visualizzazione mappa. Quando questa visualizzazione è selezionata, il pulsante Ricentra è visibile.

Se fai clic sul pulsante Ricentra, la videocamera viene impostata sulla modalità followMyLocation.

Modalità Segui la mia posizione

L'impostazione più comune della videocamera è quella di impostarla sul dispositivo o sul veicolo, in modo da mostrare la sua posizione attuale durante il viaggio. In questa modalità della videocamera, puoi visualizzare il percorso con l'auto sempre rivolta verso l'alto dello schermo con una prospettiva angolata (CameraPerspective.TILTED) oppure puoi vedere l'auto che si sposta con il nord (CameraPerspective.TOP_DOWN_NORTH_UP) o con l'orientamento (CameraPerspective.TOP_DOWN_HEADING_UP) sempre nella parte superiore dello schermo.

Il seguente frammento di codice utilizza la prospettiva TILTED:

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

Bloccato in modalità di localizzazione

La modalità Pinned ti offre il massimo controllo della videocamera. In questa modalità, posizioni la videocamera in un punto specifico, assegni un orientamento per regolare l'inquadratura, modifichi l'inclinazione per impostare l'angolo di visione e imposti il livello di zoom della videocamera.

Il seguente snippet di codice mostra alcuni dei modi più comuni per spostare la videocamera.

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 NavigationFragment 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));

Mostra modalità panoramica del percorso

L'impostazione della videocamera showRouteOverview mostra l'intero viaggio. Per i viaggi con più destinazioni, questa modalità mostra la parte del percorso non ancora percorsa.

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

Passaggio successivo

Per saperne di più sulla configurazione dei componenti UI integrati, consulta Personalizzare la UI di navigazione.