Modalità Lite

L'SDK Maps per Android può pubblicare un'immagine bitmap di una mappa, offrendo una interattività limitata all'utente. Questa è chiamata mappa in modalità Lite.

Esempi di codice

Il repository APIApis su GitHub include esempi che mostrano l'uso della modalità lite:

Panoramica della modalità Lite

Una mappa in modalità Lite è un'immagine bitmap di una mappa in una posizione e a livello di zoom specificati. La modalità Lite supporta tutti i tipi di mappa (normale, ibrido, satellite, rilievo) e un sottoinsieme della funzionalità fornita dall'API completa. La modalità Lite è utile quando vuoi fornire più mappe in uno stream o una mappa troppo piccola per supportare un'interazione significativa.

Gli utenti che visualizzano la mappa non possono eseguire lo zoom o eseguire una panoramica. Le icone sulla mappa consentono agli utenti di visualizzare la mappa nell'app Google Maps per dispositivi mobili e di richiedere le indicazioni stradali.

Aggiungere una mappa in modalità Lite

La modalità Lite utilizza le stesse classi e interfacce dell'API completa di Google Maps per Android. Puoi impostare una GoogleMap in modalità Lite nei seguenti modi:

  • Come attributo XML di MapView o MapFragment
  • Oppure nell'oggetto GoogleMapOptions

Come attributo XML di MapView o MapFragment

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.gms.maps.MapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:cameraZoom="13"
    map:mapType="normal"
    map:liteMode="true"/>

Nell'oggetto GoogleMapOptions

Java


GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

Kotlin


val options = GoogleMapOptions()
    .liteMode(true)

      

Per dettagli sull'impostazione dello stato iniziale della mappa, consulta la guida all'oggetto mappa.

Intenzione di lanciare una visualizzazione mappa o una richiesta di indicazioni stradali

Per impostazione predefinita, una barra degli strumenti in basso a destra nella mappa contiene icone che forniscono l'accesso a una visualizzazione mappa o a una richiesta di indicazioni stradali nell'app Google Maps per dispositivi mobili. Puoi disattivare la barra degli strumenti chiamando UiSettings.setMapToolbarEnabled(false). Per ulteriori dettagli, consulta la documentazione della barra degli strumenti.

Inoltre, per impostazione predefinita, quando un utente tocca la mappa, l'API avvia l'app per dispositivi mobili di Google Maps. Puoi sostituire questa impostazione utilizzando GoogleMap.setOnMapClickListener() per impostare il tuo listener. Puoi anche disattivare gli eventi di clic sulla mappa chiamando setClickable() nella vista che contiene MapView o MapFragment. Per i dettagli di queste due tecniche, consulta la documentazione degli eventi.

Eventi del ciclo di vita

Quando si utilizza l'API in modalità completamente interattiva, gli utenti della classe MapView devono inoltrare tutti i metodi del ciclo di vita delle attività ai metodi corrispondenti nella classe MapView. Esempi di metodi del ciclo di vita sono onCreate(), onDestroy(), onResume() e onPause().

Quando si utilizza la classe MapView in modalità Lite, l'inoltro di eventi del ciclo di vita è facoltativo, ad eccezione delle seguenti situazioni:

  • È obbligatorio chiamare onCreate(), altrimenti non verrà visualizzata alcuna mappa.
  • Se vuoi mostrare il punto La mia posizione sulla mappa in modalità Lite e utilizzare l'origine posizione predefinita, devi chiamare onResume() e onPause(), perché l'origine posizione verrà aggiornata solo tra queste chiamate. Se utilizzi una tua origine località, non è necessario chiamare questi due metodi.

Funzionalità API supportate

La seguente tabella descrive il comportamento di una mappa in modalità Lite per ogni area di funzionalità API. Se un'app chiama un metodo non supportato in modalità Lite, l'API registrerà un messaggio.

Funzionalità
Tipi di mappa
Supportato?
I seguenti tipi di mappa sono disponibili tramite GoogleMapOptions.mapType() e GoogleMap.setMapType(): MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN, MAP_TYPE_HYBRID, MAP_TYPE_NONE
Polilinee, poligoni, cerchi
Supportato?
La funzionalità in modalità Lite di shapes corrisponde all'API completa.
Projection
Supportato?
La funzionalità in modalità Lite di Projection corrisponde all'API completa.
La mia posizione
Supportato?
La funzionalità in modalità Lite per il livello La mia posizione corrisponde all'API completa.
Spaziatura interna mappa
Supportato?
Il supporto della modalità lite per la Spaziatura interna mappa corrisponde all'API completa.
Finestre informative
Supportato?
Se imposti una title() per un indicatore, quando l'utente tocca l'indicatore viene visualizzata la finestra informativa predefinita. Puoi mostrare la finestra informativa in modo programmatico chiamando showInfoWindow() sull'indicatore. Puoi anche creare finestre informative personalizzate tramite l'interfaccia di InfoWindowAdapter.
Stili personalizzati della mappa base
Supportato? In parte
L'SDK Maps per Android supporta lo stile personalizzato della mappa base. La modalità Lite supporta solo gli stili personalizzati basati su JSON, non basati su cloud, che richiedono un ID mappa per visualizzare una mappa con stile.
Indicatori
Supportato? In parte
Puoi aggiungere un indicatore e rispondere a un evento di clic. Puoi anche aggiungere icone di indicatori personalizzati. Non è possibile trascinare un indicatore. Gli indicatori su una mappa in modalità Lite sono piatti e non possono essere ruotati.
Posizione della fotocamera, zoom e animazione
Supportato? In parte

Puoi impostare il target della fotocamera e lo zoom, ma non l'inclinazione o il supporto. Il livello di zoom è arrotondato al numero intero più vicino in modalità Lite. Chiamando GoogleMap.moveCamera() riceverai un'altra immagine della mappa in modalità Lite. Per scoprire di più sull'impostazione e sulla gestione della videocamera, consulta Cambiare la vista.

La chiamata a GoogleMap.animateCamera() non comporterà l'animazione del movimento della videocamera. La visualizzazione della fotocamera si sposta immediatamente nella nuova posizione.

Mappare gli eventi
Supportato? In parte

La modalità Lite supporta GoogleMap.setOnMapClickListener() e GoogleMap.setOnMapLongClickListener().

Per disattivare gli eventi di clic su una mappa in modalità Lite, puoi chiamare setClickable() nella vista che contiene MapView o MapFragment. Questo è utile, ad esempio, quando si mostra una mappa o mappe in una visualizzazione elenco, dove vuoi che l'evento clic richiami un'azione non correlata alla mappa.

Per maggiori dettagli, consulta la documentazione relativa agli eventi.

Mappe ed edifici per interni
Supportato? No
La modalità Lite mostra gli stessi riquadri dell'API Maps Static. Ciò significa che se la planimetria interna è integrata nel riquadro predefinito, verrà visualizzata. In caso contrario, no. Inoltre, non puoi modificare il livello mostrato o manipolare un selettore di livelli.
Livello traffico
Supportato? No
GoogleMap.setTrafficEnabled() non è supportato in modalità Lite.
Overlay del suolo
Supportato? No
GoogleMap.addGroundOverlay() non è supportato in modalità Lite.
Overlay riquadro
Supportato? No
GoogleMap.addTileOverlay() non è supportato in modalità Lite.
Gesti
Supportato? No
La modalità Lite non supporta i gesti. L'attivazione e la disattivazione dei gesti non avranno effetto.
Street View
Supportato? No
Street View non è supportato in modalità Lite.