Google Maps

classi finali pubbliche GoogleMap estende l'oggetto

Questa è la classe principale dell'SDK di Google Maps per Android e il punto di accesso per tutti i metodi correlati alla mappa. Non puoi creare un'istanza di un oggetto GoogleMap direttamente, ma devi ottenerne uno dal metodo getMapAsync() su un elemento MapFragment o MapView che hai aggiunto alla tua applicazione.

Nota: come un oggetto View, un oggetto GoogleMap può essere letto e modificato solo dal thread dell'interfaccia utente Android. Chiamare i metodi GoogleMap da un altro thread comporterà un'eccezione.

Puoi regolare il punto di vista di una mappa modificando la posizione della fotocamera (anziché spostare la mappa). Puoi utilizzare la fotocamera della mappa per impostare parametri quali posizione, livello di zoom, angolo di inclinazione e rilevamento. Per ulteriori informazioni, consulta la sezione Fotocamera e vista.

Guida per gli sviluppatori

Per iniziare, leggi la guida per gli sviluppatori SDK Google Maps per Android.

Riepilogo delle classi nidificate

interfaccia	GoogleMap.CancelableCallback		Interfaccia di callback per la segnalazione quando un'attività viene completata o annullata.
interfaccia	GoogleMap.InfoWindowAdapter		Fornisce visualizzazioni per il rendering personalizzato delle finestre informative.
interfaccia	GoogleMap.OnCameraChangeListener		Questa interfaccia è deprecata. Sostituito da GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener e GoogleMap.OnCameraIdleListener. L'ordine in cui verrà chiamato il metodo onCameraChange deprecato in relazione ai metodi nei nuovi listener di modifica della fotocamera non è definito.
interfaccia	GoogleMap.OnCameraIdleListener		Interfaccia di richiamata per quando il movimento della videocamera è terminato.
interfaccia	GoogleMap.OnCameraMoveCanceledListener		Interfaccia di richiamata per quando il movimento della videocamera è stato interrotto o quando la videocamera inizia a muoversi per un nuovo motivo.
interfaccia	GoogleMap.OnCameraMoveListener		Interfaccia di richiamata per quando la fotocamera cambia posizione.
interfaccia	GoogleMap.OnCameraMoveStartedListener		Interfaccia di richiamata per l'avvio del movimento della videocamera.
interfaccia	GoogleMap.OnCircleClickListener		Interfaccia di richiamata per il clic su un cerchio.
interfaccia	GoogleMap.OnGroundOverlayClickListener		Interfaccia di richiamata per il clic su un overlay del suolo.
interfaccia	GoogleMap.OnIndoorStateChangeListener		Un listener per il cambiamento dello stato in ambienti interni.
interfaccia	GoogleMap.OnInfoWindowClickListener		Interfaccia di richiamata per gli eventi di clic/toccamento nella finestra informativa di un indicatore.
interfaccia	GoogleMap.OnInfoWindowChiudiListener		Interfaccia di callback per gli eventi di chiusura nella finestra informativa di un indicatore.
interfaccia	GoogleMap.OnInfoWindowLengthClickClick		Interfaccia di richiamata per quando l'utente preme a lungo su una finestra informativa di un indicatore.
interfaccia	GoogleMap.OnMapClickListener		Interfaccia di richiamata per quando l'utente tocca la mappa.
interfaccia	GoogleMap.OnMapLoadedCallback		Interfaccia di callback per quando la visualizzazione della mappa è terminata.
interfaccia	GoogleMap.OnMapLongClickListener		Interfaccia di richiamata per quando l'utente preme a lungo sulla mappa.
interfaccia	GoogleMap.OnMarkerClickListener		Definisce le firme per i metodi che vengono chiamati quando un utente fa clic o tocca un indicatore.
interfaccia	GoogleMap.OnMarkerTrascina listener		Interfaccia di callback per eventi di trascinamento sugli indicatori.
interfaccia	GoogleMap.OnMyLocationButtonClickListener		Interfaccia di richiamata per il clic sul pulsante La mia posizione.
interfaccia	GoogleMap.OnMyLocationChangeListener		Questa interfaccia è deprecata. Usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre un rilevamento della posizione migliorato e un consumo energetico e viene utilizzato dal punto blu "La mia posizione". Guarda il tutorial per selezionare il luogo attuale, che utilizza il FusedLocationProviderApi o la Guida per gli sviluppatori del luogo.
interfaccia	GoogleMap.OnMyLocationClickListener		Interfaccia di richiamata per quando viene fatto clic sul punto La mia posizione (che indica la posizione dell'utente).
interfaccia	GoogleMap.OnPoiClickListener		Un listener per i tocchi PDI.
interfaccia	GoogleMap.OnPonClickClicker		Interfaccia di richiamata per il clic su un poligono.
interfaccia	GoogleMap.OnPolylineClickListener		Interfaccia di richiamata per il clic su una polilinea.
interfaccia	GoogleMap.SnapshotReadyCallback		Interfaccia di callback per notificare l'acquisizione dello snapshot.

Riepilogo costante

int	MAP_TYPE_HYBRID	Mappe satellitari con un livello trasparente di strade principali.
int	MAP_TYPE_NONE	Nessun riquadro mappa di base.
int	MAP_TYPE_NORMAL	Mappe di base.
int	MAP_TYPE_SATELLITE	Mappe satellitari senza etichette.
int	MAP_TYPE_TERRAIN	Mappe del rilievo.

Riepilogo del metodo pubblico

Cerchio	addCircle (opzioni CircleOptions) Aggiungi un cerchio a questa mappa.
Overlay al suolo	addGroundOverlay(opzioni GroundOverlayOptions) Aggiunge un'immagine a questa mappa.
Indicatore	addMarker(opzioni MarkerOptions) Aggiunge un indicatore a questa mappa.
Poligono	add poligono(opzioni poligonoOptions) Aggiunge un poligono a questa mappa.
Polilinea	addPolyline(opzioni di PolylineOptions) Aggiunge una polilinea a questa mappa.
Overlay riquadro	addTileOverlay(opzioni TileOverlayOptions) Aggiunge un overlay riquadro a questa mappa.
nullo	animateCamera(aggiornamento di cameraUpdate) Anima il movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento.
nullo	animateCamera(aggiornamento FotocameraUpdate, callback GoogleMap.cancelableCallback) Anima il movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento e chiama un callback facoltativo al termine.
nullo	animateCamera(aggiornamento cameraUpdate, durata int, callback GoogleMap.cancelableCallback) Consente di spostare la mappa in base all'aggiornamento con un'animazione per una durata specifica e di richiamare un callback facoltativo al termine.
nullo	clear (()) Rimuove tutti gli indicatori, le polilinee, i poligoni, gli overlay e così via dalla mappa.
Posizione fotocamera	getCameraPosition() Rileva la posizione corrente della fotocamera.
Indoor	getFocusedbuilding() Recupera l'edificio attualmente incentrato.
int	getMapType() Recupera il tipo di mappa attualmente visualizzata.
numero in virgola mobile	getMaxZoomLevel() Restituisce il livello di zoom massimo per la posizione corrente della fotocamera.
numero in virgola mobile	getMinZoomLevel() Restituisce il livello di zoom minimo.
Località	getMyLocation() Questo metodo è deprecato. usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre un rilevamento della posizione migliorato e un consumo energetico e viene utilizzato dal punto blu "La mia posizione". Consulta la sezione MyLocationDemoActivity nella cartella delle applicazioni di esempio, per visualizzare il codice di esempio, o la Location Developer Guide.
Proiezione	getProjection() Restituisce un oggetto Projection che puoi utilizzare per convertire le coordinate dello schermo e quelle di latitudine/longitudine.
Impostazioni UI	getUiSettings() Visualizza le impostazioni dell'interfaccia utente per la mappa.
boolean	isbuildingsEnabled() Restituisce se il livello Edifici 3D è abilitato.
boolean	isIndoorEnabled() Indica se le mappe di interni sono attualmente attive.
boolean	isMyLocationEnabled() Visualizza lo stato del livello my-location.
boolean	isTrafficEnabled() Controlla se la mappa sta estraendo i dati sul traffico.
nullo	movecamera(aggiornamento cameraUpdate) Riposiziona la videocamera in base alle istruzioni definite nell'aggiornamento.
nullo	resetMinMaxZoomPreferenza() Rimuove i limiti di zoom superiori e inferiori specificati in precedenza.
nullo	setedificiosEnabled(booleano abilitato) Attiva o disattiva il livello Edifici 3D.
nullo	setContentDescription(Descrizione della stringa) Imposta una contentDescription per la mappa.
boolean	setIndoorEnabled(booleano abilitato) Consente di stabilire se attivare o meno le mappe di interni.
nullo	setInfoWindowAdapter(GoogleMap.InfoWindowAdapter) Imposta un renderer personalizzato per i contenuti delle finestre informative.
nullo	setLatLngBoundsForCameraTarget(limiti LatLngBounds) Specifica un oggetto LatLngBounds per vincolare il target della fotocamera in modo che, quando gli utenti scorrono e panoramicano la mappa, il target della fotocamera non si sposti al di fuori di questi limiti.
nullo	setLocationSource(origine LocationSource) Sostituisce l'origine della posizione del livello my-location.
boolean	setMapStyle(stile MapStyleOptions) Imposta lo stile della mappa base.
nullo	setMapType(tipo di int). Consente di impostare il tipo di riquadri della mappa da visualizzare.
nullo	setMaxZoomPreferenza(decimale maxZoomPreferenza) Imposta un limite superiore preferito per lo zoom della fotocamera.
nullo	setMinZoomPreferenza(minuti decimali per Preferenza zoom) Imposta un limite inferiore preferito per lo zoom della fotocamera.
nullo	setMyLocationEnabled(booleano abilitato) Attiva o disattiva il livello my-location.
nullo	setOnCameraChangeListener(ascoltatore GoogleMap.OnCameraChangeListener) Questo metodo è deprecato. Sostituito da setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) e setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).
nullo	setOnCameraIdleListener(ascoltatore GoogleMap.OnCameraIdleListener) Imposta un callback che viene richiamato al termine del movimento della videocamera.
nullo	setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener listener) Imposta un callback che viene richiamato quando un movimento viene interrotto o interrotto da un nuovo tipo di animazione.
nullo	setOnCameraMoveSpeak(ascoltatore GoogleMap.OnCameraMoveListener) Imposta un callback che viene richiamato ripetutamente quando la videocamera è in movimento.
nullo	setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener listener) Imposta un callback che viene richiamato quando la videocamera inizia a muoversi o perché il movimento è cambiato.
nullo	setOnCircleClickListener(GoogleMap.OnCircleClickListener listener) Imposta un callback che viene richiamato quando si fa clic su un cerchio.
nullo	setOnGroundOverlayClickListener(ascoltatore GoogleMap.OnGroundOverlayClickClick) Imposta un callback che viene richiamato quando si fa clic su un overlay del suolo.
nullo	setOnIndoorStateChangeListener(ascoltatore GoogleMap.OnIndoorStateChangeListener) Imposta o cancella il listener per gli eventi al coperto.
nullo	setOnInfoWindowClickListener(ascoltatore GoogleMap.OnInfoWindowClickClick) Imposta un callback che viene attivato quando si fa clic sulla finestra di un indicatore.
nullo	setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener listener) Imposta un callback che viene richiamato quando viene chiusa la finestra informativa di un indicatore.
nullo	setOnInfoWindowlongClickListener(GoogleMap.OnInfoWindowLongClickListener listener) Imposta un callback che viene richiamato quando premi a lungo una finestra informativa di un indicatore.
nullo	setOnMapClickListener(GoogleMap.OnMapClickListener listener) Imposta un callback che viene attivato quando viene toccata la mappa.
nullo	setOnMapLoadedCallback(GoogleMap.OnMapLoadedCallback) Imposta un callback che viene richiamato al termine del rendering di questa mappa.
nullo	setOnMaplongClickClick(ascoltatore GoogleMap.OnMaplongClickListener) Imposta un callback che viene richiamato quando la mappa viene premuta a lungo.
nullo	setOnMarkerClickListener(GoogleMap.OnMarkerClickListener listener) Imposta un callback che viene richiamato quando un utente fa clic su un indicatore.
nullo	setOnMarkerTrascinaListener(ascoltatore GoogleMap.OnMarkerTrascinaListener) Imposta un callback che viene richiamato quando un indicatore viene trascinato.
nullo	setOnMyLocationButtonClickListener(ascoltatore GoogleMap.OnMyLocationButtonClickListener) Imposta un callback che viene richiamato quando viene fatto clic sul pulsante La mia posizione.
nullo	setOnMyLocationChangeListener(ascoltatore GoogleMap.OnMyLocationChangeListener) Questo metodo è deprecato. usa com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre un rilevamento della posizione migliorato e un consumo energetico e viene utilizzato dal punto blu "La mia posizione". Consulta la sezione MyLocationDemoActivity nella cartella delle applicazioni di esempio, per visualizzare il codice di esempio, o la Location Developer Guide.
nullo	setOnMyLocationClickListener(ascoltatore GoogleMap.OnMyLocationClickListener) Imposta un callback che viene richiamato quando viene fatto clic sul punto La mia posizione (che indica la posizione dell'utente).
nullo	setOnPoiClickListener(GoogleMap.OnPoiClickListener listener) Imposta un listener che verrà attivato quando tocchi o fai clic su un PDI.
nullo	setOn poligonoClickListener(GoogleMap.OnPoliticalClickListener listener) Imposta un callback che viene richiamato quando si fa clic su un poligono.
nullo	setOnPolylineClickListener(GoogleMap.OnPolylineClickListener listener) Imposta un callback che viene richiamato quando viene fatto clic su una polilinea.
nullo	setPpadding(int sinistra, int superiore, int destra, int inferiore) Imposta la spaziatura interna sulla mappa.
nullo	setTrafficEnabled(booleano abilitato) Attiva o disattiva il livello di traffico.
nullo	snapshot(GoogleMap.SnapshotReadyCallback callback) Scatta un'istantanea della mappa.
nullo	snapshot ( callback GoogleMap.SnapshotReadyCallback, bitmap Bitmap) Scatta un'istantanea della mappa.
nullo	stopAnimation() Interrompe l'animazione della videocamera, se presente.

Riepilogo del metodo ereditato

Dalla classe java.lang.Object

boolean	uguale a(oggetto arg0)
finale Class<?>	getClass()
int	hashCode()
finale null	notifica()
finale null	notificationAll()
Stringa	toString()
finale null	wait(long arg0, int arg1)
finale null	wait (lungo arg0)
finale null	wait()

Costanti

public static final int MAP_TYPE_HYBRID

Mappe satellitari con un livello trasparente di strade principali.

Valore costante: 4

public static final int MAP_TYPE_NONE

Nessun riquadro mappa di base.

Valore costante: 0

public static final int MAP_TYPE_NORMAL

Mappe di base.

Valore costante: 1

public static final int MAP_TYPE_SATELLITE

Mappe satellitari senza etichette.

Valore costante: 2

public static final int MAP_TYPE_TERRAIN

Mappe del rilievo.

Valore costante: 3

Metodi pubblici

pubblica Cerchia addCircle (Opzioni Opzioni)

Aggiungi un cerchio a questa mappa.

Parametri

opzioni	Un oggetto opzioni di cerchio che definisce come visualizzare il cerchio

Restituisce

• L'oggetto Circle che viene aggiunto alla mappa.

pubblico GroundOverlay addGroundOverlay (GroundOverlayOptions opzioni)

Aggiunge un'immagine a questa mappa.

Parametri

opzioni	Un oggetto opzioni di overlay del suolo che definisce come visualizzare l'overlay. Le opzioni devono avere un'immagine (AnchoredBitmap) e una posizione specificate.

Restituisce

• GroundOverlay che è stato aggiunto alla mappa.

Genera

Eccezione Argomento illegale	Se l'immagine o la posizione non sono specificate nelle opzioni.

pubblica Marker addMarker (Opzioni MarkerOptions)

Aggiunge un indicatore a questa mappa.

L'icona dell'indicatore viene visualizzata sulla mappa nella posizione Posizione. Fai clic sull'indicatore per centrare la fotocamera sull'indicatore. Se viene definito un indicatore.La mappa mostra una casella di informazioni con il titolo e lo snippet dell'indicatore. Se l'indicatore è trascinabile, fai clic a lungo e poi trascini l'indicatore per spostarlo.

Parametri

opzioni	Un oggetto opzioni indicatore che definisce la modalità di rendering dell'indicatore.

Restituisce

• Marker che è stato aggiunto alla mappa.

pubblico Poligono add poligono (OpzioniOpzioni)

Aggiunge un poligono a questa mappa.

Parametri

opzioni	Un oggetto opzioni poligono che definisce come visualizzare il poligono.

Restituisce

• L'oggetto Polygon che viene aggiunto alla mappa.

pubblica Polyline addPolyline (opzioni PolylineOptions)

Aggiunge una polilinea a questa mappa.

Parametri

opzioni	Un oggetto opzioni polilinea che definisce come visualizzare la polilinea.

Restituisce

• L'oggetto Polyline che è stato aggiunto alla mappa.

pubblico TileOverlay addTileOverlay (opzioni TileOverlayOptions)

Aggiunge un overlay riquadro a questa mappa. Per ulteriori informazioni, visita la pagina TileOverlay.

Tieni presente che, a differenza di altri overlay, se la mappa viene ricreata, gli overlay dei riquadri non vengono ripristinati automaticamente e devono essere aggiunti di nuovo manualmente.

Parametri

opzioni	Un oggetto opzioni di overlay del riquadro che definisce come visualizzare l'overlay. Le opzioni devono avere un elemento TileProvider specificato, altrimenti verrà generato un elemento IllegalArgumentException.

Restituisce

• TileOverlay che è stato aggiunto alla mappa.

Genera

Eccezione Argomento illegale	se il valore TileProvider non è specificato nelle opzioni.

pubblica void animateCamera (aggiornamento di CameraUpdate)

Anima il movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento. Durante l'animazione, una chiamata al numero getCameraPosition() restituisce una posizione intermedia della videocamera.

Consulta CameraUpdateFactory per una serie di aggiornamenti.

Parametri

update	La modifica che deve essere applicata alla videocamera.

pubblica void animateCamera (aggiornamento Camera Camera, callback GoogleGoogleMap.cancelable)

Anima il movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento e chiama un callback facoltativo al termine. Consulta CameraUpdateFactory per un insieme di aggiornamenti.

Durante l'animazione, una chiamata al numero getCameraPosition() restituisce una posizione intermedia della videocamera.

Parametri

update	La modifica che deve essere applicata alla videocamera.
callback	Il callback da richiamare dal thread dell'interfaccia utente Android quando l'animazione si interrompe. Se l'animazione viene completata normalmente, viene chiamato onFinish(); in caso contrario, viene chiamato onCancel(). Non aggiornare o animare la videocamera dall'interno di onCancel().

pubblico void animateCamera (aggiornamento Camera Camera, durata int, GoogleMap.CancelableCallback callback)

Consente di spostare la mappa in base all'aggiornamento con un'animazione per una durata specifica e di richiamare un callback facoltativo al termine. Consulta CameraUpdateFactory per una serie di aggiornamenti.

Se getCameraPosition() viene chiamato durante l'animazione, restituirà la posizione corrente della videocamera in volo.

Parametri

update
durataM	La durata dell'animazione in millisecondi. Questo valore deve essere strettamente positivo, altrimenti verrà generato un IllegalArgumentException.
callback	Un callback facoltativo che ti verrà comunicato dal thread dell'interfaccia utente Android quando l'animazione si interrompe. Se l'animazione si interrompe a causa del completamento naturale, il callback riceverà una notifica con onFinish(). Se l'animazione si interrompe a causa di un'interruzione dovuta a un movimento successivo della videocamera o a un gesto dell'utente, verrà chiamato onCancel(). Il callback non deve tentare di spostare o animare la videocamera nel metodo di annullamento. Se non è richiesto un callback, lascialo null.

pubblica void clear ()

Rimuove tutti gli indicatori, le polilinee, i poligoni, gli overlay e così via dalla mappa.

pubblica CameraPosition getCameraPosition ()

Rileva la posizione corrente della fotocamera.

L'elemento CameraPosition restituito è un'istantanea della posizione corrente e non si aggiornerà automaticamente quando la fotocamera si sposta.

Per ulteriori informazioni sulla modifica della posizione della videocamera, vedi Videocamera e vista.

Restituisce

• La posizione attuale della fotocamera.

pubblico Indoor getFocusedbuilding ()

Recupera l'edificio attualmente incentrato.

Restituisce

• L'edificio attivo attuale o null se non è attivo alcun edificio.

public int getMapType ()

Recupera il tipo di mappa attualmente visualizzata. Consulta MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN per i possibili valori.

Restituisce

• Il tipo di mappa.

floating pubblico getMaxZoomLevel ()

Restituisce il livello di zoom massimo per la posizione corrente della fotocamera. Ciò tiene conto del tipo di mappa attualmente in uso, ad esempio il satellite o il rilievo potrebbe avere un livello di zoom massimo inferiore rispetto ai riquadri della mappa di base.

Per ulteriori informazioni sulla modifica del livello di zoom della videocamera, vedi Videocamera e vista.

Restituisce

• Il livello di zoom massimo disponibile nella posizione corrente della fotocamera.

floating pubblico getMinZoomLevel ()

Restituisce il livello di zoom minimo. È lo stesso per tutte le località (a differenza del livello di zoom massimo), ma può variare tra i dispositivi e le dimensioni della mappa.

Per ulteriori informazioni sulla modifica del livello di zoom della videocamera, vedi Videocamera e vista.

Restituisce

• Il livello di zoom minimo disponibile.

località pubblica getMyLocation ()

Questo metodo è obsoleto.
Usa invece com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre un rilevamento della posizione migliorato e un consumo energetico e viene utilizzato dal punto blu "La mia posizione". Per un esempio di codice, consulta MyLocationDemoActivity nella cartella delle applicazioni di esempio o la Location Developer Guide.

Restituisce la posizione dell'utente attualmente visualizzata o null se non sono disponibili dati sulla posizione.

Restituisce

• L'user location attualmente visualizzato.

Genera

Eccezione stato illegale	se il livello my-location non è abilitato.

pubblica Proiezione getProjection ()

Restituisce un oggetto Projection che puoi utilizzare per convertire le coordinate dello schermo e quelle di latitudine/longitudine.

Il valore restituito da Projection è un'istantanea della proiezione attuale e non si aggiornerà automaticamente quando la videocamera si sposta. Poiché questa operazione è costosa, dovresti ottenere la proiezione una sola volta per schermata. Google Maps utilizza la proiezione di Mercatore per creare mappe dai dati geografici e convertire i punti sulla mappa in coordinate geografiche.

Restituisce

• Projection della mappa nel suo stato attuale.

pubblica UiSettings getUiSettings ()

Visualizza le impostazioni dell'interfaccia utente per la mappa.

Restituisce

• I UiSettings per questa mappa.

pubblico booleano isbuildingsEnabled ()

Restituisce se il livello Edifici 3D è abilitato.

Restituisce

• true se gli edifici sono abilitati; false in caso contrario.

pubblico booleano isIndoorEnabled ()

Indica se le mappe di interni sono attualmente attive.

Restituisce

• true se le mappe per interni sono attivate; false se le mappe per interni sono disattivate;

pubblico booleano isMyLocationEnabled ()

Visualizza lo stato del livello my-location.

Restituisce

• true se il livello La mia posizione è abilitato; false in caso contrario.

pubblico booleano isTrafficEnabled ()

Controlla se la mappa sta estraendo i dati sul traffico. Questo è soggetto alla disponibilità dei dati di traffico.

Restituisce

• true se i dati sul traffico sono attivi; false in caso contrario.

pubblica void movecamera (aggiornamento di CameraUpdate)

Riposiziona la videocamera in base alle istruzioni definite nell'aggiornamento. Lo spostamento è istantaneo e un elemento getCameraPosition() successivo rifletterà la nuova posizione. Consulta CameraUpdateFactory per una serie di aggiornamenti.

Parametri

update	La modifica che deve essere applicata alla videocamera.

pubblica void resetMinMaxZoomPreferenza ()

Rimuove i limiti di zoom superiori e inferiori specificati in precedenza.

public void setbuildingsEnabled (booleano abilitato)

Attiva o disattiva il livello Edifici 3D.

Parametri

abilitata	true per abilitare il livello Edifici 3D; false per disattivare gli edifici 3D.

public void setContentDescription (Descrizione della stringa)

Imposta una contentDescription per la mappa.

Viene utilizzato per fornire una descrizione vocale della mappa in modalità di accessibilità. Il valore predefinito è "Google Maps"

Parametri

descrizione	una stringa da utilizzare come descrizione.

pubblico booleano setIndoorEnabled (booleano abilitato)

Consente di stabilire se attivare o meno le mappe di interni. Al momento, le mappe di interni possono essere visualizzate su una sola mappa alla volta e per impostazione predefinita, questa è la prima mappa aggiunta alla tua applicazione. Per attivare le mappe di interni su un'altra mappa, devi prima disattivarle sulla mappa originale. Se provi ad attivare le mappe di interni quando è attiva su un'altra mappa, non accadrà nulla e verrà restituito false. Se l'opzione Indoor non è abilitata per una mappa, tutti i metodi relativi all'interno verranno restituiti null o false.

Parametri

abilitata	true per provare ad attivare le mappe di interni; false per disattivare le mappe di interni.

Restituisce

• se fosse possibile abilitare le mappe di interni.

public void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter adattatore)

Imposta un renderer personalizzato per i contenuti delle finestre informative.

Come i listener di eventi della mappa, questo stato non viene serializzato con la mappa. Se la mappa viene ricreata (ad es. a causa di una modifica della configurazione), devi assicurarti di richiamare questo metodo per mantenere la personalizzazione.

Parametri

adattatore	L'adattatore da utilizzare per i contenuti della finestra informativa oppure null per utilizzare il rendering predefinito dei contenuti nelle finestre informative.

pubblico void setLatLngBoundsForCameraTarget (limiti LatLngBounds)

Specifica un oggetto LatLngBounds per vincolare il target della fotocamera in modo che, quando gli utenti scorrono e panoramicano la mappa, il target della fotocamera non si sposti al di fuori di questi limiti.

Imposta su null per cancellare completamente il riquadro di delimitazione. I nuovi limiti sostituiscono un qualsiasi riquadro di delimitazione specificato in precedenza.

Quando viene modificato il valore LatLngBounds, l'SDK regola tutti gli aggiornamenti successivi della videocamera in modo da rispettare questi limiti, se possibile. Tieni presente che potrebbero esserci delle considerazioni tecniche che potrebbero impedire all'SDK di mantenere il target della fotocamera strettamente nei limiti. ad esempio, errori di arrotondamento di precisione con virgola mobile o un livello di zoom molto basso.

Parametri

limiti	I limiti per vincolare il target della fotocamera all'interno.

public void setLocationSource (SourceSource source)

Sostituisce l'origine della posizione del livello my-location.

Parametri

origine	Un'origine località da utilizzare nel livello località. Imposta null per utilizzare l'origine località predefinita.

pubblico booleano setMapStyle (stile MapStyleOptions)

Imposta lo stile della mappa base.

Tramite le opzioni puoi applicare stili personalizzati a elementi ed elementi sulla mappa. Per i dettagli sulla definizione dello stile, consulta la pagina MapStyleOptions.

Imposta su null per cancellare gli stili personalizzati precedenti.

Parametri

style

Restituisce

• true se lo stile è stato analizzato correttamente; false se sono stati rilevati problemi con MapStyleOptions, tra cui, ad esempio, JSON di stile non analizzabile, tipo di caratteristica non riconosciuta, tipo di elemento non riconosciuto o chiavi di stile non valide. Se il valore restituito è false, lo stile corrente rimane invariato.

public void setMapType (int type)

Consente di impostare il tipo di riquadri della mappa da visualizzare. I valori consentiti sono:

• MAP_TYPE_NORMAL: mappa di base.
• MAP_TYPE_SATELLITE: immagini satellitari.
• MAP_TYPE_HYBRID: immagini satellitari con strade ed etichette.
• MAP_TYPE_TERRAIN: dati topografici.
• MAP_TYPE_NONE: nessun riquadro della mappa di base.

Parametri

digita	Il tipo di mappa da visualizzare.

pubblico void setMaxZoomPreferenza (maxmaxZoomPreferenza)

Imposta un limite superiore preferito per lo zoom della fotocamera.

Quando cambia lo zoom massimo, l'SDK regola tutti gli aggiornamenti successivi della fotocamera in modo da rispettare quel valore massimo, se possibile. Tieni presente che a causa di considerazioni tecniche, l'SDK potrebbe non essere in grado di consentire agli utenti di aumentare troppo lo zoom nella mappa. Ad esempio, il satellite o il rilievo potrebbe avere uno zoom massimo inferiore ai riquadri della mappa base.

L'SDK risolve eventuali conflitti nei valori minimo e massimo. Se imposti un livello di zoom minimo superiore al valore massimo corrente, l'SDK utilizza il nuovo valore minimo sia per il minimo sia per il massimo. Se imposti lo zoom massimo su un livello di zoom inferiore al minimo, l'SDK utilizza il nuovo valore massimo sia per il minimo che per il massimo. Ad esempio: supponiamo che lo zoom minimo corrente sia 8 e quello massimo sia 14. Quindi hai impostato lo zoom massimo su 6. L'SDK utilizza uno zoom minimo di 6 e uno massimo di 6.

Parametri

Preferenza zoom max	Il limite superiore preferito.

pubblica void setMinZoomPreferenza (minuti numero in virgola mobile)

Imposta un limite inferiore preferito per lo zoom della fotocamera.

Quando cambia lo zoom minimo, l'SDK regola tutti gli aggiornamenti più recenti della fotocamera per rispettare tale valore minimo, se possibile. Nota che alcune considerazioni tecniche potrebbero impedire all'SDK di consentire agli utenti di aumentare lo zoom troppo in basso.

L'SDK risolve eventuali conflitti nei valori minimo e massimo. Se imposti un livello di zoom minimo superiore al valore massimo corrente, l'SDK utilizza il nuovo valore minimo sia per il minimo sia per il massimo. Se imposti lo zoom massimo su un livello di zoom inferiore al minimo, l'SDK utilizza il nuovo valore massimo sia per il minimo che per il massimo. Ad esempio: supponiamo che lo zoom minimo corrente sia 8 e quello massimo sia 14. Quindi, imposta lo zoom minimo a 16. L'SDK utilizza uno zoom minimo di 16 e uno massimo di 16.

Parametri

Preferenza zoom min	Il limite inferiore preferito.

pubblica void setMyLocationEnabled (booleano abilitato)

Attiva o disattiva il livello my-location.

Se questa opzione è attiva e la posizione è disponibile, il livello La mia posizione traccia continuamente un'indicazione della posizione e del rilevamento attuali dell'utente e mostra i controlli dell'interfaccia utente che consentono all'utente di interagire con la sua posizione (ad esempio, per abilitare o disabilitare il monitoraggio della posizione della posizione e del rilevamento).

Per utilizzare la funzionalità livello località, devi richiedere l'autorizzazione per ACCESS_COARSE_LOCATION o ACCESS_FINE_LOCATION a meno che tu non abbia impostato un'origine della località personalizzata.

Se hai impostato un'origine località personalizzata tramite setLocationSource(LocationSource), l'SDK Google Maps per Android non verificherà se le autorizzazioni sopra indicate sono state concesse. Tuttavia, devi comunque assicurarti che l'utente abbia concesso tutte le autorizzazioni necessarie per l'origine della posizione personalizzata.

Parametri

abilitata	true per abilitare; false per disattivarla.

Genera

Eccezione sicurezza	se l'autorizzazione di accesso alla posizione non viene concessa.

public void setOnCameraChangeListener (ascoltatore GoogleMap.OnCameraChangeListener)

Questo metodo è deprecato.
Sostituito da setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) e setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Imposta un callback che viene richiamato quando la videocamera cambia.

Parametri

listener	Il callback richiamato quando la videocamera cambia. Per annullare l'impostazione del callback, utilizza null.

pubblico void setOnCameraIdleListener (ascoltatore GoogleMap.OnCameraIdleListener)

Imposta un callback che viene richiamato al termine del movimento della videocamera.

Parametri

listener	Il callback richiamato. Per annullare l'impostazione del callback, utilizza null.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener listener)

Imposta un callback che viene richiamato quando un movimento viene interrotto o interrotto da un nuovo tipo di animazione.

Parametri

listener	Il callback richiamato. Per annullare l'impostazione del callback, utilizza null. Non aggiornare o animare la videocamera da onCameraMoveCanceled().

public void setOnCameraMoveListener (ascoltatore GoogleMap.OnCameraMoveListener)

Imposta un callback che viene richiamato ripetutamente quando la videocamera è in movimento. Il callback può essere richiamato con la stessa frequenza di ogni frame e non deve comportare operazioni costose.

Parametri

listener	Il callback richiamato. Per annullare l'impostazione del callback, utilizza null.

public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener listener)

Imposta un callback che viene richiamato quando la videocamera inizia a muoversi o perché il movimento è cambiato.

Parametri

listener	Il callback richiamato. Per annullare l'impostazione del callback, utilizza null. Non aggiornare o animare la videocamera da onCameraMoveStarted().

public void setOnCircleClickListener (GoogleMap.OnCircleClickListener listener)

Imposta un callback che viene richiamato quando si fa clic su un cerchio.

Parametri

listener	Il callback richiamato quando viene fatto clic su un cerchio. Per annullare l'impostazione del callback, utilizza null.

public void setOnGroundOverlayClickListener (ascoltatore GoogleMap.OnGroundOverlayClickListener)

Imposta un callback che viene richiamato quando si fa clic su un overlay del suolo.

Parametri

listener	Il callback richiamato quando viene fatto clic su un overlay del suolo. Per annullare l'impostazione del callback, utilizza null.

public void setOnIndoorStateChangeListener (ascoltatore GoogleMap.OnIndoorStateChangeListener)

Imposta o cancella il listener per gli eventi al coperto. È possibile impostare un solo listener. L'impostazione di un nuovo listener rimuoverà il listener precedente.

Parametri

listener	il listener di eventi indoor se non è null; altrimenti, cancella il listener

public void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener listener)

Imposta un callback che viene attivato quando si fa clic sulla finestra di un indicatore.

Parametri

listener	Il callback che viene richiamato quando si fa clic sulla finestra di un indicatore. Per annullare l'impostazione del callback, utilizza null.

public void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener listener)

Imposta un callback che viene richiamato quando viene chiusa la finestra informativa di un indicatore.

Parametri

listener	Il callback che viene richiamato quando viene chiusa la finestra informativa di un indicatore. Per annullare l'impostazione del callback, utilizza null.

public void setOnInfoWindowlongClickListener (GoogleMap.OnInfoWindowLongClickListener listener)

Imposta un callback che viene richiamato quando premi a lungo una finestra informativa di un indicatore.

Parametri

listener	Il callback richiamato quando viene premuta a lungo una finestra informativa di un indicatore. Per annullare il callback, utilizza null.

public void setOnMapClickListener (ascoltatore GoogleMap.OnMapClickListener)

Imposta un callback che viene attivato quando viene toccata la mappa.

Parametri

listener	Il callback che viene richiamato quando la mappa viene toccata. Per annullare l'impostazione del callback, utilizza null.

pubblica void setOnMapLoadedCallback ( callbackGoogleMap.OnMapLoadedCallback)

Imposta un callback che viene richiamato al termine del rendering di questa mappa. Il callback verrà richiamato solo una volta.

Se questo metodo viene richiamato quando la mappa viene visualizzata completamente, il callback viene richiamato immediatamente. Questo evento non si attiva se la mappa non viene mai caricata a causa di problemi di connettività o se cambia continuamente e non viene mai completato il caricamento a causa dell'interazione costante con la mappa da parte dell'utente.

Parametri

callback	Il callback richiamato quando la visualizzazione della mappa è terminata. Per annullare l'impostazione del callback, utilizza null.

public void setOnMapLongClickListener (ascoltatore GoogleMap.OnMaplongClickListener)

Imposta un callback che viene richiamato quando la mappa viene premuta a lungo.

Parametri

listener	Il callback che viene richiamato quando la mappa viene premuta a lungo. Per annullare l'impostazione del callback, utilizza null.

public void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener listener)

Imposta un callback che viene richiamato quando un utente fa clic su un indicatore.

Parametri

listener	Il callback richiamato quando viene fatto clic su un indicatore. Per annullare l'impostazione del callback, utilizza null.

public void setOnMarkerTrascinaListener (ascoltatore GoogleMap.OnMarkerTrascinaascolto)

Imposta un callback che viene richiamato quando un indicatore viene trascinato.

Parametri

listener	Il callback richiamato dagli eventi di trascinamento dell'indicatore. Per annullare l'impostazione del callback, utilizza null.

public void setOnMyLocationButtonClickSleep (ascoltatore GoogleMap.OnMyLocationButtonClick)

Imposta un callback che viene richiamato quando viene fatto clic sul pulsante La mia posizione.

Se listener restituisce true, l'evento viene utilizzato e non si verifica il comportamento predefinito. Se viene restituito false, si verifica il comportamento predefinito (ad es. la videocamera si muove in modo che sia centrata sulla posizione dell'utente).

Parametri

listener	Il callback richiamato quando viene fatto clic sul pulsante La mia posizione.

public void setOnMyLocationChangeListener (ascoltatore GoogleMap.OnMyLocationChangeListener)

Questo metodo è obsoleto.
Usa invece com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre un rilevamento della posizione migliorato e un consumo energetico e viene utilizzato dal punto blu "La mia posizione". Per un esempio di codice, consulta MyLocationDemoActivity nella cartella delle applicazioni di esempio o la Location Developer Guide.

Imposta un callback che viene richiamato quando il punto La mia posizione cambia posizione.

Parametri

listener	Il callback che viene richiamato quando cambia il punto La mia posizione.

public void setOnMyLocationClick listener (GoogleMap.OnMyLocationClickListener listener)

Imposta un callback che viene richiamato quando viene fatto clic sul punto La mia posizione (che indica la posizione dell'utente).

Parametri

listener	Il callback richiamato quando viene fatto clic sul punto La mia posizione.

public void setOnPoiClick listener (GoogleMap.OnPoiClickListener listener)

Imposta un listener che verrà attivato quando tocchi o fai clic su un PDI.

Passa null per eliminare il listener.

Parametri

listener

public void setOnPoliciesClickListener (ascoltatore GoogleMap.On poligonoClickListener)

Imposta un callback che viene richiamato quando si fa clic su un poligono.

Parametri

listener	Il callback richiamato quando viene fatto clic su un poligono. Per annullare l'impostazione del callback, utilizza null.

public void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener listener)

Imposta un callback che viene richiamato quando viene fatto clic su una polilinea.

Parametri

listener	Il callback richiamato quando viene fatto clic su una polilinea. Per annullare l'impostazione del callback, utilizza null.

public void setPadding (int sinistra, int superiore, int destra, int inferiore)

Imposta la spaziatura interna sulla mappa.

Questo metodo ti consente di definire un'area visibile sulla mappa, per segnalare alla mappa che parti della mappa intorno ai bordi potrebbero essere oscurate impostando la spaziatura interna su ciascuno dei quattro bordi della mappa. Le funzioni di mappa verranno adattate alla spaziatura interna. Ad esempio, i controlli per lo zoom, la bussola, le note sul copyright e il logo di Google saranno spostati per adattarsi all'area geografica definita, i movimenti della fotocamera saranno relativi al centro dell'area visibile, ecc.

Parametri

sinistro	Il numero di pixel della spaziatura interna da aggiungere a sinistra della mappa.
superiore	Il numero di pixel della spaziatura interna da aggiungere nella parte superiore della mappa.
destro	Il numero di pixel di spaziatura interna da aggiungere a destra della mappa.
inferiore	Il numero di pixel della spaziatura interna da aggiungere nella parte inferiore della mappa.

public void setTrafficEnabled (booleano abilitato)

Attiva o disattiva il livello di traffico.

Parametri

abilitata

pubblico void snapshot ( callbackGoogleMap.SnapshotReadyCallback)

Scatta un'istantanea della mappa.

Puoi utilizzare gli snapshot all'interno della tua applicazione nei casi in cui una mappa interattiva sarebbe difficile o impossibile da utilizzare. Ad esempio, le immagini prodotte con il metodo snapshot() possono essere utilizzate per visualizzare una miniatura della mappa nella tua app o un'istantanea nel centro notifiche.

Nota: le immagini della mappa non devono essere trasmesse ai server o altrimenti utilizzate al di fuori dell'applicazione. Se devi inviare una mappa a un'altra applicazione o a un altro utente, invia dati che consentano di ricostruire la mappa per il nuovo utente anziché uno snapshot.

Parametri

callback	Metodo di callback richiamato quando viene acquisito lo snapshot.

pubblico void snapshot (GoogleMap.SnapshotReadyCallback callback, bitmap Bitmap)

Scatta un'istantanea della mappa.

Questo metodo è equivalente a snapshot(SnapshotReadyCallback), ma ti consente di fornire un Bitmap preallocato. Se la bitmap non corrisponde alle dimensioni correnti della mappa, verrà allocata un'altra bitmap che corrisponde alle dimensioni della mappa.

Anche se nella maggior parte dei casi l'oggetto trasmesso dal metodo di callback è uguale a quello fornito nel parametro per questo metodo, in alcuni casi l'oggetto restituito può essere diverso (ad esempio, se le dimensioni della vista sono state modificate al momento in cui viene effettivamente acquisito lo snapshot). Pertanto, devi considerare attendibili solo i contenuti della bitmap trasmessa dal metodo di callback.

Parametri

callback	Metodo di callback richiamato quando viene acquisito lo snapshot.
bitmap	Una bitmap preallocata. Se null, si comporta come snapshot(SnapshotReadyCallback).

pubblica void stopAnimation ()

Interrompe l'animazione della videocamera, se presente. Quando il metodo viene richiamato, la fotocamera smette di muoversi immediatamente e rimane in quella posizione.