CameraUpdateFactory

public final class CameraUpdateFactory erweitert Objekt

Eine Klasse mit Methoden zum Erstellen von CameraUpdate-Objekten, die die Kamera einer Karte ändern. Um die Kamera der Karte zu ändern, rufen Sie animateCamera(CameraUpdate), animateCamera(CameraUpdate, GoogleMap.CancelableCallback) oder moveCamera(CameraUpdate) auf. Verwenden Sie dazu ein CameraUpdate-Objekt, das mit dieser Klasse erstellt wurde.

Um beispielsweise eine Karte heranzuzoomen, können Sie folgenden Code verwenden:

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

Bevor Sie Methoden aus dieser Klasse verwenden, müssen Sie einen der folgenden Schritte ausführen, um sicherzustellen, diese Klasse initialisiert:

• Warten Sie, bis ein GoogleMap von einem MapFragment oder MapView verfügbar ist, das Sie Ihrer Anwendung hinzugefügt haben. Sie erhalten die GoogleMap durch Aufrufen von getMapAsync() und Warten auf den onMapReady(GoogleMap map)-Callback.
• Rufen Sie einfach initialize(Context) an. Solange kein GooglePlayServicesNotAvailableException ausgegeben wird, ist diese Klasse korrekt. initialisiert.

Entwicklerleitfaden

Weitere Informationen finden Sie im Artikel Kamera und Ansicht. Entwicklerleitfaden.

Public Method Summary

Statisch CameraUpdate	newCameraPosition(CameraPosition cameraPosition) Gibt ein CameraUpdate zurück, das die Kamera zu einem angegebenen CameraPosition bewegt.
Statisch CameraUpdate	newLatLng(LatLng-Breitengrad) Gibt eine CameraUpdate zurück, die die Mitte des Bildschirms auf einen Breiten- und Längengrad verschoben. Das Objekt wird durch ein LatLng-Objekt angegeben.
Statisch CameraUpdate	newLatLngBounds(LatLngBounds-Grenzen, int-Breite, int-Höhe, int-Abstände) Gibt ein CameraUpdate zurück, das die Kamera so transformiert, dass die angegebene Die Breiten- und Längengradgrenzen werden auf dem Bildschirm innerhalb eines Markierungsrahmens mit angegebenen Abmessungen zentriert. mit der größtmöglichen Zoomstufe dargestellt.
Statisch CameraUpdate	newLatLngBounds(LatLngBounds-Grenzen, int-Padding) Gibt ein CameraUpdate zurück, das die Kamera so transformiert, dass die angegebene Breiten- und Längengradgrenzen werden bei der größtmöglichen Zoomstufe auf dem Bildschirm zentriert.
Statisch CameraUpdate	newLatLngZoom(LatLng latLng, float zoom) Gibt eine CameraUpdate zurück, die die Mitte des Bildschirms auf einen Breiten- und Längengrad verschoben. das durch ein LatLng-Objekt angegeben wird, und bewegt sich auf die angegebene Zoomstufe.
Statisch CameraUpdate	scrollBy(Gleitkommazahl xPixel, Gleitkommazahl yPixel) Gibt ein CameraUpdate zurück, mit dem die Kamera über die Karte bewegt und dabei der Mittelpunkt Ansicht um die angegebene Anzahl von Pixeln in x- und y-Richtung.
Statisch CameraUpdate	zoomBy(Gleitkommazahl, Punktfokus) Gibt ein CameraUpdate zurück, das die Zoomstufe des aktuellen Kamerablickpunkts verschiebt.
Statisch CameraUpdate	zoomBy(Gleitkommazahl) Gibt ein CameraUpdate zurück, das die Zoomstufe des aktuellen Kamerablickpunkts verschiebt.
Statisch CameraUpdate	zoomIn() Gibt ein Objekt vom Typ CameraUpdate zurück, das die Karte heranzoomt, indem es die Höhe des Aussichtspunkts näher heranzoomt an die Erdoberfläche zu übertragen.
Statisch CameraUpdate	zoomOut() Gibt ein CameraUpdate zurück, mit dem durch Verschieben der Höhe des Blickwinkels aus der Karte herausgezoomt wird weiter von der Erdoberfläche entfernt sind.
Statisch CameraUpdate	zoomTo(unverankertes Zoomen) Gibt ein CameraUpdate zurück, mit dem der Kamerablickpunkt auf eine bestimmte Zoomstufe verschoben wird.

Inherited Method Summary

From class java.lang.Object

boolean	equals(Objekt arg0)
letzte Klasse<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate newCameraPosition (CameraPosition cameraPosition)

Gibt ein CameraUpdate zurück, das die Kamera zu einem angegebenen CameraPosition bewegt. In wird eine Transformation ausgehend vom Breitengrad des CameraPosition-Objekts erstellt. Längengrad, Zoomstufe, Peilung und Neigung.

Parameter

cameraPosition

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate newLatLng (LatLng latLng)

Gibt eine CameraUpdate zurück, die die Mitte des Bildschirms auf einen Breiten- und Längengrad verschoben. Das Objekt wird durch ein LatLng-Objekt angegeben. Dadurch wird die Kamera auf das LatLng-Objekt zentriert.

Parameter

latLng	Ein LatLng-Objekt, das den gewünschten Breiten- und Längengrad enthält.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate newLatLngBounds (LatLngBounds-Grenzen, int-Breite, int-Höhe, int-Abstand)

Gibt ein CameraUpdate zurück, das die Kamera so transformiert, dass die angegebene Die Breiten- und Längengradgrenzen werden auf dem Bildschirm innerhalb eines Markierungsrahmens mit angegebenen Abmessungen zentriert. mit der größtmöglichen Zoomstufe dargestellt. Sie können einen zusätzlichen Abstand angeben, die Größe des Begrenzungsrahmens. Die zurückgegebene CameraUpdate hat eine Peilung von 0 und eine Neigung von 0.

Im Gegensatz zu newLatLngBounds(LatLngBounds, int) können Sie die CameraUpdate verwenden zurückgegeben, um die Kamera vor der Layoutphase der Karte zu ändern, da das -Argumente geben die gewünschte Größe des Begrenzungsrahmens an.

Parameter

Grenzen	Der Bereich, der in den Begrenzungsrahmen passt
Breite	Breite des Begrenzungsrahmens in Pixeln (px)
Höhe	Höhe des Begrenzungsrahmens in Pixeln (px)
padding	Zusätzliche Größenbeschränkung (in Pixel) des Begrenzungsrahmens

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate newLatLngBounds (LatLngBounds-Grenzen, Ganzzahlabstand)

Gibt ein CameraUpdate zurück, das die Kamera so transformiert, dass die angegebene Breiten- und Längengradgrenzen werden bei der größtmöglichen Zoomstufe auf dem Bildschirm zentriert. Sie können Padding angeben, um den Markierungsrahmen von den Rändern der Kartenansicht aus zu setzen. Die zurückgegebene CameraUpdate hat eine Peilung von 0 und eine Neigung von 0.

Ändern Sie die Kamera mit diesem Kameraupdate erst, wenn die Karte (im damit diese Methode den entsprechenden Markierungsrahmen und die Zoomstufe korrekt bestimmt, Karte muss eine Größe haben). Andernfalls wird IllegalStateException ausgegeben. NICHT damit die Karte verfügbar ist. muss die Ansicht mit der Karte ebenfalls überarbeitet worden sein. sodass die Abmessungen bestimmt wurden. Wenn Sie nicht sicher sind, ist, verwenden Sie stattdessen newLatLngBounds(LatLngBounds, int, int, int) und geben Sie der Karte manuell anpassen.

Parameter

Grenzen	Bereich, der auf den Bildschirm passt
padding	Abstand (in Pixel) zwischen den Rändern des Begrenzungsrahmens und den Ansichtsrändern. Dieses -Wert auf alle vier Seiten des Begrenzungsrahmens angewendet.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate newLatLngZoom (LatLng latLng, Float-Zoom)

Gibt eine CameraUpdate zurück, die die Mitte des Bildschirms auf einen Breiten- und Längengrad verschoben. das durch ein LatLng-Objekt angegeben wird, und bewegt sich auf die angegebene Zoomstufe.

Parameter

latLng	Ein LatLng-Objekt, das den gewünschten Breiten- und Längengrad enthält.
Zoom	die gewünschte Zoomstufe zwischen 2,0 und 21,0. Werte unter diesem Bereich sind auf 2,0 und die Werte darüber auf 21,0. Erhöhen Sie den Wert, um heranzuzoomen. Nicht alle Bereiche haben Kacheln in den größten Zoomstufen.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate scrollBy (Gleitkommazahl x Pixel, Gleitkommazahl yPixel)

Gibt ein CameraUpdate zurück, mit dem die Kamera über die Karte bewegt und dabei der Mittelpunkt Ansicht um die angegebene Anzahl von Pixeln in x- und y-Richtung.

Beispiele:

• Wenn xPixel = 5 und yPixel = 0, scrollt das System nach rechts, indem es die Kamera so weit bewegt, dass das die Karte so aussieht, als wäre sie um 5 Pixel nach links verschoben worden.
• Wenn xPixel = 0 und yPixel = 5, scrollt das System nach unten, indem es die Kamera so bewegt, dass das die Karte so aussieht, als wäre sie um 5 Pixel nach oben verschoben worden.

Scrollaktionen beziehen sich auf die aktuelle Ausrichtung der Karte. Wenn die Kamera zum Beispiel eine Neigung von 90 Grad, dann ist Osten "oben" Durch Scrollen nach rechts bewegt sich die Kamera nach Süden.

Parameter

xPixel	Anzahl der Pixel zum horizontalen Scrollen Bei einem positiven Wert wird die Kamera in Bezug auf seine aktuelle Ausrichtung. Ein negativer Wert bewegt die Kamera links in Bezug auf die aktuelle Ausrichtung.
yPixel	Anzahl der Pixel, in der vertikal gescrollt werden soll. Bei einem positiven Wert bewegt sich die Kamera in Bezug auf die aktuelle Ausrichtung nach unten zeigen. Ein negativer Wert bewegt die Kamera im Hinblick auf die aktuelle Ausrichtung nach oben.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate zoomBy (Gleitkommazahl, Punktfokus)

Gibt ein CameraUpdate zurück, das die Zoomstufe des aktuellen Kamerablickpunkts verschiebt.

Ein durch den Fokus angegebene Punkt bleibt unveränderlich, d.h. er entspricht demselben Breiten- und Längengrad vor und nach dem Zoomen.

Diese Methode unterscheidet sich von zoomTo(float) insofern, als die Zoomstufe relativ zum aktuellen Wert ist Kamera.

Wenn sich beispielsweise LatLng (11.11; 22.22) gerade an der Bildschirmposition (23, 45). Nach dem Aufrufen dieser Methode mit einem Zoomwert und diesem LatLng wird die Bildschirmposition dieser LatLng ist immer noch (23, 45).

Parameter

Betrag	um die Zoomstufe zu ändern. Positive Werte zeigen an, wie nahe an den der Erde, während negative Werte das Heranzoomen von der Erdoberfläche Earth.
Fokus	Pixelposition auf dem Bildschirm, die nach dem Zoomen unveränderlich bleiben soll. Die Breiten- und Längengrade, die sich vor der Kamerabewegung an dieser Pixelposition befanden, bleiben unverändert. nachdem die Kamera bewegt wurde.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate zoomBy (Gleitkommazahl)

Gibt ein CameraUpdate zurück, das die Zoomstufe des aktuellen Kamerablickpunkts verschiebt.

Diese Methode unterscheidet sich von zoomTo(float) insofern, als die Zoomstufe relativ zum aktuellen Wert ist Kamera.

Parameter

Betrag	um die Zoomstufe zu ändern. Positive Werte zeigen an, wie nahe an den der Erde, während negative Werte das Heranzoomen von der Erdoberfläche Earth.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate zoomIn ()

Gibt ein Objekt vom Typ CameraUpdate zurück, das die Karte heranzoomt, indem es die Höhe des Aussichtspunkts näher heranzoomt an die Erdoberfläche zu übertragen. Die Zoomstufe beträgt 1,0.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate zoomOut ()

Gibt ein CameraUpdate zurück, mit dem durch Verschieben der Höhe des Blickwinkels aus der Karte herausgezoomt wird weiter von der Erdoberfläche entfernt sind. Die Zoomstufe beträgt -1,0.

Gibt Folgendes zurück:

• Eine CameraUpdate, die die Transformation enthält.

<ph type="x-smartling-placeholder"></ph> öffentlich Statisch CameraUpdate zoomTo (Unkomplizierter Zoom)

Gibt ein CameraUpdate zurück, mit dem der Kamerablickpunkt auf eine bestimmte Zoomstufe verschoben wird.

Parameter

Zoom	die gewünschte Zoomstufe zwischen 2,0 und 21,0. Werte unter diesem Bereich sind auf 2,0 und die Werte darüber auf 21,0. Erhöhen Sie den Wert, um heranzuzoomen. Nicht alle Bereiche haben Kacheln in den größten Zoomstufen.