Regolare la videocamera

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

  • 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 fotocamera insieme ad altre proprietà, 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 successivi 45 minuti di tempo di guida), eseguendo la panoramica e lo zoom in base alle esigenze per adattare il percorso alla visualizzazione della mappa. Quando questa visualizzazione è selezionata, viene visualizzato il pulsante Ricentra.

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, mostrando la sua posizione attuale all'interno del percorso. In questa modalità della videocamera, puoi visualizzare il percorso con l'auto sempre rivolta verso l'alto sullo schermo con una prospettiva angolata (CameraPerspective.TILTED) oppure puoi vedere l'auto che viaggia con il nord (CameraPerspective.TOP_DOWN_NORTH_UP) o con la direzione (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 fotocamera. In questa modalità, posizioni la videocamera in una posizione specifica, assegni un orientamento per la visuale della videocamera, 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 fotocamera.

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 la modalità di panoramica del percorso

L'impostazione della videocamera showRouteOverview mostra l'intero percorso. Per i percorsi 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 Personalizza la UI di navigazione.