Wersja uproszczona

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:

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 lub MapFragment
  • 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. aplikacji. 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. aplikacji. 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() i onPause(), 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: GoogleMap.moveCamera(), otrzymasz kolejną pomoc obrazu mapy trybu. Więcej informacji o ustawianiu i manipulowaniu kamera, patrz Zmienianie widoku.

Połączenie z użytkownikiem GoogleMap.animateCamera() nie spowoduje, że: animację ruchu kamery. Widok z kamery zmieni się od razu na nowe położenie.
Mapowanie zdarzeń
Obsługiwane? Częściowo

Obsługa wersji uproszczonej GoogleMap.setOnMapClickListener() i GoogleMap.setOnMapLongClickListener()

Aby w wersji uproszczonej wyłączyć zdarzenia kliknięć na mapie, setClickable() w widoku, który zawiera MapView lub MapFragment. Jest to przydatne, gdy: możesz na przykład wyświetlić mapę lub mapy w widoku listy, zdarzenie kliknięcia wywołujące działanie niezwiązane z mapą.

Więcej informacji: zdarzeń dokumentacji.
Mapy obiektów i budynki
Obsługiwane? Nie
W wersji uproszczonej wyświetlają się te same kafelki Statyczny interfejs API Map Google. 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.