Pakiet Maps SDK na Androida może wyświetlać bitmapę mapy, oferując z ograniczoną interakcyjnością. Jest to tzw. mapa w trybie uproszczonym.
Przykładowe fragmenty kodu
Repozytorium API Apigee na GitHubie zawiera: przykładowe zastosowania wersji uproszczonej:
- LiteDemoActivity (Java): podstawy korzystania z mapy w trybie uproszczonym w Javie
- LiteDemoActivity – Kotlin: podstawy korzystania z mapy w trybie uproszczonym w Kotlin
- LiteListDemoActivity – Java: efektywne wyświetlanie map w Obiekty ListView w wersji uproszczonej w Javie
- LiteListDemoActivity – Kotlin: efektywne wyświetlanie map w Obiekty ListView w wersji uproszczonej w Kotlin
Omówienie wersji uproszczonej
Mapa w wersji uproszczonej to obraz bitowy mapy z określoną lokalizacją. Możesz go powiększyć. na poziomie 300%. Wersja uproszczona obsługuje wszystkie typy map (normalne, hybrydowe, satelitarne, teren) oraz podzbiór funkcji zapewnianych przez pełny interfejs API. Wersja uproszczona jest przydatne, gdy w strumieniu chcesz udostępnić pewną liczbę map lub mapę, jest zbyt mała, aby można było prowadzić wartościową interakcję.
Użytkownicy przeglądający mapę nie mogą jej powiększać ani przesuwać. Ikony na mapie użytkownicy mogą wyświetlić mapę w aplikacji mobilnej Mapy Google i poprosić o dostęp wskazówek dojazdu.
Dodawanie mapy w wersji uproszczonej
Wersja uproszczona korzysta z tych samych klas i interfejsów co pełna wersja Map Google na Androida.
API. Aby ustawić na urządzeniu GoogleMap
tryb uproszczony:
sposoby:
- Jako atrybut XML dla
MapView
lubMapFragment
- Lub w obiekcie
GoogleMapOptions
Jako atrybut XML dla atrybutu MapView
lub 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"/>
W obiekcie GoogleMapOptions
Kotlin
val options = GoogleMapOptions() .liteMode(true)
Java
GoogleMapOptions options = new GoogleMapOptions() .liteMode(true);
Szczegółowe informacje o ustawianiu początkowego stanu mapy znajdziesz w przewodniku po obiekt mapy.
zamiary uruchomienia widoku mapy lub żądania wskazówek dojazdu,
Domyślnie pasek w prawym dolnym rogu mapy zawiera ikony, które
umożliwiają dostęp do widoku mapy lub prośby o wskazówki dojazdu w Mapach Google na komórki.
. Pasek narzędzi możesz wyłączyć, wywołując
UiSettings.setMapToolbarEnabled(false)
Więcej
Więcej informacji znajdziesz w dokumentacji paska narzędzi.
Domyślnie, gdy użytkownik kliknie mapę, interfejs API uruchamia aplikację mobilną Mapy Google.
. Możesz to zastąpić, używając parametru GoogleMap.setOnMapClickListener()
do
ustawić własnego słuchacza. Możesz też wyłączyć zdarzenia kliknięć na mapie, dzwoniąc
setClickable()
w widoku zawierającym MapView
lub MapFragment
. Dla:
aby dowiedzieć się więcej o tych 2 metodach, zapoznaj się z dokumentacją zdarzeń.
Zdarzenia cyklu życia
Jeśli interfejs API jest używany w trybie w pełni interaktywnym, użytkownicy klasy MapView
musi przekazać wszystkie metody cyklu życia aktywności na odpowiednie metody
w zajęciach MapView
. Przykłady metod związanych z cyklem życia:
onCreate()
, onDestroy()
, onResume()
i onPause()
.
Jeśli używasz klasy MapView
w trybie uproszczonym, przekazywanie zdarzeń cyklu życia jest
opcjonalne z wyjątkiem tych sytuacji:
- Musisz zadzwonić pod numer
onCreate()
. W przeciwnym razie nie wyświetli się żadna mapa. - Jeśli chcesz wyświetlić kropkę Moja lokalizacja na mapie w trybie uproszczonym i użyć
domyślnym źródłem lokalizacji jest
onResume()
ionPause()
, bo źródło lokalizacji jest aktualizowane tylko między tymi wywołaniami. Jeśli używasz własnego źródła lokalizacji, nie musisz wywoływać tych dwóch metod.
Obsługiwane funkcje interfejsu API
W poniższej tabeli opisano działanie mapy w wersji uproszczonej dla każdego obszaru Funkcje interfejsu API. Jeśli aplikacja wywołuje metodę, która nie jest obsługiwana w wersji uproszczonej, interfejs API zapisze komunikat ostrzegawczy.
Funkcjonalność | |
---|---|
Typy map | Obsługiwane? Tak
Poniższa mapa
typy są dostępne w GoogleMapOptions.mapType() oraz
GoogleMap.setMapType() : MAP_TYPE_NORMAL
MAP_TYPE_SATELLITE , MAP_TYPE_TERRAIN ,
MAP_TYPE_HYBRID , MAP_TYPE_NONE |
Linie łamane, wielokąty, okręgi | Obsługiwane? Tak
Funkcja wersji uproszczonej aplikacji
kształty pasuje do
z pełnym dostępem do interfejsu API. |
Odwzorowanie | Obsługiwane? Tak
Funkcja wersji uproszczonej aplikacji
Odwzorowanie
pasuje do pełnego interfejsu API. |
Moja lokalizacja | Obsługiwane? Tak
Funkcja obsługi wersji uproszczonej
Warstwa Moja lokalizacja
pasuje do pełnego interfejsu API. |
Dopełnienie mapy | Obsługiwane? Tak
Obsługa wersji uproszczonej
dopełnienie mapy
pasuje do pełnego interfejsu API. |
Okna informacyjne | Obsługiwane? Tak
Jeśli ustawisz title() znacznika, domyślną wartością będzie
okno informacyjne
pojawia się, gdy użytkownik kliknie znacznik. Możesz wyświetlić okno informacyjne
automatycznie, wywołując funkcję showInfoWindow() na znaczniku.
Możesz również utworzyć niestandardowe okna informacyjne za pomocą
Interfejs InfoWindowAdapter . |
Niestandardowe style mapy podstawowej | Obsługiwane? Częściowo
Pakiet Maps SDK na Androida obsługuje
custom style [niestandardowy styl]
do mapy podstawowej. Wersja uproszczona obsługuje tylko niestandardowe style oparte na formacie JSON – nie
styl oparty na chmurze, który do renderowania mapy z określonym stylem wymaga identyfikatora mapy.
W wersji uproszczonej nie można też
schemat kolorów mapy
aby używać trybu ciemnego.
|
Znaczniki | Obsługiwane? Częściowo
Możesz dodać znacznik
i reagują na zdarzenie kliknięcia. Możesz też dodać niestandardowe
ikon znaczników. Znacznika nie można przeciągać. Znaczniki na
mapy w trybie uproszczonym są płaskie i nie można ich obracać. |
Pozycja, powiększenie i animacja kamery | Obsługiwane? Częściowo
Możesz ustawić cel i powiększenie, ale nie pochylenie i położenie.
W wersji uproszczonej poziom powiększenia jest zaokrąglany do najbliższej liczby całkowitej.
Gdy zadzwonisz do: Połączenie z użytkownikiem |
Mapowanie zdarzeń | Obsługiwane? Częściowo
Obsługa wersji uproszczonej
Aby w wersji uproszczonej wyłączyć zdarzenia kliknięć na mapie,
Więcej informacji: zdarzeń dokumentacji. |
Mapy obiektów i budynki | Obsługiwane? Nie
W wersji uproszczonej wyświetlają się te same kafelki
Maps Static API
Oznacza to, że jeśli plan piętra jest wypalony na domyślnym kafelku,
która się pojawi. W przeciwnym razie nie zadziała. Nie możesz zmienić poziomu
lub użyć selektora poziomu. |
Warstwa natężenia ruchu | Obsługiwane? Nie
GoogleMap.setTrafficEnabled() nie jest obsługiwany
w wersji uproszczonej. |
Nakładki na powierzchni | Obsługiwane? Nie
Pole GoogleMap.addGroundOverlay() nie jest obsługiwane w wersji Lite
i trybu uzyskiwania zgody. |
Nakładki z kafelkami | Obsługiwane? Nie
Pole GoogleMap.addTileOverlay() nie jest obsługiwane w wersji Lite
i trybu uzyskiwania zgody. |
Gesty | Obsługiwane? Nie
Wersja uproszczona nie obsługuje gestów. Włączanie i wyłączanie gestów
nie przyniesie żadnego efektu. |
Street View | Obsługiwane? Nie
Street View to
Funkcja nie jest obsługiwana w wersji uproszczonej. |