GoogleMap

Öffentliche finale Klasse GoogleMap erweitert Objekt

Dies ist die Hauptklasse des Google Maps SDK for Android und der Einstiegspunkt für alle Methoden im Zusammenhang mit der Karte. Sie können ein GoogleMap-Objekt nicht direkt instanziieren. Stattdessen müssen Sie ein Objekt aus der getMapAsync()-Methode für ein MapFragment- oder MapView-Objekt abrufen, das Sie Ihrer Anwendung hinzugefügt haben.

Hinweis: Ähnlich wie ein View-Objekt kann ein GoogleMap nur aus dem Android-UI-Thread gelesen und geändert werden. Der Aufruf von GoogleMap-Methoden aus einem anderen Thread führt zu einer Ausnahme.

Sie können den Blickwinkel einer Karte anpassen, indem Sie die Kameraposition ändern, anstatt die Karte zu verschieben. Über die Kamera der Karte können Sie Parameter wie Position, Zoomstufe, Neigungswinkel und Lage festlegen. Weitere Informationen finden Sie unter Kamera und Ansicht.

Entwicklerleitfaden

Informationen zum Einstieg finden Sie im Entwicklerleitfaden für das Google Maps SDK for Android .

Zusammenfassung für geschachtelte Klassen

Oberfläche GoogleMap.CancelableCallback Eine Callback-Oberfläche für Berichte, wenn eine Aufgabe abgeschlossen oder abgebrochen wurde. 
Oberfläche GoogleMap.InfoWindowAdapter Bietet Ansichten für das benutzerdefinierte Rendering von Infofenstern. 
Oberfläche GoogleMap.OnCameraChangeListener Diese Benutzeroberfläche wurde eingestellt. Ersetzt durch GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener und GoogleMap.OnCameraIdleListener. Die Reihenfolge, in der die verworfene Methode onCameraChange im Verhältnis zu den Methoden in den neuen Kameraänderungs-Listenern aufgerufen wird, ist nicht definiert.  
Oberfläche GoogleMap.OnCameraIdleListener Callback-Schnittstelle für den Fall, dass die Kamerabewegung beendet wurde. 
Oberfläche GoogleMap.OnCameraMoveCanceledListener Callback-Schnittstelle für den Fall, dass die Bewegung der Kamera angehalten oder aus einem anderen Grund sich bewegt. 
Oberfläche GoogleMap.OnCameraMoveListener Callback-Schnittstelle für den Fall, dass sich die Kameraposition ändert. 
Oberfläche GoogleMap.OnCameraMoveStartedListener Callback-Schnittstelle für den Beginn der Kamerabewegung
Oberfläche GoogleMap.OnCircleClickListener Callback-Schnittstelle für den Fall, dass auf einen Kreis geklickt wird. 
Oberfläche GoogleMap.OnGroundOverlayClickListener Callback-Schnittstelle für den Fall, dass auf ein Boden-Overlay geklickt wird. 
Oberfläche GoogleMap.OnIndoorStateChangeListener Listener für Änderungen des Indoor-Zustands
Oberfläche GoogleMap.OnInfoWindowClickListener Callback-Oberfläche für Klick- und Tippereignisse im Infofenster einer Markierung
Oberfläche GoogleMap.OnInfoWindowCloseListener Callback-Schnittstelle für Schließereignisse im Infofenster einer Markierung
Oberfläche GoogleMap.OnInfoWindowLongClickListener Callback-Schnittstelle für den Fall, dass der Nutzer lange auf das Infofenster einer Markierung drückt. 
Oberfläche GoogleMap.OnMapClickListener Callback-Schnittstelle für den Fall, dass der Nutzer auf die Karte tippt. 
Oberfläche GoogleMap.OnMapLoadedCallback Callback-Schnittstelle für den Fall, dass das Rendern der Karte abgeschlossen ist. 
Oberfläche GoogleMap.OnMapLongClickListener Callback-Schnittstelle für den Fall, dass der Nutzer lange auf die Karte drückt. 
Oberfläche GoogleMap.OnMarkerClickListener Definiert Signaturen für Methoden, die beim Klicken oder Antippen einer Markierung aufgerufen werden. 
Oberfläche GoogleMap.OnMarkerDragListener Callback-Oberfläche für Ziehereignisse auf Markierungen
Oberfläche GoogleMap.OnMyLocationButtonClickListener Callback-Schnittstelle für den Fall, dass auf die Schaltfläche „Mein Standort“ geklickt wird. 
Oberfläche GoogleMap.OnMyLocationChangeListener Diese Benutzeroberfläche wurde eingestellt. Verwenden Sie stattdessen com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi ermöglicht eine verbesserte Standortsuche und eine verbesserte Stromnutzung und wird vom blauen Punkt „Mein Standort“ verwendet. Weitere Informationen finden Sie in der Anleitung „Current Place auswählen“, in der die FusedLocationProviderApi verwendet wird, oder im Location Developer Guide.  
Oberfläche GoogleMap.OnMyLocationClickListener Callback-Schnittstelle für den Fall, dass auf den Punkt „Mein Standort“ (der den Standort des Nutzers angibt) geklickt wird. 
Oberfläche GoogleMap.OnPoiClickListener Ein Listener für POI-Tippaktionen. 
Oberfläche GoogleMap.OnPolygonClickListener Callback-Schnittstelle für den Fall, dass ein Polygon angeklickt wird. 
Oberfläche GoogleMap.OnPolylineClickListener Callback-Schnittstelle für den Fall, dass auf eine Polylinie geklickt wird. 
Oberfläche GoogleMap.SnapshotReadyCallback Callback-Schnittstelle, über die Sie benachrichtigt werden, wenn der Snapshot aufgenommen wurde. 

Constant Summary

int MAP_TYPE_HYBRID Satellitenkarten mit einer transparenten Ebene der Hauptstraßen.
int MAP_TYPE_NONE Keine Basiskartenkacheln
int MAP_TYPE_NORMAL Basiskarten
int MAP_TYPE_SATELLITE Satellitenkarten ohne Labels.
int MAP_TYPE_TERRAIN Geländekarten

Public Method Summary

Circle
addCircle(CircleOptions-Optionen)
Kreis zu dieser Karte hinzufügen
GroundOverlay
addGroundOverlay(GroundOverlayOptions-Optionen)
Fügt dieser Karte ein Bild hinzu.
Marker
addMarker(MarkerOptions-Optionen)
Fügt dieser Karte eine Markierung hinzu.
Polygon
addPolygon(PolygonOptions-Optionen)
Fügt der Karte ein Polygon hinzu.
Polyline
addPolyline(PolylineOptions-Optionen)
Fügt der Karte eine Polylinie hinzu.
TileOverlay
addTileOverlay(TileOverlayOptions-Optionen)
Fügt dieser Karte ein Kachel-Overlay hinzu.
void
animateCamera(CameraUpdate-Update)
Animiert die Bewegung der Kamera von der aktuellen Position zu der in der Aktualisierung festgelegten Position.
void
animateCamera(CameraUpdate-Update, GoogleMap.CancelableCallback-Rückruf)
Animiert die Bewegung der Kamera von der aktuellen Position zu der in der Aktualisierung definierten Position und ruft nach Abschluss des Vorgangs einen optionalen Callback auf.
void
animateCamera(CameraUpdate-Update, int durationMs, Callback GoogleMap.CancelableCallback)
Verschiebt die Karte entsprechend dem Update mit einer Animation über eine bestimmte Dauer und ruft nach Abschluss einen optionalen Callback auf.
void
clear()
Entfernt alle Markierungen, Polylinien, Polygone, Overlays usw. von der Karte.
CameraPosition
getCameraPosition()
Ruft die aktuelle Position der Kamera ab.
IndoorBuilding
getFocusedBuilding()
Ruft das aktuell fokussierte Gebäude ab
int
getMapType()
Ruft den aktuell angezeigten Kartentyp ab.
float
getMaxZoomLevel()
Gibt die maximale Zoomstufe für die aktuelle Kameraposition zurück.
float
getMinZoomLevel()
Gibt die minimale Zoomstufe zurück.
Standort
getMyLocation()
Diese Methode wurde eingestellt. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi ermöglicht eine verbesserte Standortsuche und eine verbesserte Stromnutzung und wird vom blauen Punkt „Mein Standort“ verwendet. Beispielcode finden Sie unter „MyLocationDemoActivity“ im Ordner mit den Beispielanwendungen oder im Entwicklerleitfaden für Standorte.
Projection
getProjection()
Gibt ein Projection-Objekt zurück, mit dem Sie zwischen Bildschirmkoordinaten und Breiten- und Längengradkoordinaten konvertieren können.
UiSettings
getUiSettings()
Ruft die Einstellungen der Benutzeroberfläche für die Karte ab.
boolean
isBuildingsEnabled()
Gibt an, ob die Ebene für 3D-Gebäude aktiviert ist.
boolean
isIndoorEnabled()
Ruft ab, ob Indoor-Karten derzeit aktiviert sind.
boolean
isMyLocationEnabled()
Ruft den Status der Ebene „Mein Standort“ ab.
boolean
isTrafficEnabled()
Prüft, ob auf der Karte Verkehrsdaten erfasst werden.
void
moveCamera(CameraUpdate-Update)
Positioniert die Kamera gemäß den in der Aktualisierung definierten Anweisungen neu.
void
resetMinMaxZoomPreference()
Entfernt alle zuvor angegebenen oberen und unteren Zoomgrenzen.
void
setBuildingsEnabled(boolesch aktiviert)
Aktiviert oder deaktiviert die Ebene "3D-Gebäude".
void
setContentDescription(Stringbeschreibung)
Legt eine contentDescription für die Karte fest.
boolean
setIndoorEnabled(boolesch aktiviert)
Legt fest, ob Indoor-Karten aktiviert werden sollen.
void
setInfoWindowAdapter(GoogleMap.InfoWindowAdapter-Adapter)
Legt einen benutzerdefinierten Renderer für den Inhalt von Infofenstern fest.
void
setLatLngBoundsForCameraTarget(LatLngBounds bounds)
Gibt einen „LatLngBounds“-Wert zur Beschränkung des Kameraziels an, damit sich das Kameraziel nicht außerhalb dieser Grenzen bewegt, wenn Nutzer auf der Karte scrollen und schwenken.
void
setLocationSource(LocationSource Quelle)
Ersetzt die Standortquelle der Ebene „Mein Standort“.
boolean
setMapStyle(MapStyleOptions-Stil)
Legt den Stil der Basiskarte fest.
void
setMapType(int type)
Legt den Typ der Kartenkacheln fest, die angezeigt werden sollen.
void
setMaxZoomPreference(float maxZoompreferences)
Legt eine bevorzugte Obergrenze für den Kamerazoom fest.
void
setMinZoomPreference(float minZoomPriorität)
Legt eine bevorzugte Untergrenze für den Kamerazoom fest.
void
setMyLocationEnabled(boolesch aktiviert)
Aktiviert oder deaktiviert die Ebene „Mein Standort“.
void
void
setOnCameraIdleListener(GoogleMap.OnCameraIdleListener-Listener)
Legt einen Rückruf fest, der nach dem Ende der Kamerabewegung ausgelöst wird.
void
setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener-Listener)
Legt einen Callback fest, der ausgelöst wird, wenn die Kamerabewegung gestoppt oder durch einen neuen Animationstyp unterbrochen wird.
void
setOnCameraMoveListener(GoogleMap.OnCameraMoveListener-Listener)
Legt einen Callback fest, der wiederholt ausgelöst wird, während die Kamera in Bewegung ist.
void
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener-Listener)
Legt einen Callback fest, der ausgelöst wird, wenn die Kamerabewegung beginnt oder sich der Grund für die Kamerabewegung geändert hat.
void
setOnCircleClickListener(GoogleMap.OnCircleClickListener-Listener)
Legt einen Callback fest, der ausgelöst wird, wenn auf einen Kreis geklickt wird.
void
setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener-Listener)
Legt einen Callback fest, der beim Klicken auf ein Boden-Overlay ausgelöst wird.
void
setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener-Listener)
Legt den Listener für Indoor-Ereignisse fest oder löscht ihn.
void
setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener-Listener)
Legt einen Callback fest, der beim Klicken auf ein Infofenster einer Markierung aufgerufen wird.
void
setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener-Listener)
Legt einen Callback fest, der beim Schließen des Infofensters einer Markierung aufgerufen wird.
void
setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener-Listener)
Legt einen Callback fest, der aufgerufen wird, wenn das Infofenster einer Markierung lange gedrückt wird.
void
setOnMapClickListener(GoogleMap.OnMapClickListener-Listener)
Legt einen Callback fest, der ausgelöst wird, wenn auf die Karte getippt wird.
void
setOnMapLoadedCallback(Rückruf GoogleMap.OnMapLoadedCallback)
Legt einen Callback fest, der ausgelöst wird, wenn das Rendern dieser Karte abgeschlossen ist.
void
setOnMapLongClickListener(GoogleMap.OnMapLongClickListener-Listener)
Legt einen Callback fest, der aufgerufen wird, wenn die Karte lange gedrückt wird.
void
setOnMarkerClickListener(GoogleMap.OnMarkerClickListener-Listener)
Legt einen Callback fest, der beim Klicken auf eine Markierung aufgerufen wird.
void
setOnMarkerDragListener(GoogleMap.OnMarkerDragListener-Listener)
Legt einen Callback fest, der beim Ziehen einer Markierung aufgerufen wird.
void
setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener-Listener)
Legt einen Callback fest, der ausgelöst wird, wenn auf die Schaltfläche „Mein Standort“ geklickt wird.
void
setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener-Listener)
Diese Methode wurde eingestellt. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi ermöglicht eine verbesserte Standortsuche und eine verbesserte Stromnutzung und wird vom blauen Punkt „Mein Standort“ verwendet. Beispielcode finden Sie unter „MyLocationDemoActivity“ im Ordner mit den Beispielanwendungen oder im Entwicklerleitfaden für Standorte.
void
setOnMyLocationClickListener(GoogleMap.OnMyLocationClickListener-Listener)
Legt einen Callback fest, der ausgelöst wird, wenn auf den Punkt „Mein Standort“ (der den Standort des Nutzers angibt) geklickt wird.
void
setOnPoiClickListener(GoogleMap.OnPoiClickListener-Listener)
Legt einen Listener fest, der ausgelöst wird, wenn auf einen POI geklickt oder getippt wird.
void
setOnPolygonClickListener(GoogleMap.OnPolygonClickListener-Listener)
Legt einen Callback fest, der beim Klicken auf ein Polygon ausgelöst wird.
void
setOnPolylineClickListener(GoogleMap.OnPolylineClickListener-Listener)
Legt einen Callback fest, der beim Klicken auf eine Polylinie ausgelöst wird.
void
setPadding(int left, int top, int right, int bottom)
Legt den Innenrand auf der Karte fest.
void
setTrafficEnabled(boolesch aktiviert)
Aktiviert oder deaktiviert die Verkehrslagenebene.
void
Snapshot(GoogleMap.SnapshotReadyCallback-Rückruf)
Erstellt einen Snapshot der Karte.
void
Snapshot(GoogleMap.SnapshotReadyCallback-Callback, Bitmap-Bitmap)
Erstellt einen Snapshot der Karte.
void
stopAnimation()
Stoppt die Kameraanimation, sofern eine laufende Animation läuft.

Inherited Method Summary

Konstanten

public static final int MAP_TYPE_HYBRID

Satellitenkarten mit einer transparenten Ebene der Hauptstraßen.

Konstanter Wert: 4

public static final int MAP_TYPE_NONE

Keine Basiskartenkacheln

Konstanter Wert: 0

public static final int MAP_TYPE_NORMAL

Basiskarten

Konstanter Wert: 1

public static final int MAP_TYPE_SATELLITE

Satellitenkarten ohne Labels.

Konstanter Wert: 2

public static final int MAP_TYPE_TERRAIN

Geländekarten

Konstanter Wert: 3

Public Methods

public Circle addCircle (CircleOptions-Optionen)

Kreis zu dieser Karte hinzufügen

Parameter
Optionen Ein Kreisoptionen-Objekt, das definiert, wie der Kreis gerendert wird
Rückgaben
  • Das Circle-Objekt, das der Karte hinzugefügt wird

public GroundOverlay addGroundOverlay (GroundOverlayOptions-Optionen)

Fügt dieser Karte ein Bild hinzu.

Parameter
Optionen Ein Boden-Overlay-Optionsobjekt, das definiert, wie das Overlay gerendert wird. Für Optionen muss ein Bild (AnchoredBitmap) und eine Position angegeben sein.
Rückgaben
Löst aus
IllegalArgumentException Das Bild oder die Position sind in den Optionen nicht angegeben.

public Markierung addMarker (MarkerOptions-Optionen)

Fügt dieser Karte eine Markierung hinzu.

Das Symbol der Markierung wird auf der Karte an der Position Marker.position wiedergegeben. Wenn Sie auf die Markierung klicken, wird die Kamera zentriert. Wenn „Marker.title“ definiert ist, wird auf der Karte ein Infofenster mit dem Titel und Snippet der Markierung angezeigt. Wenn die Markierung ziehbar ist, wird sie durch langes Klicken und Ziehen verschoben.

Parameter
Optionen Ein Markierungsoptionen-Objekt, das definiert, wie die Markierung gerendert wird.
Rückgaben
  • Das Marker, das der Karte hinzugefügt wurde.

public Polygon addPolygon (PolygonOptions-Optionen)

Fügt der Karte ein Polygon hinzu.

Parameter
Optionen Ein Polygonoptionsobjekt, das definiert, wie das Polygon gerendert wird.
Rückgaben
  • Das Polygon-Objekt, das der Karte hinzugefügt wurde.

public Polyline addPolyline (PolylineOptions-Optionen)

Fügt der Karte eine Polylinie hinzu.

Parameter
Optionen Ein Polylinienoptionsobjekt, das definiert, wie die Polylinie dargestellt wird.
Rückgaben
  • Das Polyline-Objekt, das der Karte hinzugefügt wurde.

public TileOverlay addTileOverlay (TileOverlayOptions-Optionen)

Fügt dieser Karte ein Kachel-Overlay hinzu. Weitere Informationen findest du unter TileOverlay.

Im Gegensatz zu anderen Overlays werden Kachel-Overlays bei der Neuerstellung der Karte nicht automatisch wiederhergestellt und müssen manuell neu hinzugefügt werden.

Parameter
Optionen Ein Tile-Overlay-Optionsobjekt, das definiert, wie das Overlay gerendert wird. Für Optionen muss ein TileProvider angegeben werden, andernfalls wird ein IllegalArgumentException ausgegeben.
Rückgaben
Löst aus
IllegalArgumentException TileProvider ist in den Optionen nicht angegeben.

public void animateCamera (CameraUpdate-Update)

Animiert die Bewegung der Kamera von der aktuellen Position zu der in der Aktualisierung festgelegten Position. Während der Animation wird durch einen Aufruf von getCameraPosition() eine Zwischenposition der Kamera zurückgegeben.

Eine Reihe von Aktualisierungen finden Sie unter CameraUpdateFactory.

Parameter
update Die Änderung, die auf die Kamera angewendet werden soll.

public void animateCamera (CameraUpdate-Update, GoogleMap.CancelableCallback-Callback)

Animiert die Bewegung der Kamera von der aktuellen Position zu der in der Aktualisierung definierten Position und ruft nach Abschluss des Vorgangs einen optionalen Callback auf. Eine Reihe von Aktualisierungen finden Sie unter CameraUpdateFactory.

Während der Animation wird durch einen Aufruf von getCameraPosition() eine Zwischenposition der Kamera zurückgegeben.

Parameter
update Die Änderung, die auf die Kamera angewendet werden soll.
callback Der Rückruf, der vom Android-UI-Thread aufgerufen werden soll, wenn die Animation beendet wird. Wenn die Animation normal abgeschlossen wird, wird onFinish() aufgerufen. Andernfalls wird onCancel() aufgerufen. Die Kamera darf nicht innerhalb von onCancel() aktualisiert oder animiert werden.

public void animateCamera (CameraUpdate-Update, int durationMs, GoogleMap.CancelableCallback-Callback)

Verschiebt die Karte entsprechend dem Update mit einer Animation über eine bestimmte Dauer und ruft nach Abschluss einen optionalen Callback auf. Eine Reihe von Aktualisierungen finden Sie unter CameraUpdateFactory.

Wird getCameraPosition() während der Animation aufgerufen, wird der aktuelle Standort der aktiven Kamera zurückgegeben.

Parameter
update
durationMs Die Dauer der Animation in Millisekunden. Dieser Wert muss grundsätzlich positiv sein, da sonst ein IllegalArgumentException ausgegeben wird.
callback Ein optionaler Callback, der vom Android-UI-Thread benachrichtigt wird, wenn die Animation beendet wird. Wenn die Animation aufgrund des natürlichen Ablaufs gestoppt wird, wird der Callback mit onFinish() benachrichtigt. Wenn die Animation aufgrund einer späteren Kamerabewegung oder einer Nutzergeste anhält, wird onCancel() aufgerufen. Der Callback sollte nicht versuchen, die Kamera in ihrer Abbruchmethode zu bewegen oder zu animieren. Wenn kein Callback erforderlich ist, belassen Sie ihn auf null.

public void löschen ()

Entfernt alle Markierungen, Polylinien, Polygone, Overlays usw. von der Karte.

public CameraPosition getCameraPosition ()

Ruft die aktuelle Position der Kamera ab.

Das zurückgegebene CameraPosition ist ein Snapshot der aktuellen Position und wird nicht automatisch aktualisiert, wenn die Kamera bewegt wird.

Weitere Informationen zum Ändern der Kameraposition finden Sie unter Kamera und Ansicht.

Rückgaben
  • Die aktuelle Position der Kamera.

public IndoorBuilding getFocusedBuilding ()

Ruft das aktuell fokussierte Gebäude ab

Rückgaben
  • Das aktuell fokussierte Gebäude oder null, wenn kein Gebäude im Fokus ist

public int getMapType ()

Ruft den aktuell angezeigten Kartentyp ab. Mögliche Werte siehe MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN.

Rückgaben
  • Den Kartentyp

public float getMaxZoomLevel ()

Gibt die maximale Zoomstufe für die aktuelle Kameraposition zurück. Dabei wird berücksichtigt, welcher Kartentyp gerade verwendet wird. So kann z. B. eine Satelliten- oder Geländekarte eine niedrigere maximale Zoomstufe haben als die Kacheln der Basiskarte.

Weitere Informationen zum Ändern des Zoomfaktors der Kamera finden Sie unter Kamera und Ansicht.

Rückgaben
  • Die maximale Zoomstufe, die bei der aktuellen Kameraposition verfügbar ist.

public float getMinZoomLevel ()

Gibt die minimale Zoomstufe zurück. Anders als bei der maximalen Zoomstufe ist dies für jeden Standort gleich, kann aber je nach Gerät und Kartengröße variieren.

Weitere Informationen zum Ändern des Zoomfaktors der Kamera finden Sie unter Kamera und Ansicht.

Rückgaben
  • Die geringste verfügbare Zoomstufe.

public Standort getMyLocation ()

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi ermöglicht eine verbesserte Standortsuche und eine verbesserte Stromnutzung und wird vom blauen Punkt „Mein Standort“ verwendet. Beispielcode finden Sie unter „MyLocationDemoActivity“ im Ordner mit den Beispielanwendungen oder im Entwicklerleitfaden für Standorte.

Gibt den aktuell angezeigten Nutzerstandort oder null zurück, wenn keine Standortdaten verfügbar sind.

Rückgaben
Löst aus
IllegalStateException Die Ebene „Mein Standort“ ist nicht aktiviert.

public Projection getProjection ()

Gibt ein Projection-Objekt zurück, mit dem Sie zwischen Bildschirmkoordinaten und Breiten- und Längengradkoordinaten konvertieren können.

Die zurückgegebene Projection ist ein Snapshot der aktuellen Projektion und wird nicht automatisch aktualisiert, wenn die Kamera bewegt wird. Da dieser Vorgang teuer ist, sollten Sie die Projektion nur einmal pro Bildschirm erhalten. In Google Maps wird die Mercator-Projektion verwendet, um Karten aus geografischen Daten zu erstellen und Punkte auf der Karte in geografische Koordinaten umzuwandeln.

Rückgaben

public UiSettings getUiSettings ()

Ruft die Einstellungen der Benutzeroberfläche für die Karte ab.

Rückgaben

public boolean isBuildingsEnabled ()

Gibt an, ob die Ebene für 3D-Gebäude aktiviert ist.

Rückgaben
  • true, wenn Gebäude aktiviert sind, andernfalls false.

public boolean isIndoorEnabled ()

Ruft ab, ob Indoor-Karten derzeit aktiviert sind.

Rückgaben
  • true, wenn Indoor-Karten aktiviert sind; false, wenn Indoor-Karten deaktiviert sind;

public boolean isMyLocationEnabled ()

Ruft den Status der Ebene „Mein Standort“ ab.

Rückgaben
  • true, wenn die Ebene „Mein Standort“ aktiviert ist, andernfalls false.

public boolean isTrafficEnabled ()

Prüft, ob auf der Karte Verkehrsdaten erfasst werden. Dies hängt von der Verfügbarkeit von Verkehrsdaten ab.

Rückgaben
  • true, wenn Verkehrsdaten aktiviert sind; andernfalls false.

public void moveCamera (CameraUpdate-Update)

Positioniert die Kamera gemäß den in der Aktualisierung definierten Anweisungen neu. Die Verschiebung erfolgt unverzüglich und eine nachfolgende getCameraPosition() gibt die neue Position wieder. Eine Reihe von Aktualisierungen finden Sie unter CameraUpdateFactory.

Parameter
update Die Änderung, die auf die Kamera angewendet werden soll.

public void resetMinMaxZoomPreference ()

Entfernt alle zuvor angegebenen oberen und unteren Zoomgrenzen.

public void setBuildingsEnabled (boolean enabled)

Aktiviert oder deaktiviert die Ebene "3D-Gebäude".

Parameter
aktiviert true zum Aktivieren der Ebene für 3D-Gebäude und false zum Deaktivieren der Ebene für 3D-Gebäude.

public void setContentDescription (Stringbeschreibung)

Legt eine contentDescription für die Karte fest.

Hiermit wird eine gesprochene Beschreibung der Karte im Bedienungshilfenmodus bereitgestellt. Der Standardwert ist „Google Maps“.

Parameter
Beschreibung Ein String, der als Beschreibung verwendet werden soll.

public boolean setIndoorEnabled (boolean enabled)

Legt fest, ob Indoor-Karten aktiviert werden sollen. Derzeit können Indoor-Karten immer nur auf einer Karte angezeigt werden. Standardmäßig ist dies die erste Karte, die Ihrer Anwendung hinzugefügt wird. Wenn Sie Indoor-Karten auf einer anderen Karte aktivieren möchten, müssen Sie zuerst Indoor-Karten auf der ursprünglichen Karte deaktivieren. Wenn Sie versuchen, Indoor-Karten zu aktivieren, wenn sie auf einer anderen Karte aktiviert sind, passiert nichts und es wird false zurückgegeben. Wenn Indoor nicht für eine Karte aktiviert ist, geben alle Methoden für Indoor-Karten null oder false zurück.

Parameter
aktiviert true, um Indoor-Karten zu aktivieren, und false, um Indoor-Karten zu deaktivieren.
Rückgaben
  • ob Indoor-Karten aktiviert werden könnten.

public void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter-Adapter)

Legt einen benutzerdefinierten Renderer für den Inhalt von Infofenstern fest.

Wie die Event-Listener der Karte wird dieser Status nicht mit der Karte serialisiert. Wenn die Karte neu erstellt wird (z.B. aufgrund einer Konfigurationsänderung), müssen Sie diese Methode noch einmal aufrufen, um die Anpassung beizubehalten.

Parameter
Netzteil Der Adapter, der für Infofensterinhalte verwendet werden soll, oder null, um das Standard-Inhaltsrendering in Infofenstern zu verwenden.

public void setLatLngBoundsForCameraTarget (LatLngBounds bounds)

Gibt einen „LatLngBounds“-Wert zur Beschränkung des Kameraziels an, damit sich das Kameraziel nicht außerhalb dieser Grenzen bewegt, wenn Nutzer auf der Karte scrollen und schwenken.

Legen Sie diesen Wert auf null fest, um den Begrenzungsrahmen vollständig zu löschen. Die neuen Grenzen ersetzen alle zuvor angegebenen Begrenzungsrahmen.

Wenn sich LatLngBounds ändert, werden alle späteren Kameraupdates vom SDK so angepasst, dass diese Grenzen nach Möglichkeit eingehalten werden. Es gibt technische Überlegungen, die das SDK daran hindern, das Kameraziel strikt innerhalb der Grenzen zu halten. etwa Rundungsfehler mit Gleitkomma oder eine sehr niedrige Zoomstufe.

Parameter
Grenzen Die Grenzen, innerhalb derer das Kameraziel beschränkt wird.

public void setLocationSource (LocationSource Quelle)

Ersetzt die Standortquelle der Ebene „Mein Standort“.

Parameter
source Eine Standortquelle zur Verwendung in der Ebene „Mein Standort“. Legen Sie null fest, um die standardmäßige Standortquelle zu verwenden.

public boolean setMapStyle (MapStyleOptions-Stil)

Legt den Stil der Basiskarte fest.

Mithilfe der Stiloptionen können Sie benutzerdefinierte Stile auf Elemente und Elemente auf der Karte anwenden. Weitere Informationen zur Stildefinition finden Sie unter MapStyleOptions.

Geben Sie „null“ an, um alle vorherigen benutzerdefinierten Stile zu löschen.

Parameter
Stil
Rückgaben
  • true, wenn der Stil erfolgreich geparst wurde; false, wenn Probleme mit dem MapStyleOptions erkannt wurden, z.B. JSON-Dateien mit nicht analysierbaren Stilen, nicht erkannter Elementtyp, nicht erkannter Elementtyp oder ungültige Styler-Schlüssel. Wenn der Rückgabewert false ist, bleibt der aktuelle Stil unverändert.

public void setMapType (int type)

Legt den Typ der Kartenkacheln fest, die angezeigt werden sollen. Folgende Werte sind zulässig:

Parameter
eingeben Der Kartentyp, der angezeigt werden soll.

public void setMaxZoomPreference (float maxZoompreferences)

Legt eine bevorzugte Obergrenze für den Kamerazoom fest.

Wenn sich der maximale Zoom ändert, werden alle späteren Kameraupdates vom SDK so angepasst, dass der Maximalwert nach Möglichkeit eingehalten wird. Es gibt technische Überlegungen, die verhindern, dass Nutzer mit dem SDK zu tief in die Karte zoomen können. So kann beispielsweise eine Satelliten- oder Geländekarte eine geringere maximale Zoomstufe haben als die Kacheln der Basiskarte.

Das SDK behebt Konflikte bei den Mindest- und Höchstwerten. Wenn Sie für den minimalen Zoom eine höhere Zoomstufe als den aktuellen Maximalwert festlegen, verwendet das SDK den neuen Mindestwert sowohl für den Mindest- als auch für den Höchstwert. Wenn Sie für den maximalen Zoom eine niedrigere Zoomstufe als den Mindestwert festlegen, verwendet das SDK den neuen Maximalwert sowohl für Mindest- als auch für Höchstwert. Beispiel: Angenommen, die aktuelle minimale Zoomstufe beträgt 8 und die maximale Zoomstufe 14. Anschließend legen Sie den maximalen Zoom auf 6 fest. Das SDK verwendet einen minimalen Zoom von 6 und einen maximalen Zoom von 6.

Parameter
maxZoomPreference Die bevorzugte Obergrenze.

public void setMinZoomPreference (float minZoompreferences)

Legt eine bevorzugte Untergrenze für den Kamerazoom fest.

Wenn sich der minimale Zoom ändert, passt das SDK alle späteren Kameraupdates an, um diesen Mindestwert nach Möglichkeit einzuhalten. Es gibt technische Überlegungen, die verhindern, dass das SDK Nutzern ein zu niedriges Zoomen erlaubt.

Das SDK behebt Konflikte bei den Mindest- und Höchstwerten. Wenn Sie für den minimalen Zoom eine höhere Zoomstufe als den aktuellen Maximalwert festlegen, verwendet das SDK den neuen Mindestwert sowohl für den Mindest- als auch für den Höchstwert. Wenn Sie für den maximalen Zoom eine niedrigere Zoomstufe als den Mindestwert festlegen, verwendet das SDK den neuen Maximalwert sowohl für Mindest- als auch für Höchstwert. Beispiel: Angenommen, die aktuelle minimale Zoomstufe beträgt 8 und die maximale Zoomstufe 14. Anschließend legen Sie die minimale Zoomstufe auf 16 fest. Das SDK verwendet einen minimalen Zoom von 16 und einen maximalen Zoom von 16.

Parameter
minZoomPreference Die bevorzugte Untergrenze.

public void setMyLocationEnabled (boolean enabled)

Aktiviert oder deaktiviert die Ebene „Mein Standort“.

Wenn diese Ebene aktiviert und der Standort verfügbar ist, zeigt die Ebene „Mein Standort“ kontinuierlich den aktuellen Standort und die Lage eines Nutzers an. Außerdem werden UI-Steuerelemente angezeigt, über die der Nutzer mit seinem Standort interagieren kann (z. B. um die Kameraverfolgung seines Standorts und seiner Lage zu aktivieren oder zu deaktivieren).

Um das Layer-Feature für meinen Standort verwenden zu können, musst du die Berechtigung für ACCESS_COARSE_LOCATION oder ACCESS_FINE_LOCATION anfordern, es sei denn, du hast eine benutzerdefinierte Standortquelle festgelegt.

Wenn Sie über setLocationSource(LocationSource) eine benutzerdefinierte Standortquelle festgelegt haben, prüft das Google Maps SDK for Android nicht, ob die oben genannten Berechtigungen erteilt wurden. Trotzdem müssen Sie dafür sorgen, dass der Nutzer alle Berechtigungen erteilt hat, die für Ihre benutzerdefinierte Standortquelle erforderlich sind.

Parameter
aktiviert true zum Aktivieren; false zum Deaktivieren.
Löst aus
SecurityException wenn keine Berechtigung zur Standortermittlung erteilt wurde.

public void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener-Listener)

Diese Methode wurde eingestellt.
Ersetzt durch setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener) und setOnCameraIdleListener(GoogleMap.OnCameraIdleListener).

Legt einen Callback fest, der ausgelöst wird, wenn sich die Kamera ändert.

Parameter
Listener Der Callback, der ausgelöst wird, wenn sich die Kamera ändert. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener-Listener)

Legt einen Rückruf fest, der nach dem Ende der Kamerabewegung ausgelöst wird.

Parameter
Listener Der ausgelöste Callback. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener-Listener)

Legt einen Callback fest, der ausgelöst wird, wenn die Kamerabewegung gestoppt oder durch einen neuen Animationstyp unterbrochen wird.

Parameter
Listener Der ausgelöste Callback. Verwende null, um die Festlegung des Callbacks aufzuheben. Die Kamera darf nicht innerhalb von onCameraMoveCanceled() aktualisiert oder animiert werden.

public void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener-Listener)

Legt einen Callback fest, der wiederholt ausgelöst wird, während die Kamera in Bewegung ist. Der Callback kann bis zu einmal pro Frame aufgerufen werden und sollte keine teuren Vorgänge ausführen.

Parameter
Listener Der ausgelöste Callback. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener-Listener)

Legt einen Callback fest, der ausgelöst wird, wenn die Kamerabewegung beginnt oder sich der Grund für die Kamerabewegung geändert hat.

Parameter
Listener Der ausgelöste Callback. Verwende null, um die Festlegung des Callbacks aufzuheben. Die Kamera darf nicht innerhalb von onCameraMoveStarted() aktualisiert oder animiert werden.

public void setOnCircleClickListener (GoogleMap.OnCircleClickListener-Listener)

Legt einen Callback fest, der ausgelöst wird, wenn auf einen Kreis geklickt wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn auf einen Kreis geklickt wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener-Listener)

Legt einen Callback fest, der beim Klicken auf ein Boden-Overlay ausgelöst wird.

Parameter
Listener Der Callback, der beim Klicken auf ein Boden-Overlay ausgelöst wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener-Listener)

Legt den Listener für Indoor-Ereignisse fest oder löscht ihn. Es kann immer nur ein Listener festgelegt werden. Wenn Sie einen neuen Listener festlegen, wird der vorherige Listener entfernt.

Parameter
Listener Listener für Indoor-Ereignisse, falls nicht null; andernfalls wird der Listener gelöscht

public void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener-Listener)

Legt einen Callback fest, der beim Klicken auf ein Infofenster einer Markierung aufgerufen wird.

Parameter
Listener Der Callback, der beim Klicken auf ein Infofenster einer Markierung aufgerufen wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener-Listener)

Legt einen Callback fest, der beim Schließen des Infofensters einer Markierung aufgerufen wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn das Infofenster einer Markierung geschlossen wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener-Listener)

Legt einen Callback fest, der aufgerufen wird, wenn das Infofenster einer Markierung lange gedrückt wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn lange auf das Infofenster einer Markierung gedrückt wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnMapClickListener (GoogleMap.OnMapClickListener-Listener)

Legt einen Callback fest, der ausgelöst wird, wenn auf die Karte getippt wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn auf die Karte getippt wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback Callback)

Legt einen Callback fest, der ausgelöst wird, wenn das Rendern dieser Karte abgeschlossen ist. Der Callback wird nur einmal aufgerufen.

Wenn diese Methode aufgerufen wird, nachdem die Karte vollständig gerendert wurde, wird der Callback sofort aufgerufen. Dieses Ereignis wird nicht ausgelöst, wenn die Karte aufgrund von Verbindungsproblemen nicht geladen wird oder wenn sich die Karte ständig ändert und nie vollständig geladen wird, da der Nutzer ständig mit der Karte interagiert.

Parameter
callback Entspricht dem Callback, der aufgerufen wird, wenn das Rendern der Karte abgeschlossen ist. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener-Listener)

Legt einen Callback fest, der aufgerufen wird, wenn die Karte lange gedrückt wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn die Karte lange gedrückt wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener-Listener)

Legt einen Callback fest, der beim Klicken auf eine Markierung aufgerufen wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn auf eine Markierung geklickt wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener-Listener)

Legt einen Callback fest, der beim Ziehen einer Markierung aufgerufen wird.

Parameter
Listener Der Callback, der bei Ziehereignissen für Markierungen ausgelöst wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener-Listener)

Legt einen Callback fest, der ausgelöst wird, wenn auf die Schaltfläche „Mein Standort“ geklickt wird.

Wenn listener true zurückgibt, wird das Ereignis verarbeitet und das Standardverhalten tritt nicht ein. Wird false zurückgegeben, tritt das Standardverhalten ein, d.h. die Kamera wird so bewegt, dass sie auf den Standort des Nutzers zentriert ist.

Parameter
Listener Der Callback, der ausgelöst wird, wenn auf die Schaltfläche „Mein Standort“ geklickt wird.

public void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener-Listener)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen com.google.android.gms.location.FusedLocationProviderApi. FusedLocationProviderApi ermöglicht eine verbesserte Standortsuche und eine verbesserte Stromnutzung und wird vom blauen Punkt „Mein Standort“ verwendet. Beispielcode finden Sie unter „MyLocationDemoActivity“ im Ordner mit den Beispielanwendungen oder im Entwicklerleitfaden für Standorte.

Legt einen Rückruf fest, der ausgelöst wird, wenn der Punkt "Mein Standort" den Standort ändert.

Parameter
Listener Der Callback, der ausgelöst wird, wenn sich der Punkt „Mein Standort“ ändert.

public void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener-Listener)

Legt einen Callback fest, der ausgelöst wird, wenn auf den Punkt „Mein Standort“ (der den Standort des Nutzers angibt) geklickt wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn auf den Punkt „Mein Standort“ geklickt wird.

public void setOnPoiClickListener (GoogleMap.OnPoiClickListener-Listener)

Legt einen Listener fest, der ausgelöst wird, wenn auf einen POI geklickt oder getippt wird.

Übergeben Sie null, um den Listener zu löschen.

Parameter
Listener

public void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener-Listener)

Legt einen Callback fest, der beim Klicken auf ein Polygon ausgelöst wird.

Parameter
Listener Der Callback, der beim Klicken auf ein Polygon ausgelöst wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

public void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener-Listener)

Legt einen Callback fest, der beim Klicken auf eine Polylinie ausgelöst wird.

Parameter
Listener Der Callback, der ausgelöst wird, wenn auf eine Polylinie geklickt wird. Verwende null, um die Festlegung des Callbacks aufzuheben.

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

Legt den Innenrand auf der Karte fest.

Mit dieser Methode können Sie einen sichtbaren Bereich auf der Karte definieren, um der Karte zu signalisieren, dass Teile der Karte um die Kartenränder verdeckt werden können, indem Sie einen Innenrand an jedem der vier Kartenränder festlegen. Kartenfunktionen werden an den Innenrand angepasst. Beispielsweise werden die Zoomsteuerelemente, der Kompass, die Urheberrechtshinweise und das Google-Logo so bewegt, dass sie in den definierten Bereich passen, Kamerabewegungen erfolgen relativ zum Mittelpunkt des sichtbaren Bereichs usw.

Parameter
links die Anzahl der Pixel mit dem Abstand, der links auf der Karte hinzugefügt werden soll.
oben die Anzahl der Pixel mit dem Abstand, der oben auf der Karte hinzugefügt werden soll.
rechts die Anzahl der Pixel mit dem Abstand, der auf der rechten Seite der Karte hinzugefügt werden soll.
unten die Anzahl der Pixel mit dem Abstand, der unten auf der Karte hinzugefügt werden soll.

public void setTrafficEnabled (boolean enabled)

Aktiviert oder deaktiviert die Verkehrslagenebene.

Parameter
aktiviert

public void Snapshot (GoogleMap.SnapshotReadyCallback-Callback)

Erstellt einen Snapshot der Karte.

Wenn die Verwendung einer interaktiven Karte schwierig oder unmöglich wäre, können Sie Snapshots in Ihrer Anwendung verwenden. Mit der Methode snapshot() erstellte Bilder können beispielsweise dazu verwendet werden, eine Miniaturansicht der Karte in Ihrer App oder einen Snapshot im Benachrichtigungscenter anzuzeigen.

Hinweis:Bilder der Karte dürfen nicht an Ihre Server übertragen oder außerhalb der App verwendet werden. Wenn Sie eine Karte an eine andere Anwendung oder einen anderen Nutzer senden müssen, senden Sie anstelle eines Snapshots Daten, mit denen diese die Karte für den neuen Nutzer rekonstruieren können.

Parameter
callback Callback-Methode, die beim Erstellen des Snapshots aufgerufen wird.

public void Snapshot (GoogleMap.SnapshotReadyCallback-Callback, Bitmap-Bitmap)

Erstellt einen Snapshot der Karte.

Diese Methode entspricht snapshot(SnapshotReadyCallback), ermöglicht es Ihnen jedoch, eine vorab zugewiesene Bitmap anzugeben. Wenn die Bitmap nicht mit den aktuellen Abmessungen der Karte übereinstimmt, wird eine andere Bitmap zugewiesen, die zu den Abmessungen der Karte passt.

In den meisten Fällen ist das von der Callback-Methode übergebene Objekt mit dem Objekt identisch, das im Parameter dieser Methode angegeben ist. In einigen Fällen kann das zurückgegebene Objekt jedoch anders sein, z. B. wenn sich die Abmessungen der Ansicht zum Zeitpunkt der eigentlichen Snapshot-Erstellung geändert haben. Daher solltest du nur dem Inhalt der Bitmap vertrauen, der von der Callback-Methode übergeben wird.

Parameter
callback Callback-Methode, die beim Erstellen des Snapshots aufgerufen wird.
Bitmap Eine vorab zugewiesene Bitmap. Wenn null, verhält sich wie snapshot(SnapshotReadyCallback).

public void stopAnimation ()

Stoppt die Kameraanimation, sofern eine laufende Animation läuft. Wenn die Methode aufgerufen wird, stoppt die Kamerabewegung sofort und bleibt in dieser Position.