Korzystanie z wersji beta pakietu SDK Map na Androida 3.1.0

Wersja 3.1.0 beta pakietu Maps SDK na Androida to nowa implementacja z tym samym 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 różne narzędzia i funkcje, które umożliwiają dostosowywanie stylów map i zarządzanie nimi. Zamiast definiować styl mapy w kodzie za pomocą interfejsów API Map Google i pakietów SDK, możesz zarządzać mapami i definiować ich styl w konsoli Google Cloud. Więcej informacji znajdziesz w artykule Omówienie dostosowywania map na Androidzie.

Obsługa kolizji znaczników (beta)

Możesz określić, czy w przypadku kolizji znaczniki niestandardowe mają zastępować domyślne etykiety mapy podstawowej, oraz wskazać względny priorytet znaczników niestandardowych. Więcej informacji znajdziesz w artykule Obsługa kolizji znaczników (Android).

Dostosowywanie linii łamanej (beta)

Teraz możesz dostosowywać wygląd linii łamanych na kilka nowych sposobów:

  • Wielokolorowe linie łamane ustawiają różne kolory segmentów linii łamanej.
  • Łamane gradientowe kolorują linię łamaną za pomocą gradientu składającego się z 2 kolorów.
  • Linie łamane ze wzorem to linie łamane z powtarzającymi się bitmapami.

Tworzenie wielokolorowej linii łamanej

Możesz użyć rozpiętości, aby indywidualnie pokolorować segmenty linii łamanej, tworząc obiekty StyleSpan i dodając je do PolylineOptions za pomocą metod addSpan() lub addSpans(). Domyślnie każdy element w tablicy ustawia kolor odpowiedniego segmentu linii.

Tworzenie linii łamanej z gradientem

Gradient możesz zdefiniować, podając 2 32-bitowe liczby całkowite ARGB (alfa-czerwony-zielony-niebieski), które określają początkowy i końcowy kolor obrysu. Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję PolylineOptions.addSpan().

Tworzenie linii łamanej ze wzorem

Możesz ustawić wygląd linii łamanej jako powtarzającą się teksturę bitmapową. Aby to zrobić, utwórz StampStyle typu TextureStyle, a następnie ustaw tę właściwość w obiekcie opcji kształtu, wywołując PolylineOptions.addSpan().

Importowanie biblioteki narzędziowej zgodnej z wersją beta

Jeśli używasz biblioteki narzędzi interfejsu Google Maps Android API, musisz też zaktualizować zależności projektu, aby zastąpić dotychczasową wersję wersją zgodną z betą. Aby to zrobić, wykonaj te czynności:

  1. Zaimportuj bibliotekę util zgodną z wersją beta w pliku build.gradle:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. Aby usunąć bibliotekę narzędzi, która nie jest zgodna z wersją beta, usuń z pliku build.gradle te elementy:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'