A breve su Google Maps Platform saranno disponibili nuovi stili di mappa. Questo aggiornamento dello stile della mappa include una nuova tavolozza dei colori predefinita e miglioramenti all'usabilità e alle esperienze delle mappe. Tutti gli stili di mappa verranno aggiornati automaticamente a marzo 2025. Per ulteriori informazioni sulla disponibilità e su come attivare la funzionalità in precedenza, consulta la sezione Nuovo stile di mappa per Google Maps Platform.

Questa pagina è stata tradotta dall'API Cloud Translation.

Opzioni mappa Google

pubblica classe finale GoogleMapOptions estende oggetto
implementa Parcelable

Definisce la configurazione GoogleMapOptions per un oggetto GoogleMap. Queste opzioni possono essere utilizzate quando aggiungi una mappa all'applicazione in modo programmatico (anziché tramite XML). Se usi un MapFragment, puoi trasmettere queste opzioni tramite il metodo di fabbrica statico newInstance(GoogleMapOptions). Se utilizzi un MapView, puoi trasmettere queste opzioni utilizzando il costruttore MapView(Context, GoogleMapOptions).

Se aggiungi una mappa utilizzando il formato XML, puoi applicare queste opzioni utilizzando i tag XML personalizzati.

Riepilogo delle costanti ereditate

Dall'interfaccia android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

Riepilogo del costruttore pubblico

GoogleMapOptions()

Crea un nuovo oggetto GoogleMapOptions.

Riepilogo del metodo pubblico

GoogleMapOptions	ambientEnabled(booleano abilitato) Specifica se deve essere attivato lo stile in modalità Ambient.
GoogleMapOptions	camera(fotocamera CameraPosition) Consente di specificare la posizione iniziale della fotocamera per la mappa.
GoogleMapOptions	compassEnabled(booleano abilitato) Consente di specificare se la bussola deve essere attivata o meno.
GoogleMapOptions statico	createFromAttributes(Context context, AttributeSet attrs) Crea un elemento GoogleMapsOptions dal `AttributeSet`.
Booleano	getAmbientEnabled()
CameraPosition	getCamera()
Booleano	getCompassEnabled()
LatLngBounds	getLatLngBoundsForCameraTarget()
Booleano	getLiteMode()
Booleano	getMapToolbarEnabled()
int	getMapType()
In virgola mobile	getMaxZoomPreference()
In virgola mobile	getMinZoomPreference()
Booleano	getRotateGesturesEnabled()
Booleano	getScrollGesturesEnabled()
Booleano	getScrollGesturesEnabledDuringRotateOrZoom()
Booleano	getTiltGesturesEnabled()
Booleano	getUseViewLifecycleInFragment()
Booleano	getZOrderOnTop()
Booleano	getZoomControlsEnabled()
Booleano	getZoomGesturesEnabled()
GoogleMapOptions	latLngBoundsForCameraTarget(LatLngBounds llbounds) Consente di specificare un LatLngBounds per vincolare l'obiettivo della videocamera, in modo che quando gli utenti scorrono la mappa ed eseguono la panoramica, l'oggetto target della videocamera non si muova al di fuori di questi limiti.
GoogleMapOptions	liteMode(booleano attivato) Specifica se la mappa deve essere creata in modalità Lite.
GoogleMapOptions	mapId(Stringa mapId) Specifica l'ID della mappa.
GoogleMapOptions	mapToolbarEnabled(booleano abilitato) Specifica se deve essere abilitato mapToolbar.
GoogleMapOptions	mapType(int mapType) Specifica una modifica al tipo di mappa iniziale.
GoogleMapOptions	maxZoomPreference(maxZoomPreference in virgola mobile) Specifica un limite superiore preferito per lo zoom della fotocamera.
GoogleMapOptions	minZoomPreference(float minZoomPreference) Consente di specificare un limite inferiore preferito per lo zoom della fotocamera.
GoogleMapOptions	rotateGesturesEnabled(booleano attivato) Consente di specificare se attivare o meno i gesti di rotazione.
GoogleMapOptions	scrollGesturesEnabled(booleano attivato) Consente di specificare se attivare o meno i gesti di scorrimento.
GoogleMapOptions	scrollGesturesEnabledDuringRotateOrZoom(booleano attivato) Consente di specificare se i gesti di scorrimento devono essere attivati durante i gesti di rotazione e zoom.
GoogleMapOptions	setInstrumentClusterMap(boolean isToolCluster)
GoogleMapOptions	tiltGesturesEnabled(booleano attivato) Consente di specificare se attivare o meno i gesti di inclinazione.
Stringa	toString()
GoogleMapOptions	useViewLifecycleInFragment(uso booleanoViewLifecycleInFragment) Quando utilizzi un oggetto `MapFragment`, questo flag specifica se il ciclo di vita della mappa deve essere collegato alla visualizzazione del frammento o al frammento stesso.
GoogleMapOptions	zOrderOnTop(booleano zOrderOnTop) Controlla se la superficie della visualizzazione mappa è posizionata sopra la finestra.
GoogleMapOptions	zoomControlsEnabled(booleano attivato) Consente di specificare se attivare o meno i controlli di zoom.
GoogleMapOptions	zoomGesturesEnabled(booleano attivato) Consente di specificare se attivare i gesti di zoom.

Riepilogo del metodo ereditato

Dalla classe java.lang.Object

boolean	uguale a(Oggetto arg0)
finale Class<?>	getClass()
int	hashCode()
finale void	notify()
finale void	notifyAll()
Stringa	toString()
finale void	wait(long arg0, int arg1)
finale void	wait(arg0 lungo)
finale void	wait()

Dall'interfaccia android.os.Parcelable

int astratto	describeContents()
astratto void	writeToParcel(Pacchetto arg0, int arg1)

Costruttori pubblici

Public GoogleMapOptions ()

Crea un nuovo oggetto GoogleMapOptions.

Metodi pubblici

pubblici GoogleMapOptions ambientEnabled (boolean enabled)

Specifica se deve essere attivato lo stile in modalità Ambient. Il valore predefinito è false. Quando questa opzione è abilitata, le mappe in stile Ambient possono essere visualizzate quando un dispositivo Ambiactive entra in modalità Ambient.

Parametri

abilitata

pubblici GoogleMapOptions camera (CameraPosition fotocamera)

Consente di specificare la posizione iniziale della fotocamera per la mappa.

Parametri

fotocamera

Public GoogleMapOptions compassEnabled (boolean enabled)

Consente di specificare se la bussola deve essere attivata o meno. Per ulteriori dettagli, visita la pagina setCompassEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata

pubblici statici GoogleMapOptions createFromAttributes (Context context, AttributeSet attrs)

Crea un elemento GoogleMapsOptions dal AttributeSet.

Parametri

context
attrs

Public Booleano getAmbientEnabled ()

Ritorni

l'opzione ambientEnabled oppure null se non specificata.

pubblica CameraPosition getCamera ()

Ritorni

l'opzione della fotocamera o null se non specificata.

pubblica booleana getCompassEnabled ()

Ritorni

l'opzione compassEnabled oppure null se non specificata.

pubblici LatLngBounds getLatLngBoundsForCameraTarget ()

Ritorni

i LatLngBounds utilizzati per vincolare il target della videocamera o nulli se non specificati.

Public Booleano getLiteMode ()

Ritorni

l'opzione liteMode o null se non specificata.

Public Booleano getMapToolbarEnabled ()

Ritorni

l'opzione mapToolbarEnabled oppure null se non specificata.

Public int getMapType ()

Ritorni

l'opzione mapType o -1 se non specificata.

pubblica Float getMaxZoomPreference ()

Ritorni

la preferenza del livello di zoom massimo o null se non specificato.

pubblica Float getMinZoomPreference ()

Ritorni

la preferenza del livello di zoom minimo o null se non specificato.

Public Booleano getRotateGesturesEnabled ()

Ritorni

l'opzione ruotareButtonsEnabled o null se non è specificato.

pubblico Booleano getScrollGesturesEnabled ()

Ritorni

l'opzione scrollButtonsEnabled o null se non specificata.

Public Booleano getScrollGesturesEnabledDuringRotateOrZoom ()

Ritorni

l'opzione di scrollButtonsEnabledEnabledroundRotazioneOrZoom oppure null se non specificati.

pubblici Booleano getTiltGesturesEnabled ()

Ritorni

l'opzione tiltButtonsEnabled o null se non specificata.

pubblico Booleano getUseViewLifecycleInFragment ()

Ritorni

l'opzione useViewLifecycleInFragment o null se non specificata.

pubblico Booleano getZOrderOnTop ()

Ritorni

l'opzione zOrderOnTop o null se non specificato.

pubblico Booleano getZoomControlsEnabled ()

Ritorni

l'opzione zoomControlsEnabled o null se non specificato.

Public Booleano getZoomGesturesEnabled ()

Ritorni

l'opzione zoomButtonsEnabled oppure null se non specificati.

pubblici GoogleMapOptions latLngBoundsForCameraTarget (LatLngBounds llbounds)

Consente di specificare un LatLngBounds per vincolare l'obiettivo della videocamera, in modo che quando gli utenti scorrono la mappa ed eseguono la panoramica, l'oggetto target della videocamera non si muova al di fuori di questi limiti.

Per ulteriori dettagli, consulta setLatLngBoundsForCameraTarget(LatLngBounds).

Parametri

llbounds

pubblici GoogleMapOptions liteMode (boolean enabled)

Specifica se la mappa deve essere creata in modalità Lite. Il valore predefinito è false. Se la modalità Lite è attivata, le mappe verranno caricate come immagini statiche. Ciò migliora le prestazioni nel caso in cui molte mappe debbano essere visualizzate contemporaneamente, ad esempio in un elenco a scorrimento, tuttavia le mappe in modalità Lite non possono essere sottoposte a panoramica o zoom da parte dell'utente, né inclinate o ruotate.

Parametri

abilitata

Public GoogleMapOptions mapId (String mapId)

Specifica l'ID della mappa.

Parametri

mapId

Public GoogleMapOptions mapToolbarEnabled (boolean enabled)

Specifica se deve essere abilitato mapToolbar. Per ulteriori dettagli, visita la pagina setMapToolbarEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata

pubblici GoogleMapOptions mapType (int mapType)

Specifica una modifica al tipo di mappa iniziale.

Parametri

mapType

pubblici GoogleMapOptions maxZoomPreference (float maxZoomPreference)

Specifica un limite superiore preferito per lo zoom della fotocamera.

Per ulteriori dettagli, consulta setMaxZoomPreference(float).

Parametri

maxZoomPreference

pubblici GoogleMapOptions minZoomPreference (float minZoomPreference)

Consente di specificare un limite inferiore preferito per lo zoom della fotocamera.

Per ulteriori dettagli, consulta setMinZoomPreference(float).

Parametri

minZoomPreference

pubblici GoogleMapOptions rotateGesturesEnabled (boolean enabled)

Consente di specificare se attivare o meno i gesti di rotazione. Per ulteriori dettagli, visita la pagina setRotateGesturesEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata

pubblici GoogleMapOptions scrollGesturesEnabled (boolean enabled)

Consente di specificare se attivare o meno i gesti di scorrimento. Per ulteriori dettagli, visita la pagina setScrollGesturesEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata

pubblici GoogleMapOptions scrollGesturesEnabledDuringRotateOrZoom (boolean enabled)

Consente di specificare se i gesti di scorrimento devono essere attivati durante i gesti di rotazione e zoom. Per ulteriori dettagli, visita la pagina setScrollGesturesEnabledDuringRotateOrZoom(boolean). Il valore predefinito è true.

Parametri

abilitata

pubblico GoogleMapOptions setInstrumentClusterMap (boolean isInstrumentCluster)

Parametri

isInstrumentCluster

pubblici GoogleMapOptions tiltGesturesEnabled (boolean enabled)

Consente di specificare se attivare o meno i gesti di inclinazione. Per ulteriori dettagli, visita la pagina setTiltGesturesEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata

Public String toString ()

pubblici GoogleMapOptions useViewLifecycleInFragment (boolean useViewLifecycleInFragment)

Quando utilizzi un oggetto MapFragment, questo flag specifica se il ciclo di vita della mappa deve essere collegato alla visualizzazione del frammento o al frammento stesso. Il valore predefinito è false, associando il ciclo di vita della mappa al frammento.

L'uso del ciclo di vita del frammento consente un rendering più rapido della mappa quando il frammento viene scollegato e ricollegato, in quanto il contesto GL sottostante viene conservato. Questo ha il costo che comporta lo scollegamento del frammento, ma non l'eliminazione, non rilascerà la memoria utilizzata dalla mappa.

L'utilizzo del ciclo di vita della vista di un frammento significa che una mappa non viene riutilizzata quando il frammento viene scollegato e ricollegato. In questo modo, la mappa verrà visualizzata nuovamente da zero, il che può richiedere alcuni secondi. Significa anche che, mentre un frammento è scollegato e, pertanto, non ha una vista, tutti i metodi GoogleMap restituiranno NullPointerException.

Parametri

useViewLifecycleInFragment

pubblico GoogleMapOptions zOrderOnTop (boolean zOrderOnTop)

Controlla se la superficie della visualizzazione mappa è posizionata sopra la finestra. Per ulteriori dettagli, visita la pagina setZOrderOnTop(boolean). Tieni presente che questa operazione riguarderà tutte le altre visualizzazioni che potrebbero apparire sulla mappa (ad esempio i controlli di zoom, il pulsante La mia posizione).

Parametri

zOrderOnTop

pubblici GoogleMapOptions zoomControlsEnabled (boolean enabled)

Consente di specificare se attivare o meno i controlli di zoom. Per ulteriori dettagli, visita la pagina setZoomControlsEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata

pubblici GoogleMapOptions zoomGesturesEnabled (boolean enabled)

Consente di specificare se attivare i gesti di zoom. Per ulteriori dettagli, visita la pagina setZoomGesturesEnabled(boolean). Il valore predefinito è true.

Parametri

abilitata