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 | |
GroundOverlay | |
Indicatore | |
Poligono | |
Polilinea | |
TileOverlay | |
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 | |
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 |
setOnCameraChangeListener(listener GoogleMap.OnCameraChangeListener)
Questo metodo è stato ritirato.
Sostituito da
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener) , setOnCameraMoveListener(GoogleMap.OnCameraMoveListener) , setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) e setOnCameraIdleListener(GoogleMap.OnCameraIdleListener) .
|
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 | |
void | |
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.
pubblico statico int finale MAP_TYPE_NONE
Nessun riquadro della mappa base.
pubblico statico int finale MAP_TYPE_NORMAL
Mappe di base.
pubblico statico int finale MAP_TYPE_SATELLITE
Mappe satellitari senza etichette.
pubblico statico int finale MAP_TYPE_TERRAIN
Mappe dei rilievi.
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
GroundOverlay
aggiunto alla mappa.
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
Marker
aggiunto alla mappa.
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
TileOverlay
aggiunto alla mappa.
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
user location
attualmente visualizzato.
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
Projection
della mappa nello stato attuale.
pubblica UiSettings getUiSettings ()
Restituisce le impostazioni dell'interfaccia utente per la mappa.
Ritorni
UiSettings
per questa mappa.
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 conMapStyleOptions
, 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:
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 base.
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.