Google Maps

classe pubblica finale GoogleMap estende Object

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

Nota: analogamente a un oggetto View, un GoogleMap può essere letto e modificato solo dal thread dell'interfaccia utente di Android. La chiamata dei metodi GoogleMap da un altro thread comporterà un'eccezione.

Invece di spostare la mappa, puoi regolare il punto di vista di una mappa cambiando la posizione della fotocamera. Puoi utilizzare la fotocamera della mappa per impostare parametri quali posizione, livello di zoom, angolo di inclinazione e orientamento. Per ulteriori informazioni, vedi Fotocamera e visualizzazione.

Guida per gli sviluppatori

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

Riepilogo dei corsi nidificati

interfaccia GoogleMap.CancelableCallback Un'interfaccia di callback per i report quando un'attività viene completata o annullata. 
interfaccia GoogleMap.InfoWindowAdapter Fornisce visualizzazioni per il rendering personalizzato delle finestre informative. 
interfaccia GoogleMap.OnCameraChangeListener Questa interfaccia è stata ritirata. 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 cambio fotocamera non è definito.  
interfaccia GoogleMap.OnCameraIdleListener Interfaccia di callback per quando termina il movimento della videocamera. 
interfaccia GoogleMap.OnCameraMoveCanceledListener Interfaccia di richiamata per quando il movimento della videocamera si è interrotto o quando la videocamera inizia a muoversi per un nuovo motivo. 
interfaccia GoogleMap.OnCameraMoveListener Interfaccia di callback per quando la fotocamera cambia posizione. 
interfaccia GoogleMap.OnCameraMoveStartedListener Interfaccia di callback per l'avvio del movimento della videocamera. 
interfaccia GoogleMap.OnCircleClickListener Interfaccia di callback per i clic su una cerchia. 
interfaccia GoogleMap.OnGroundOverlayClickListener Interfaccia di callback per i clic su un overlay al suolo. 
interfaccia GoogleMap.OnIndoorStateChangeListener Un listener per la modifica dello stato interno. 
interfaccia GoogleMap.OnInfoWindowClickListener Interfaccia di callback per gli eventi di clic o tocco nella finestra informativa di un indicatore. 
interfaccia GoogleMap.OnInfoWindowCloseListener Interfaccia di callback per gli eventi di chiusura nella finestra informativa di un indicatore. 
interfaccia GoogleMap.OnInfoWindowLongClickListener Interfaccia di callback per quando l'utente esercita una pressione prolungata sulla finestra informativa di un indicatore. 
interfaccia GoogleMap.OnMapClickListener Interfaccia di callback per quando l'utente tocca la mappa. 
interfaccia GoogleMap.OnMapLoadedCallback Interfaccia di callback per il completamento del rendering della mappa. 
interfaccia GoogleMap.OnMapLongClickListener Interfaccia di callback per quando l'utente esercita una pressione prolungata sulla mappa. 
interfaccia GoogleMap.OnMarkerClickListener Definisce le firme per i metodi che vengono richiamati quando si tocca un indicatore o si fa clic su un indicatore. 
interfaccia GoogleMap.OnMarkerDragListener Interfaccia di callback per gli eventi di trascinamento sugli indicatori. 
interfaccia GoogleMap.OnMyLocationButtonClickListener Interfaccia di callback per quando viene fatto clic sul pulsante La mia posizione. 
interfaccia GoogleMap.OnMyLocationChangeListener Questa interfaccia è stata ritirata. Utilizza invece com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre una migliore ricerca della posizione e un consumo energetico ed è utilizzata dal punto blu "La mia posizione". Consulta il tutorial su Seleziona luogo corrente, che utilizza FusedLocationProviderApi o la Guida per gli sviluppatori di località.  
interfaccia GoogleMap.OnMyLocationClickListener Interfaccia di callback che indica quando viene fatto clic sul punto La mia posizione (che indica la posizione dell'utente).
interfaccia GoogleMap.OnPoiClickListener Un listener per i tocchi di PDI. 
interfaccia GoogleMap.OnPolygonClickListener Interfaccia di callback per il clic su un poligono. 
interfaccia GoogleMap.OnPolylineClickListener Interfaccia di callback per il clic su una polilinea. 
interfaccia GoogleMap.SnapshotReadyCallback Interfaccia di callback per notificare quando è stato acquisito lo snapshot. 

Riepilogo costante

int MAP_TYPE_HYBRID Mappe satellitari con un livello trasparente delle strade principali.
int MAP_TYPE_NONE Nessun riquadro della mappa base.
int MAP_TYPE_NORMAL Mappe di base.
int MAP_TYPE_SATELLITE Mappe satellitari senza etichette.
int MAP_TYPE_TERRAIN Mappe dei rilievi.

Riepilogo del metodo pubblico

Cerchio
addCircle(opzioni CircleOptions)
Aggiungi un cerchio a questa mappa.
GroundOverlay
addGroundOverlay(opzioni GroundOverlayOptions)
Aggiunge un'immagine a questa mappa.
Indicatore
addMarker(opzioni MarkerOptions)
Aggiunge un indicatore a questa mappa.
Poligono
addPolygon(opzioni PolygonOptions)
Aggiunge un poligono a questa mappa.
Polilinea
addPolyline(opzioni PolylineOptions)
Aggiunge una polilinea a questa mappa.
TileOverlay
addTileOverlay(opzioni TileOverlayOptions)
Aggiunge un overlay riquadro a questa mappa.
void
animateCamera(aggiornamento CameraUpdate)
Animazione del movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento.
void
animateCamera(aggiornamento di CameraUpdate, callback GoogleMap.CancelableCallback)
Anima il movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento e richiama un callback facoltativo al completamento.
void
animateCamera(aggiornamento CameraUpdate, durata Ms, callback GoogleMap.CancelableCallback)
Sposta la mappa in base all'aggiornamento con un'animazione su una durata specificata e richiama un callback facoltativo al completamento.
void
clear()
Rimuove dalla mappa tutti gli indicatori, le polilinee, i poligoni, gli overlay ecc.
CameraPosition
getCameraPosition()
Consente di acquisire la posizione corrente della fotocamera.
IndoorBuilding
getFocusedBuilding()
Consente di acquisire l'edificio attualmente attivo.
int
getMapType()
Restituisce il tipo di mappa attualmente visualizzato.
float
getMaxZoomLevel()
Restituisce il livello massimo di zoom per la posizione corrente della fotocamera.
float
getMinZoomLevel()
Restituisce il livello minimo di zoom.
Località
getMyLocation()
Questo metodo è stato ritirato. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi offre una migliore ricerca della posizione e un consumo energetico ed è utilizzata dal punto blu "La mia posizione". Consulta MyLocationDemoActivity nella cartella delle applicazioni di esempio per un codice di esempio o la Guida per gli sviluppatori di località.
Proiezione
getProjection()
Restituisce un oggetto Projection che puoi utilizzare per convertire tra le coordinate dello schermo e le coordinate di latitudine/longitudine.
UiSettings
getUiSettings()
Restituisce le impostazioni dell'interfaccia utente per la mappa.
boolean
isBuildingsEnabled()
Indica se il livello Edifici 3D è attivato.
boolean
isIndoorEnabled()
Riconosce se le mappe di interni sono attualmente attive.
boolean
isMyLocationEnabled()
Restituisce lo stato del livello la mia posizione.
boolean
isTrafficEnabled()
Verifica se la mappa fornisce dati sul traffico.
void
moveCamera(aggiornamento CameraUpdate)
Riposiziona la videocamera in base alle istruzioni definite nell'aggiornamento.
void
resetMinMaxZoomPreference()
Rimuove i limiti di zoom superiore e inferiore specificati in precedenza.
void
setBuildingsEnabled(booleano abilitato)
Attiva o disattiva il livello Edifici 3D.
void
setContentDescription(Descrizione della stringa)
Imposta un valore contentDescription per la mappa.
boolean
setIndoorEnabled(booleano attivato)
Consente di impostare se attivare o meno le mappe di interni.
void
setInfoWindowAdapter(adattatore GoogleMap.InfoWindowAdapter)
Consente di impostare un renderer personalizzato per i contenuti delle finestre informative.
void
setLatLngBoundsForCameraTarget(limiti LatLngBounds)
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.
void
setLocationSource(origine LocationSource)
Sostituisce l'origine della località del livello la mia posizione.
boolean
setMapStyle(stile MapStyleOptions)
Imposta lo stile della mappa base.
void
setMapType(tipo int)
Imposta il tipo di riquadri della mappa da visualizzare.
void
setMaxZoomPreference(maxZoomPreference in virgola mobile)
Consente di impostare un limite superiore preferito per lo zoom della fotocamera.
void
setMinZoomPreference(float minZoomPreference)
Consente di impostare un limite inferiore preferito per lo zoom della fotocamera.
void
setMyLocationEnabled(booleano attivato)
Attiva o disattiva il livello la mia posizione.
void
void
setOnCameraIdleListener(listener GoogleMap.OnCameraIdleListener)
Imposta un callback che viene attivato quando termina il movimento della videocamera.
void
setOnCameraMoveCanceledListener(listener GoogleMap.OnCameraMoveCanceledListener)
Imposta un callback che viene attivato quando il movimento della videocamera viene interrotto o interrotto da un nuovo tipo di animazione.
void
setOnCameraMoveListener(listener GoogleMap.OnCameraMoveListener)
Imposta un callback che viene richiamato più volte mentre la videocamera è in movimento.
void
setOnCameraMoveStartedListener(listener GoogleMap.OnCameraMoveStartedListener)
Imposta un callback che viene attivato quando la videocamera inizia a muoversi o il motivo del movimento della videocamera è cambiato.
void
setOnCircleClickListener(listener GoogleMap.OnCircleClickListener)
Imposta un callback che viene attivato quando viene fatto clic su un cerchio.
void
setOnGroundOverlayClickListener(listener GoogleMap.OnGroundOverlayClickListener)
Imposta un callback che viene attivato quando si fa clic su un overlay al suolo.
void
setOnIndoorStateChangeListener(listener GoogleMap.OnIndoorStateChangeListener)
Imposta o cancella il listener per gli eventi al chiuso.
void
setOnInfoWindowClickListener(listener GoogleMap.OnInfoWindowClickListener)
Imposta un callback che viene attivato quando si fa clic su una finestra informativa sull'indicatore.
void
setOnInfoWindowCloseListener(listener GoogleMap.OnInfoWindowCloseListener)
Imposta un callback che viene attivato quando la finestra informativa di un indicatore viene chiusa.
void
setOnInfoWindowLongClickListener(listener GoogleMap.OnInfoWindowLongClickListener)
Imposta un callback che viene attivato quando la finestra informativa di un indicatore viene premuta a lungo.
void
setOnMapClickListener(listener GoogleMap.OnMapClickListener)
Imposta un callback che viene attivato quando si tocca la mappa.
void
setOnMapLoadedCallback(callback GoogleMap.OnMapLoadedCallback)
Imposta un callback che viene attivato quando termina il rendering della mappa.
void
setOnMapLongClickListener(listener GoogleMap.OnMapLongClickListener)
Imposta un callback che viene attivato quando la mappa viene premuta a lungo.
void
setOnMarkerClickListener(listener GoogleMap.OnMarkerClickListener)
Imposta un callback che viene attivato quando si fa clic su un indicatore.
void
setOnMarkerDragListener(listener GoogleMap.OnMarkerDragListener)
Imposta un callback che viene attivato quando un indicatore viene trascinato.
void
setOnMyLocationButtonClickListener(listener GoogleMap.OnMyLocationButtonClickListener)
Imposta un callback che viene attivato quando si fa clic sul pulsante La mia posizione.
void
setOnMyLocationChangeListener(listener GoogleMap.OnMyLocationChangeListener)
Questo metodo è stato ritirato. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi offre una migliore ricerca della posizione e un consumo energetico ed è utilizzata dal punto blu "La mia posizione". Consulta MyLocationDemoActivity nella cartella delle applicazioni di esempio per un codice di esempio o la Guida per gli sviluppatori di località.
void
setOnMyLocationClickListener(listener GoogleMap.OnMyLocationClickListener)
Imposta un callback che viene attivato quando l'utente fa clic sul punto La mia posizione (che indica la posizione dell'utente).
void
setOnPoiClickListener(listener GoogleMap.OnPoiClickListener)
Consente di impostare un listener che viene attivato quando un PDI viene toccato o selezionato.
void
setOnPolygonClickListener(listener GoogleMap.OnPolygonClickListener)
Imposta un callback che viene attivato quando si fa clic su un poligono.
void
setOnPolylineClickListener(listener GoogleMap.OnPolylineClickListener)
Imposta un callback che viene attivato quando si fa clic su una polilinea.
void
setPadding(int left, int top, int right, int bottom)
Imposta la spaziatura interna sulla mappa.
void
setTrafficEnabled(booleano attivato)
Attiva o disattiva il livello del traffico.
void
snapshot(callback GoogleMap.SnapshotReadyCallback)
Scatta un'istantanea della mappa.
void
snapshot(callback GoogleMap.SnapshotReadyCallback, bitmap bitmap)
Scatta un'istantanea della mappa.
void
stopAnimation()
Interrompe l'animazione della videocamera, se è in corso.

Riepilogo del metodo ereditato

Costanti

pubblico statico int finale MAP_TYPE_HYBRID

Mappe satellitari con un livello trasparente delle strade principali.

Valore costante: 4

pubblico statico int finale MAP_TYPE_NONE

Nessun riquadro della mappa base.

Valore costante: 0

pubblico statico int finale MAP_TYPE_NORMAL

Mappe di base.

Valore costante: 1

pubblico statico int finale MAP_TYPE_SATELLITE

Mappe satellitari senza etichette.

Valore costante: 2

pubblico statico int finale MAP_TYPE_TERRAIN

Mappe dei rilievi.

Valore costante: 3

Metodi pubblici

pubblica Circle addCircle (opzioni CircleOptions)

Aggiungi un cerchio a questa mappa.

Parametri
opzioni Un oggetto delle opzioni del cerchio che definisce la modalità di rendering del cerchio.
Ritorni
  • L'oggetto Circle che viene aggiunto alla mappa

pubblico GroundOverlay addGroundOverlay (Opzioni GroundOverlayOptions)

Aggiunge un'immagine a questa mappa.

Parametri
opzioni Un oggetto opzioni per overlay al suolo che definisce la modalità di rendering dell'overlay. Per le opzioni deve essere specificata un'immagine (AnchoredBitmap) e la posizione specificata.
Ritorni
Tiri
IllegalArgumentException se l'immagine o la posizione non sono specificate nelle opzioni.

pubblici Marker addMarker (opzioni MarkerOptions)

Aggiunge un indicatore a questa mappa.

L'icona dell'indicatore viene visualizzata sulla mappa nella posizione Marker.position. Se fai clic sull'indicatore, la fotocamera viene centrata sull'indicatore. Se Marker.title è definito, la mappa mostra una casella informativa con il titolo e lo snippet dell'indicatore. Se l'indicatore può essere trascinato, facendo clic a lungo e poi trascinando l'indicatore lo si sposta.

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

pubblico Polygon addPolygon (opzioni di PolygonOptions)

Aggiunge un poligono a questa mappa.

Parametri
opzioni Un oggetto opzioni poligono che definisce la modalità di rendering del poligono.
Ritorni
  • L'oggetto Polygon aggiunto alla mappa.

pubblica Polyline addPolyline (opzioni di PolylineOptions)

Aggiunge una polilinea a questa mappa.

Parametri
opzioni Oggetto delle opzioni della polilinea che definisce la modalità di rendering della polilinea.
Ritorni
  • L'oggetto Polyline che è stato aggiunto alla mappa.

pubblico TileOverlay addTileOverlay (opzioni TileOverlayOptions)

Aggiunge un overlay riquadro a questa mappa. Consulta TileOverlay per saperne di più.

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 delle opzioni riquadro-overlay che definisce la modalità di rendering dell'overlay. Per le opzioni deve essere specificato un TileProvider, altrimenti verrà generato un valore IllegalArgumentException.
Ritorni
Tiri
IllegalArgumentException se TileProvider non è specificato nelle opzioni.

Public void animateCamera (Aggiornamento CameraUpdate)

Animazione del movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento. Durante l'animazione, una chiamata a getCameraPosition() restituisce una posizione intermedia della videocamera.

Consulta la pagina CameraUpdateFactory per una serie di aggiornamenti.

Parametri
update La modifica da applicare alla videocamera.

Public void animateCamera (Aggiornamento di CameraUpdate, callback GoogleMap.CancelableCallback)

Anima il movimento della videocamera dalla posizione corrente alla posizione definita nell'aggiornamento e richiama un callback facoltativo al completamento. Consulta la pagina CameraUpdateFactory per una serie di aggiornamenti.

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

Parametri
update La modifica da applicare alla videocamera.
callback Il callback da richiamare dal thread dell'interfaccia utente di Android all'arresto dell'animazione. Se l'animazione viene completata normalmente, viene chiamato onFinish(), altrimenti viene richiamato onCancel(). Non aggiornare o animare la videocamera all'interno di onCancel().

Public void animateCamera (aggiornamento di CameraUpdate, durata int Ms, callback GoogleMap.CancelableCallback)

Sposta la mappa in base all'aggiornamento con un'animazione su una durata specificata e richiama un callback facoltativo al completamento. Consulta la pagina CameraUpdateFactory per una serie di aggiornamenti.

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

Parametri
update
durationMs La durata dell'animazione in millisecondi. Deve essere rigorosamente positivo, altrimenti verrà lanciato un IllegalArgumentException.
callback Un callback facoltativo per ricevere una notifica dal thread dell'interfaccia utente di Android quando l'animazione si interrompe. Se l'animazione si interrompe a causa del suo completamento naturale, il callback riceverà una notifica con onFinish(). Se l'animazione si interrompe a causa di un'interruzione dovuta a un successivo movimento 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 è necessario un callback, lascialo impostato su null.

Public void clear ()

Rimuove dalla mappa tutti gli indicatori, le polilinee, i poligoni, gli overlay ecc.

pubblica CameraPosition getCameraPosition ()

Consente di acquisire la posizione corrente della fotocamera.

Il valore CameraPosition restituito è un'istantanea della posizione corrente e non viene aggiornato automaticamente quando la videocamera si muove.

Per ulteriori informazioni su come cambiare la posizione della fotocamera, vedi Fotocamera e visualizzazione.

Ritorni
  • La posizione corrente della fotocamera.

pubblico IndoorBuilding getFocusedBuilding ()

Consente di acquisire l'edificio attualmente attivo.

Ritorni
  • L'edificio attivo corrente o null se non c'è nessun edificio attivo.

Public int getMapType ()

Restituisce il tipo di mappa attualmente visualizzato. Consulta i criteri MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE e MAP_TYPE_TERRAIN per i valori possibili.

Ritorni
  • Il tipo di mappa.

numero in virgola mobile pubblico getMaxZoomLevel ()

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

Per ulteriori informazioni sulla modifica del livello di zoom della fotocamera, vedi Fotocamera e visualizzazione.

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

numero in virgola mobile pubblico getMinZoomLevel ()

Restituisce il livello minimo di zoom. Questo valore è uguale per tutte le località (a differenza del livello di zoom massimo), ma può variare in base al dispositivo e alle dimensioni della mappa.

Per ulteriori informazioni sulla modifica del livello di zoom della fotocamera, vedi Fotocamera e visualizzazione.

Ritorni
  • Il livello minimo di zoom disponibile.

pubblica Posizione getMyLocation ()

Questo metodo è obsoleto.
utilizza invece com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre una migliore ricerca della posizione e un consumo energetico ed è utilizzata dal punto blu "La mia posizione". Consulta MyLocationDemoActivity nella cartella delle applicazioni di esempio per un codice di esempio o la Guida per gli sviluppatori di località.

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

Ritorni
Tiri
IllegalStateException se il livello la mia posizione non è abilitato.

pubblica Projection getProjection ()

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

Il valore Projection restituito è un'istantanea della proiezione corrente e non verrà aggiornato automaticamente quando la videocamera si muove. Poiché si tratta di un'operazione costosa, dovresti eseguire la proiezione soltanto una volta per schermo. Google Maps utilizza la proiezione di Mercatore per creare le proprie mappe a partire da dati geografici e convertire i punti sulla mappa in coordinate geografiche.

Ritorni

pubblica UiSettings getUiSettings ()

Restituisce le impostazioni dell'interfaccia utente per la mappa.

Ritorni

pubblico booleano isBuildingsEnabled ()

Indica se il livello Edifici 3D è attivato.

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

pubblico booleano isIndoorEnabled ()

Riconosce se le mappe di interni sono attualmente attive.

Ritorni
  • true se le mappe di interni sono attivate; false se le mappe di interni sono disattivate;

pubblico booleano isMyLocationEnabled ()

Restituisce lo stato del livello la mia posizione.

Ritorni
  • true se il livello my-location è abilitato; false in caso contrario.

pubblico booleano isTrafficEnabled ()

Verifica se la mappa fornisce dati sul traffico. Ciò dipende dalla disponibilità dei dati sul traffico.

Ritorni
  • true se sono attivati dati sul traffico; false in caso contrario.

Public void moveCamera (aggiornamento 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 da applicare alla videocamera.

Public void resetMinMaxZoomPreference ()

Rimuove i limiti di zoom superiore e inferiore specificati in precedenza.

Public void setBuildingsEnabled (boolean enabled)

Attiva o disattiva il livello Edifici 3D.

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

Public void setContentDescription (Descrizione stringa)

Imposta un valore contentDescription per la mappa.

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

Parametri
descrizione una stringa da usare come descrizione.

pubblico booleano setIndoorEnabled (boolean enabled)

Consente di impostare se attivare o meno le mappe di interni. Attualmente, le mappe di interni possono essere visualizzate solo su una 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 disattivare le mappe di interni sulla mappa originale. Se provi ad attivare le mappe di interni quando è abilitata su un'altra mappa, non succederà nulla e verrà restituito false. Quando l'opzione Interni non è abilitata per una mappa, tutti i metodi relativi a Indoor restituiranno null o false.

Parametri
abilitata true per provare ad attivare le mappe di interni; false per disattivare le mappe di interni.
Ritorni
  • se sia stato possibile attivare le mappe di interni.

Public void setInfoWindowAdapter (adattatore GoogleMap.InfoWindowAdapter)

Consente di impostare un renderer personalizzato per i contenuti delle finestre informative.

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

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

Public void setLatLngBoundsForCameraTarget (limiti di LatLngBounds)

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.

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

Quando il valore LatLngBounds cambia, l'SDK regola tutti gli aggiornamenti successivi della videocamera per rispettare questi limiti, se possibile. Tieni presente che ci sono considerazioni tecniche che possono impedire all'SDK di mantenere l'oggetto target della videocamera rigorosamente entro i limiti. Ad esempio, errori di arrotondamento con precisione in virgola mobile o un livello di zoom molto basso.

Parametri
limiti I limiti entro i quali vincolare l'obiettivo della videocamera.

Public void setLocationSource (origine LocationSource)

Sostituisce l'origine della località del livello la mia posizione.

Parametri
origine Un'origine della posizione da utilizzare nel livello la mia posizione. Imposta su null per utilizzare l'origine della posizione predefinita.

Public boolean setMapStyle (stile MapStyleOptions)

Imposta lo stile della mappa base.

Utilizzando le opzioni di stile, puoi applicare stili personalizzati a elementi ed elementi sulla mappa. Consulta MapStyleOptions per i dettagli sulla definizione dello stile.

Imposta il valore su null per cancellare eventuali stili personalizzati precedenti.

Parametri
stile
Ritorni
  • true se lo stile è stato analizzato correttamente; false se sono stati rilevati problemi con MapStyleOptions, tra cui ad esempio JSON di stili non analizzabili, tipo di funzionalità non riconosciuto, tipo di elemento non riconosciuto o chiavi di stile non valide. Se il valore restituito è false, lo stile corrente viene lasciato invariato.

Public void setMapType (tipo int)

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

Parametri
digita Il tipo di mappa da visualizzare.

Public void setMaxZoomPreference (float maxZoomPreference)

Consente di impostare un limite superiore preferito per lo zoom della fotocamera.

Quando cambia lo zoom massimo, l'SDK regola tutti gli aggiornamenti successivi della fotocamera per rispettarlo, se possibile. Tieni presente che ci sono considerazioni tecniche che potrebbero impedire all'SDK di consentire agli utenti di aumentare troppo lo zoom nella mappa. Ad esempio, il satellite o il rilievo possono avere uno zoom massimo inferiore rispetto ai riquadri della mappa base.

L'SDK risolve eventuali conflitti nei valori minimo e massimo. Se imposti lo zoom minimo su un livello di zoom più elevato rispetto al massimo attuale, l'SDK utilizza il nuovo valore minimo per il valore minimo e massimo. Se imposti lo zoom massimo su un livello di zoom inferiore a quello minimo, l'SDK utilizza il nuovo valore massimo per entrambi i valori minimo e massimo. Ad esempio: supponiamo che lo zoom minimo attuale sia 8 e il massimo sia 14. Dopodiché imposti lo zoom massimo su 6. L'SDK utilizza uno zoom minimo di 6 e uno massimo di 6.

Parametri
maxZoomPreference Il limite superiore preferito.

Public void setMinZoomPreference (float minZoomPreference)

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

Quando cambia lo zoom minimo, l'SDK regola tutti gli aggiornamenti successivi della fotocamera per rispettare questo minimo, se possibile. Tieni presente che esistono considerazioni tecniche che potrebbero impedire all'SDK di consentire agli utenti di ridurre lo zoom in modo troppo basso.

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

Parametri
minZoomPreference Il limite inferiore preferito.

Public void setMyLocationEnabled (boolean enabled)

Attiva o disattiva il livello la mia posizione.

Quando l'opzione è abilitata e la posizione è disponibile, il livello La mia posizione traccia continuamente un'indicazione della posizione attuale e della direzione di un utente, mostrando i controlli dell'interfaccia utente che consentono all'utente di interagire con la sua posizione (ad esempio, per attivare o disattivare il monitoraggio della posizione e del rilevamento da parte della videocamera).

Per utilizzare la funzionalità a livello di 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 della posizione personalizzata tramite setLocationSource(LocationSource), l'SDK Google Maps per Android non verificherà se sono state concesse le suddette autorizzazioni. Tuttavia, devi comunque assicurarti che l'utente abbia concesso tutte le autorizzazioni necessarie per l'origine posizione personalizzata.

Parametri
abilitata true per attivare; false per disattivare.
Tiri
SecurityException se l'autorizzazione di accesso alla posizione non viene concessa.

pubblici void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener)

Questo metodo è stato ritirato.
sostituito da setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) e setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Imposta un callback che viene attivato quando la fotocamera cambia.

Parametri
listener Il callback attivato quando la fotocamera cambia. Per annullare l'impostazione del callback, utilizza null.

Public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener)

Imposta un callback che viene attivato quando termina il movimento della videocamera.

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

Public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener)

Imposta un callback che viene attivato quando il movimento della videocamera viene interrotto o interrotto da un nuovo tipo di animazione.

Parametri
listener Il callback che viene richiamato. Per annullare l'impostazione del callback, utilizza null. Non aggiornare o animare la videocamera all'interno di onCameraMoveCanceled().

pubblici void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener)

Imposta un callback che viene richiamato più volte mentre la videocamera è in movimento. Il callback può essere richiamato una volta per ogni frame e non dovrebbe eseguire operazioni costose.

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

Public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener)

Imposta un callback che viene attivato quando la videocamera inizia a muoversi o il motivo del movimento della videocamera è cambiato.

Parametri
listener Il callback che viene richiamato. Per annullare l'impostazione del callback, utilizza null. Non aggiornare o animare la videocamera all'interno di onCameraMoveStarted().

pubblici void setOnCircleClickListener (GoogleMap.OnCircleClickListener)

Imposta un callback che viene attivato quando viene fatto clic su un cerchio.

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

pubblici void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener)

Imposta un callback che viene attivato quando si fa clic su un overlay al suolo.

Parametri
listener Il callback che viene attivato quando si fa clic su un overlay al suolo. Per annullare l'impostazione del callback, utilizza null.

pubblici void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener)

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

Parametri
listener il listener per gli eventi al chiuso se non è null; in caso contrario, cancella il listener

Public void setOnInfoWindowClickListener (Listener GoogleMap.OnInfoWindowClickListener)

Imposta un callback che viene attivato quando si fa clic su una finestra informativa sull'indicatore.

Parametri
listener Il callback che viene attivato quando si fa clic su una finestra informativa su un indicatore. Per annullare l'impostazione del callback, utilizza null.

pubblici void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener)

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

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

pubblici void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener)

Imposta un callback che viene attivato quando la finestra informativa di un indicatore viene premuta a lungo.

Parametri
listener Il callback che viene attivato quando la finestra informativa di un indicatore viene premuta a lungo. Per annullare l'impostazione del callback, utilizza null.

Public void setOnMapClickListener (Listener GoogleMap.OnMapClickListener)

Imposta un callback che viene attivato quando si tocca la mappa.

Parametri
listener Il callback attivato quando viene toccato la mappa. Per annullare l'impostazione del callback, utilizza null.

Public void setOnMapLoadedCallback (callback GoogleMap.OnMapLoadedCallback)

Imposta un callback che viene attivato quando termina il rendering della mappa. Il callback verrà richiamato solo una volta.

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

Parametri
callback Il callback viene attivato quando il rendering della mappa è terminato. Per annullare l'impostazione del callback, utilizza null.

pubblici void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener)

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

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

Public void setOnMarkerClickListener (Listener GoogleMap.OnMarkerClickListener)

Imposta un callback che viene attivato quando si fa clic su un indicatore.

Parametri
listener Il callback che viene attivato quando si fa clic su un indicatore. Per annullare l'impostazione del callback, utilizza null.

Public void setOnMarkerDragListener (Listener GoogleMap.OnMarkerDragListener)

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

Parametri
listener Il callback attivato per gli eventi di trascinamento degli indicatori. Per annullare l'impostazione del callback, utilizza null.

Public void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener)

Imposta un callback che viene attivato quando si fa clic sul pulsante La mia posizione.

Se listener restituisce true, l'evento viene consumato e il comportamento predefinito non si verifica. Se restituisce false, verrà applicato il comportamento predefinito (ovvero la videocamera si muove in modo da essere centrata sulla posizione dell'utente).

Parametri
listener Il callback che viene attivato quando si fa clic sul pulsante La mia posizione.

Public void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener)

Questo metodo è obsoleto.
utilizza invece com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi offre una migliore ricerca della posizione e un consumo energetico ed è utilizzata dal punto blu "La mia posizione". Consulta MyLocationDemoActivity nella cartella delle applicazioni di esempio per un codice di esempio o la Guida per gli sviluppatori di località.

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

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

pubblici void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener)

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

Parametri
listener Il callback che viene attivato quando si fa clic sul punto La mia posizione.

pubblici void setOnPoiClickListener (GoogleMap.OnPoiClickListener)

Consente di impostare un listener che viene attivato quando un PDI viene toccato o selezionato.

Supera null per eliminare l'ascoltatore.

Parametri
listener

Public void setOnPolygonClickListener (Listener GoogleMap.OnPolygonClickListener)

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

Parametri
listener Il callback attivato quando si fa clic su un poligono. Per annullare l'impostazione del callback, utilizza null.

Public void setOnPolylineClickListener (Listener GoogleMap.OnPolylineClickListener)

Imposta un callback che viene attivato quando si fa clic su una polilinea.

Parametri
listener Il callback attivato quando si fa clic su una polilinea. Per annullare l'impostazione del callback, utilizza null.

Public void setPadding (int left, int top, int right, int bottom)

Imposta la spaziatura interna sulla mappa.

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

Parametri
a sinistra il numero di pixel di spaziatura interna da aggiungere a sinistra della mappa.
superiore il numero di pixel di spaziatura interna da aggiungere alla parte superiore della mappa.
a destra il numero di pixel di spaziatura interna da aggiungere a destra della mappa.
inferiore il numero di pixel di spaziatura interna da aggiungere nella parte inferiore della mappa.

Public void setTrafficEnabled (boolean enabled)

Attiva o disattiva il livello del traffico.

Parametri
abilitata

Public void snapshot (callback GoogleMap.SnapshotReadyCallback)

Scatta un'istantanea della mappa.

Puoi utilizzare gli snapshot all'interno della tua applicazione quando 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 tuoi server né utilizzate in altro modo 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é un'istantanea.

Parametri
callback Metodo di callback richiamato quando viene acquisito lo snapshot.

pubblici void snapshot (callback GoogleMap.SnapshotReadyCallback, bitmap bitmap)

Scatta un'istantanea della mappa.

Questo metodo è equivalente a snapshot(SnapshotReadyCallback), ma consente di fornire un Bitmap preallocato. Se la bitmap non corrisponde alle dimensioni correnti della mappa, viene assegnata un'altra bitmap che si adatta alle dimensioni della mappa.

Sebbene nella maggior parte dei casi l'oggetto trasmesso dal metodo di callback sia lo stesso di quello specificato nel parametro di questo metodo, in alcuni casi l'oggetto restituito può essere diverso (ad esempio, se le dimensioni della vista sono cambiate nel momento in cui lo snapshot viene effettivamente acquisito). Di conseguenza, devi considerare attendibili solo i contenuti della bitmap trasmessi 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).

Public void stopAnimation ()

Interrompe l'animazione della videocamera, se è in corso. Quando viene richiamato il metodo, la fotocamera si ferma immediatamente e rimane in quella posizione.