Wersja uproszczona

Pakiet SDK Map na Androida może wyświetlać obraz mapy w formacie bitmapy, oferując użytkownikowi ograniczoną interaktywność. Jest to tzw. mapa w trybie uproszczonym.

Przykładowe fragmenty kodu

Repozytorium ApiDemos na GitHubie zawiera przykłady, które pokazują, jak korzystać z trybu lite:

• LiteDemoActivity – Java: podstawy korzystania z mapy w wersji uproszczonej w języku Java
• LiteDemoActivity – Kotlin: podstawy używania mapy w wersji uproszczonej w Kotlinie
• LiteListDemoActivity – Java: wydajne wyświetlanie map w ListViews za pomocą wersji uproszczonej w Java
• LiteListDemoActivity – Kotlin: wyświetlanie map w ListViews za pomocą trybu lite w Kotlinie

Omówienie wersji uproszczonej

Mapa w trybie uproszczonym to obraz mapy w formacie bitmapy w określonej lokalizacji i poziomie powiększenia. Tryb Lite obsługuje wszystkie typy map (normalna, hybrydowa, satelitarna, terenu) oraz podzbiór funkcji udostępnianych przez pełny interfejs API. Tryb Lite jest przydatny, gdy chcesz wyświetlić na strumieniach wiele map lub mapę, która jest zbyt mała, aby umożliwić znaczącą interakcję.

Użytkownicy, którzy wyświetlają mapę, nie mogą jej powiększać ani przesuwać. Ikony na mapie umożliwiają użytkownikom wyświetlanie mapy w aplikacji mobilnej Mapy Google i wyznaczanie tras.

Dodawanie mapy w trybie uproszczonym

Tryb uproszczony korzysta z tych samych klas i interfejsów co pełna wersja interfejsu API Map Google na Androida. Tryb GoogleMap możesz ustawić w ten sposób:

<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"/>

val options = GoogleMapOptions()
    .liteMode(true)

      

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

      

Szczegółowe informacje o ustawianiu początkowego stanu mapy znajdziesz w przewodniku dotyczącym obiektu mapy.

intencje uruchamiające widok mapy lub prośbę o wyznaczanie trasy;

Domyślnie pasek narzędzi w prawym dolnym rogu mapy zawiera ikony, które umożliwiają wyświetlanie mapy lub prośbę o wskazanie trasy w aplikacji mobilnej Mapy Google. Możesz wyłączyć pasek narzędzi, wywołując UiSettings.setMapToolbarEnabled(false). Więcej informacji znajdziesz w dokumentacji paska narzędzi.

Gdy użytkownik kliknie mapę, interfejs API uruchamia domyślnie mobilną aplikację Mapy Google. Możesz to zmienić, używając funkcji GoogleMap.setOnMapClickListener() do ustawienia własnego listenera. Zdarzenia kliknięcia na mapie możesz też wyłączyć, wywołując funkcję setClickable() w widoku zawierającym element MapView lub MapFragment. Szczegółowe informacje o tych 2 metodach znajdziesz w dokumentacji zdarzeń.

Zdarzenia cyklu życia

Podczas korzystania z interfejsu API w pełnym trybie interaktywnym użytkownicy klasy MapView muszą przekazywać wszystkie metody cyklu życia aktywności do odpowiednich metod w klasie MapView. Przykłady metod cyklu życia to onCreate(), onDestroy(), onResume() i onPause().

Gdy używasz klasy MapView w trybie uproszczonym, przekierowywanie zdarzeń cyklu życia jest opcjonalne, z wyjątkiem tych sytuacji:

• Wymagane jest wywołanie funkcji onCreate(), w przeciwnym razie mapa się nie wyświetli.
• Jeśli chcesz wyświetlić kropkę Moja lokalizacja na mapie w trybie uproszczonym i używać domyślnego źródła lokalizacji, musisz wywołać funkcje onResume() i onPause(), ponieważ źródło lokalizacji będzie aktualizowane tylko między tymi wywołaniami. Jeśli używasz własnego źródła danych o lokalizacji, nie musisz wywoływać tych dwóch metod.

Obsługiwane funkcje interfejsu API

W tabeli poniżej opisano działanie mapy w trybie uproszczonym w poszczególnych obszarach funkcji interfejsu API. Jeśli aplikacja wywoła metodę, która nie jest obsługiwana w trybie Lite, interfejs API zarejestruje komunikat ostrzegawczy.