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 è rivolta 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, zoom e così via. Quando questa visualizzazione è selezionata e il navigatore è stato inizializzato, il pulsante Ricentra è visibile.

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

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

Segui la modalità di geolocalizzazione

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 la direzione (CameraPerspective.TOP_DOWN_HEADING_UP) sempre in alto 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à posizione

La modalità Pinned ti offre il massimo controllo della videocamera. In questa modalità, posizioni la videocamera in un luogo specifico, assegni un orientamento per orientare 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 telecamera.

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

Mostra modalità panoramica 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

Consulta Personalizzare l'interfaccia utente di navigazione per scoprire come personalizzare il modo in cui gli utenti interagiscono con la tua mappa determinando quali componenti dell'interfaccia utente integrata vengono visualizzati sulla mappa.