Lite-Modus

Mit dem Maps SDK for Android kann ein Bitmapbild einer Karte dargestellt werden, das dem Nutzer eine eingeschränkte Interaktivität bietet. Das bezeichnet man als Lite-Modus-Karte.

Codebeispiele

Das ApiDemos-Repository auf GitHub enthält Beispiele, in denen die Verwendung des Lite-Modus veranschaulicht wird:

• LiteDemoActivity – Java: Grundlagen der Verwendung von Lite-Modus-Karten in Java
• LiteDemoActivity – Kotlin: Grundlagen der Verwendung von Lite-Modus-Karten in Kotlin
• LiteListDemoActivity – Java: Karten effizient in ListViews mithilfe des Lite-Modus in Java aufrufen
• LiteListDemoActivity – Kotlin: Karten effizient in ListViews mithilfe des Lite-Modus in Kotlin aufrufen

Lite-Modus – Übersicht

Eine Karte im Lite-Modus ist ein Bitmapbild einer Karte an einer bestimmten Position und mit einem gewissen Zoomfaktor. Im Lite-Modus werden alle Kartentypen (normal, Hybrid, Satellit, Gelände) sowie ein Teil der Funktionen der vollständigen API unterstützt. Der Lite-Modus ist hilfreich, wenn Sie mehrere Karten in einem Stream oder eine einzelne Karte, die für die Unterstützung einer sinnvollen Interaktion zu klein ist, zur Verfügung stellen möchten.

Die Nutzer können die angezeigte Karte nicht vergrößern oder schwenken. Über Symbole auf der Karte können sie aber auf die Ansicht der Karte in der mobilen App von Google Maps zugreifen und Wegbeschreibungen anfordern.

Karte im Lite-Modus hinzufügen

Im Lite-Modus werden dieselben Klassen und Schnittstellen verwendet wie in der Google Maps Android API mit vollem Funktionsumfang. Sie haben folgende Möglichkeiten, um für ein GoogleMap-Element den Lite-Modus festzulegen:

• Entweder als XML-Attribut für MapView oder MapFragment
• Oder im GoogleMapOptions-Objekt

Als XML-Attribut für MapView oder MapFragment

<fragment xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:map="http://schemas.android.com/apk/res-auto"
    android:name="com.google.android.gms.maps.MapFragment"
    android:id="@+id/map"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map:cameraZoom="13"
    map:mapType="normal"
    map:liteMode="true"/>

Im GoogleMapOptions-Objekt

GoogleMapOptions options = new GoogleMapOptions()
    .liteMode(true);

      

val options = GoogleMapOptions()
    .liteMode(true)

      

Informationen dazu, wie Sie den Anfangszustand der Karte festlegen, finden Sie in der Anleitung zum Kartenobjekt.

Intents zum Starten einer Kartenansichts- oder Wegbeschreibungsanforderung

Standardmäßig enthält eine Symbolleiste unten rechts auf der Karte Symbole, über die auf eine Kartenansichts- oder Wegbeschreibungsanforderung der mobilen App von Google Maps zugegriffen werden kann. Diese Symbolleiste lässt sich durch Aufrufen von UiSettings.setMapToolbarEnabled(false) deaktivieren. Weitere Informationen finden Sie in der Dokumentation zu Symbolleisten.

Ebenfalls standardmäßig wird beim Antippen der Karte die Google Maps App durch die API aufgerufen. Sie können diese Standardeinstellung überschreiben, indem Sie mit GoogleMap.setOnMapClickListener() Ihren eigenen Listener festlegen. Außerdem können Sie Klickereignisse auf der Karte deaktivieren. Rufen Sie dazu setClickable() in der Ansicht auf, die MapView oder MapFragment enthält. Ausführliche Informationen zu diesen beiden Verfahren finden Sie in der Ereignisdokumentation.

Lebenszyklusereignisse

Wird die API im vollständig interaktiven Modus verwendet, müssen von der Klasse MapView alle Methoden des Aktivitätslebenszyklus an die entsprechenden Methoden in der Klasse MapView weitergeleitet werden. Beispiele für Lebenszyklusmethoden: onCreate(), onDestroy(), onResume() und onPause().

Beim Verwenden der Klasse MapView im Lite-Modus ist das Weiterleiten von Lebenszyklusereignissen optional, mit Ausnahme der folgenden Situationen:

• onCreate() muss aufgerufen werden, da andernfalls keine Karte erscheint.
• Wenn der Punkt für den eigenen Standort auf der Lite-Modus-Karte angezeigt und die Standardquelle für den Standort verwendet werden soll, müssen Sie onResume() und onPause() aufrufen, weil die Standortquelle nur zwischen diesen Aufrufen aktualisiert wird. Wenn Sie Ihre eigene Standortquelle verwenden, ist das Aufrufen dieser beiden Methoden nicht erforderlich.

Unterstützte API-Funktionen

In der folgenden Tabelle wird die Funktionsweise einer Lite-Modus-Karte für jeden Bereich der API-Funktionen beschrieben. Wenn in einer App eine Methode aufgerufen wird, die im Lite-Modus nicht unterstützt wird, wird in der API eine Warnmeldung protokolliert.