Korzystanie z pakietu Maps SDK na Androida w wersji 3.1.0 BETA

Wersja 3.1.0 pakietu SDK Map na Androida w wersji beta to nowa implementacja z tą samą interfejsem API co poprzednia wersja (wszystkie klasy i metody pozostają takie same) oraz kilkoma nowymi funkcjami do wypróbowania:

  • Dostosowywanie map
  • Obsługa kolizji znaczników
  • Dostosowywanie linii łamanej

Z tego przewodnika dowiesz się, jak korzystać z nowych funkcji.

Dostosowywanie map (beta)

Definiowanie stylów map w Google Cloud udostępnia wiele narzędzi i funkcji, które ułatwiają dostosowywanie map i zarządzanie ich stylami. Zamiast stylizować mapę w kodzie za pomocą interfejsów API i pakietów SDK Map Google, możesz zarządzać mapami i stylizować je w konsoli Google Cloud. Więcej informacji znajdziesz w artykule Omówienie dostosowywania mapy na Androida.

Obsługa kolizji znaczników (beta)

Możesz określić, czy znaczniki niestandardowe mają zastępować domyślne etykiety mapy bazowej w przypadku kolizji, a także wskazać względną ważność poszczególnych znaczników niestandardowych. Więcej informacji znajdziesz w artykule Zarządzanie kolizją znacznika (Android).

Dostosowywanie linii złożonych (wersja beta)

Wygląd wielolinii możesz teraz dostosowywać na kilka nowych sposobów:

  • Wielokolorowe linie łamane mają segmenty w różnych kolorach.
  • Gradienty na poliliniach wypełniają polilinie za pomocą gradientu 2 kolorów.
  • Znakowane linie poligonalne – stylizowanie linii poligonalnej za pomocą powtarzających się bitmap.

Tworzenie wielokolorowej linii złożonej

Za pomocą zakresów możesz osobno wypełniać kolorem poszczególne segmenty polilinii. W tym celu tworzysz obiekty StyleSpan i dodasz je do PolylineOptions za pomocą metod addSpan() lub addSpans(). Domyślnie każdy element w tablicy będzie określał kolor odpowiadającego mu odcinka linii.

Tworzenie linii łamanej gradientu

Możesz zdefiniować gradient, podając 2 32-bitowe liczby całkowite typu alpha-red-green-blue (ARGB), aby określić kolory początkowy i końcowy kreski. Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję PolylineOptions.addSpan().

Tworzenie linii łamanej z oznaczeniem

Wygląd ścieżki złożonej możesz ustawić jako powtarzającą się teksturę bitmapy. Aby to zrobić, utwórz obiekt StampStyle z elementu TextureStyle, a potem ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję PolylineOptions.addSpan().

Importowanie biblioteki narzędzi zgodnej z wersją beta

Jeśli używasz biblioteki narzędzi Map Google na Androida API, musisz też zaktualizować zależności projektu, aby zastąpić obecną wersję wersją zgodną z wersją beta. Aby to zrobić:

  1. Zaimportuj bibliotekę util zgodną z wersją beta do pliku build.gradle: 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. Aby usunąć bibliotekę narzędzi nieobsługiwanych w wersji beta, z poziomu build.gradle usuń te elementy: 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

Uruchamianie przykładów

Repozytorium przykładowych aplikacji Google na GitHub zawiera przykładowe aplikacje, które demonstrują korzystanie z pakietu SDK Maps w wersji beta 3.1.0 na Androida.