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 du mehrere Karten in einem Stream oder eine einzelnen Karte, die für die Unterstützung einer sinnvollen Interaktion zu klein sind, bereitstellen möchtest.

Die Nutzer können die angezeigte Karte nicht vergrößern oder schwenken. Sie haben aber die Möglichkeit, über Symbole auf der Karte auf die Ansicht der Karte in der mobilen App von Google Maps zuzugreifen und Wegbeschreibungen anzufordern.

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. Du hast 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 du den Anfangszustand der Karte festlegst, findest du 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 findest du in der Dokumentation zu Symbolleisten.

Ebenfalls standardmäßig wird beim Antippen der Karte die mobile App von Google Maps durch die API aufgerufen. Du kannst diese Standardeinstellung überschreiben, indem du mit GoogleMap.setOnMapClickListener() deinen eigenen Listener festlegst. Außerdem kannst du Klickereignisse auf der Karte deaktivieren, indem du setClickable() in der Ansicht aufrufst, die MapView oder MapFragment enthält. Ausführliche Informationen zu diesen beiden Verfahren findest du 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, musst du onResume() und onPause() aufrufen, weil die Standortquelle nur zwischen diesen Aufrufen aktualisiert wird. Wenn du deine eigene Standortquelle verwendest, 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.