CameraUpdateFactory

lezione finale pubblica CameraUpdateFactory estende l'oggetto

Una classe contenente metodi per la creazione di oggetti CameraUpdate che modificano la fotocamera di una mappa. Per modificare la fotocamera della mappa, chiama animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) o moveCamera(CameraUpdate), utilizzando un oggetto CameraUpdate creato con questa classe.

Ad esempio, per aumentare lo zoom su una mappa, puoi utilizzare il seguente codice: 

GoogleMap map = ...;
 map.animateCamera(CameraUpdateFactory.zoomIn());

Prima di utilizzare uno qualsiasi dei metodi di questa classe, devi eseguire una delle seguenti operazioni per assicurarti questa classe è inizializzata:

Guida per gli sviluppatori

Per ulteriori informazioni, leggi il post Fotocamera e vista guida per gli sviluppatori.

Riepilogo del metodo pubblico

statico CameraUpdate
newCameraPosition(CameraPosition cameraPosition)
Restituisce un CameraUpdate che sposta la fotocamera verso un CameraPosition specificato.
statico CameraUpdate
newLatLng(LatLng latLng)
Restituisce un valore CameraUpdate che sposta il centro dello schermo verso una latitudine e una longitudine specificato da un oggetto LatLng.
statico CameraUpdate
newLatLngBounds(limiti di LatLngBounds, larghezza int, altezza int, spaziatura interna int)
Restituisce un valore CameraUpdate che trasforma la fotocamera in modo che l'oggetto i limiti di latitudine/longitudine sono centrati sullo schermo entro un riquadro di delimitazione delle dimensioni specificate al massimo livello di zoom possibile.
statico CameraUpdate
newLatLngBounds(limiti di LatLngBounds, spaziatura interna int)
Restituisce un valore CameraUpdate che trasforma la fotocamera in modo che l'oggetto i limiti di latitudine/longitudine sono centrati sullo schermo al massimo livello di zoom possibile.
statico CameraUpdate
newLatLngZoom(LatLng latLng, zoom mobile)
Restituisce un valore CameraUpdate che sposta il centro dello schermo verso una latitudine e una longitudine specificato da un oggetto LatLng e si sposta al livello di zoom specificato.
statico CameraUpdate
scrollBy(xPixel in virgola mobile, yPixel in virgola mobile)
Restituisce un CameraUpdate che fa scorrere la fotocamera sulla mappa, spostando il centro di per il numero di pixel specificato nelle direzioni x e y.
statico CameraUpdate
zoomBy(quantità in virgola mobile, Punto di messa a fuoco)
Restituisce un valore CameraUpdate che sposta il livello di zoom del punto di vista corrente della videocamera.
statico CameraUpdate
zoomBy(quantità in virgola mobile)
Restituisce un valore CameraUpdate che sposta il livello di zoom del punto di vista corrente della videocamera.
statico CameraUpdate
zoomIn()
Restituisce un valore CameraUpdate che aumenta lo zoom sulla mappa spostando l'altezza del punto di vista più vicino. sulla superficie terrestre.
statico CameraUpdate
zoomOut()
Restituisce un valore CameraUpdate che diminuirà lo zoom sulla mappa spostando l'altezza del punto di vista lontano dalla superficie terrestre.
statico CameraUpdate
zoomTo(zoom mobile)
Restituisce un valore CameraUpdate che sposta il punto di vista della fotocamera a un determinato livello di zoom.

Riepilogo del metodo ereditato

Metodi pubblici

pubblica statico CameraUpdate newCameraPosition (CameraPosition cameraPosition)

Restituisce un CameraUpdate che sposta la fotocamera verso un CameraPosition specificato. Nella , viene creata una trasformazione dalla latitudine dell'oggetto CameraPosition, longitudine, livello di zoom, orientamento e inclinazione.

Parametri
cameraPosition
Resi

pubblica statico CameraUpdate newLatLng (LatLng latLng)

Restituisce un valore CameraUpdate che sposta il centro dello schermo verso una latitudine e una longitudine specificato da un oggetto LatLng. In questo modo la fotocamera viene centrata sull'oggetto LatLng.

Parametri
latLng un oggetto LatLng contenente la latitudine e la longitudine desiderate.
Resi

pubblica statico CameraUpdate newLatLngBounds (LatLngBounds limiti, larghezza int, altezza int, spaziatura interna int)

Restituisce un valore CameraUpdate che trasforma la fotocamera in modo che l'oggetto i limiti di latitudine/longitudine sono centrati sullo schermo entro un riquadro di delimitazione delle dimensioni specificate al massimo livello di zoom possibile. Puoi specificare una spaziatura interna aggiuntiva per limitare ulteriormente la dimensione del riquadro di delimitazione. L'elemento CameraUpdate restituito ha un rilevamento pari a 0 e un'inclinazione pari a 0.

A differenza di newLatLngBounds(LatLngBounds, int), puoi usare CameraUpdate restituito da questo metodo per cambiare la fotocamera prima della fase di layout della mappa, perché argomenti specifica la dimensione desiderata del riquadro di delimitazione.

Parametri
limiti la regione affinché rientri nel riquadro di delimitazione
larghezza larghezza del riquadro di delimitazione in pixel (px)
altezza altezza del riquadro di delimitazione in pixel (px)
padding limitazione aggiuntiva delle dimensioni (in px) del riquadro di delimitazione
Resi

pubblica statico CameraUpdate newLatLngBounds (limiti di LatLngBounds, spaziatura interna int)

Restituisce un valore CameraUpdate che trasforma la fotocamera in modo che l'oggetto i limiti di latitudine/longitudine sono centrati sullo schermo al massimo livello di zoom possibile. Puoi specificare la spaziatura interna per inserire il riquadro di delimitazione dai bordi della visualizzazione mappa. L'oggetto restituito CameraUpdate ha un rilevamento pari a 0 e un'inclinazione pari a 0.

Non cambiare fotocamera con questo aggiornamento della fotocamera finché la mappa non è stata progettata (in per consentire a questo metodo di determinare correttamente il riquadro di delimitazione e il livello di zoom appropriati, la mappa deve avere una dimensione). In caso contrario, verrà lanciato un IllegalStateException. NON è sufficiente affinché la mappa sia disponibile; anche la vista contenente la mappa deve essere stata layout in modo che le dimensioni siano state stabilite. Se non hai la certezza che siano è stato eseguito, utilizza invece newLatLngBounds(LatLngBounds, int, int, int) e fornisci il manualmente le dimensioni della mappa.

Parametri
limiti regione per adattarsi allo schermo
padding spazio (in px) da lasciare tra i bordi del riquadro di delimitazione e i bordi della visualizzazione. Questo viene applicato a tutti e quattro i lati del riquadro di delimitazione.
Resi

pubblica statico CameraUpdate newLatLngZoom (LatLng latLng, zoom mobile)

Restituisce un valore CameraUpdate che sposta il centro dello schermo verso una latitudine e una longitudine specificato da un oggetto LatLng e si sposta al livello di zoom specificato.

Parametri
latLng un oggetto LatLng contenente la latitudine e la longitudine desiderate.
zoom il livello di zoom desiderato, compreso tra 2,0 e 21,0. I valori al di sotto di questo intervallo sono impostato su 2,0, mentre i valori al di sopra sono impostati su 21,0. Aumenta il valore per aumentare lo zoom. Non tutte aree presentano riquadri ai livelli di zoom maggiori.
Resi

pubblica statico CameraUpdate scrollBy (xPixel in virgola mobile, yPixel in virgola mobile)

Restituisce un CameraUpdate che fa scorrere la fotocamera sulla mappa, spostando il centro di per il numero di pixel specificato nelle direzioni x e y.

Esempi:

  • Se xPixel = 5 e yPixel = 0, il sistema scorre verso destra spostando la fotocamera in modo che della mappa è stata spostata di 5 pixel a sinistra.
  • Se xPixel = 0 e yPixel = 5, il sistema scorre verso il basso spostando la fotocamera in modo che della mappa sembra essere spostato di 5 pixel verso l'alto.

Lo scorrimento è relativo all'orientamento corrente della fotocamera. Ad esempio, se la videocamera è di 90 gradi, mentre l'est è "in alto" se scorri verso destra, la fotocamera sposterà la fotocamera verso sud.

Parametri
xPixel il numero di pixel per scorrere orizzontalmente. Un valore positivo sposta la fotocamera in a destra, rispetto all'orientamento corrente. Un valore negativo sposta la fotocamera in a sinistra, rispetto all'orientamento corrente.
yPixel il numero di pixel per lo scorrimento verticale. Un valore positivo sposta la fotocamera verso il basso, rispetto al suo orientamento corrente. Un valore negativo sposta la fotocamera verso l'alto, rispetto al suo orientamento corrente.
Resi

pubblica statico CameraUpdate zoomBy (Quantità in virgola mobile, Punto di messa a fuoco)

Restituisce un valore CameraUpdate che sposta il livello di zoom del punto di vista corrente della videocamera.

Un punto specificato dall'elemento attivo rimarrà fisso (ovvero, corrisponde alla stessa latitudine/longitudine entrambi i valori prima e dopo il processo di zoom).

Questo metodo è diverso da zoomTo(float) in quanto lo zoom è relativo al valore attuale fotocamera.

Ad esempio, se LatLng (11.11, 22.22) si trova attualmente nella posizione sullo schermo (23, 45). Dopo aver chiamato questo metodo con una quantità di zoom e questo LatLng, la posizione dello schermo di LatLng sarà ancora (23, 45).

Parametri
quantità per modificare il livello di zoom. I valori positivi indicano un aumento dello zoom più vicino al superficie della Terra, mentre i valori negativi indicano un allontanamento dallo zoom dalla superficie Earth.
obiettivo pixel sullo schermo che deve rimanere fissa dopo il processo di zoom. La latitudine/longitudine nella posizione del pixel in questione prima dello spostamento della videocamera rimarrà invariata dopo lo spostamento della videocamera.
Resi

pubblica statico CameraUpdate zoomBy (quantità in virgola mobile)

Restituisce un valore CameraUpdate che sposta il livello di zoom del punto di vista corrente della videocamera.

Questo metodo è diverso da zoomTo(float) in quanto lo zoom è relativo al valore attuale fotocamera.

Parametri
quantità per modificare il livello di zoom. I valori positivi indicano un aumento dello zoom più vicino al superficie della Terra, mentre i valori negativi indicano un allontanamento dallo zoom dalla superficie Earth.
Resi

pubblica statico CameraUpdate zoomIn ()

Restituisce un valore CameraUpdate che aumenta lo zoom sulla mappa spostando l'altezza del punto di vista più vicino. sulla superficie terrestre. L'incremento dello zoom è 1,0.

Resi

pubblica statico CameraUpdate zoomOut ()

Restituisce un valore CameraUpdate che diminuirà lo zoom sulla mappa spostando l'altezza del punto di vista lontano dalla superficie terrestre. L'incremento dello zoom è -1,0.

Resi

pubblica statico CameraUpdate zoomTo (zoom mobile)

Restituisce un valore CameraUpdate che sposta il punto di vista della fotocamera a un determinato livello di zoom.

Parametri
zoom il livello di zoom desiderato, compreso tra 2,0 e 21,0. I valori al di sotto di questo intervallo sono impostato su 2,0, mentre i valori al di sopra sono impostati su 21,0. Aumenta il valore per aumentare lo zoom. Non tutte aree presentano riquadri ai livelli di zoom maggiori.