Kształty

Interfejs API Map Google na Androida oferuje kilka prostych sposobów dodawania kształtów do map w celu dostosowania ich do własnych potrzeb.

• Polyline to seria połączonych odcinków linii, które mogą tworzyć dowolny kształt i których można używać do zaznaczania ścieżek i tras na mapie.
• Polygon to zamknięty kształt, którego można używać do zaznaczania obszarów na mapie.
• Circle to wierne geograficznie odwzorowanie okręgu na powierzchni Ziemi, narysowanego na mapie.

Możesz dostosować wygląd wszystkich tych kształtów przez zmianę szeregu właściwości.

Przykładowe fragmenty kodu

Samouczek dotyczący dodawania wielokątów i wielokątów otwartych do reprezentowania obszarów i tras zawiera cały kod prostej aplikacji na Androida.

Dodatkowo w repozytorium ApiDemos na GitHubie znajdziesz przykłady, które pokazują, jak używać kształtów i ich właściwości:

• CircleDemoActivity (Java lub Kotlin): Circle
• PolygonDemoActivity (Java / Kotlin): Polygon
• PolylineDemoActivity (Java / Kotlin): Polyline

Linie łamane

Klasa Polyline definiuje zestaw połączonych segmentów linii na mapie. Obiekt Polyline składa się ze zbioru lokalizacji LatLng i tworzy serię segmentów linii, które łączą te lokalizacje w uporządkowanej kolejności.

Ten film zawiera pomysły na to, jak pomóc użytkownikom dotrzeć do celu, wykorzystując linie łamane do rysowania ścieżki na mapie.

Aby utworzyć ścieżkę złożoną, najpierw utwórz obiekt PolylineOptions i dodaj do niego punkty. Punkty reprezentują punkt na powierzchni Ziemi i są wyrażane jako obiekt LatLng. Odcinki linii są rysowane między punktami w kolejności, w jakiej zostały dodane do obiektu PolylineOptions.

Aby dodać punkty do obiektu PolylineOptions, wywołaj funkcję PolylineOptions.add(). Zwróć uwagę, że ta metoda przyjmuje zmienną liczbę parametrów, dzięki czemu możesz dodawać wiele punktów naraz (możesz też wywołać funkcję PolylineOptions.addAll(Iterable<LatLng>), jeśli punkty znajdują się już na liście).

Następnie możesz dodać linię łamaną do mapy, wywołując funkcję GoogleMap.addPolyline(PolylineOptions). Ta metoda zwraca obiekt Polyline, za pomocą którego możesz później zmienić linię łamaną.

Ten fragment kodu pokazuje, jak dodać prostokąt do mapy:

// Instantiates a new Polyline object and adds points to define a rectangle
val polylineOptions = PolylineOptions()
    .add(LatLng(37.35, -122.0))
    .add(LatLng(37.45, -122.0)) // North of the previous point, but at the same longitude
    .add(LatLng(37.45, -122.2)) // Same latitude, and 30km to the west
    .add(LatLng(37.35, -122.2)) // Same longitude, and 16km to the south
    .add(LatLng(37.35, -122.0)) // Closes the polyline.

// Get back the mutable Polyline
val polyline = map.addPolyline(polylineOptions)

      

// Instantiates a new Polyline object and adds points to define a rectangle
PolylineOptions polylineOptions = new PolylineOptions()
    .add(new LatLng(37.35, -122.0))
    .add(new LatLng(37.45, -122.0))  // North of the previous point, but at the same longitude
    .add(new LatLng(37.45, -122.2))  // Same latitude, and 30km to the west
    .add(new LatLng(37.35, -122.2))  // Same longitude, and 16km to the south
    .add(new LatLng(37.35, -122.0)); // Closes the polyline.

// Get back the mutable Polyline
Polyline polyline = map.addPolyline(polylineOptions);

      

Na mapie prostokąt będzie wyglądał tak:

Aby zmienić kształt polilinii po jej dodaniu, możesz wywołać funkcję Polyline.setPoints() i podać nową listę punktów dla polilinii.

Wygląd ścieżki możesz dostosować zarówno przed dodaniem jej do mapy, jak i po jej dodaniu. Więcej informacji znajdziesz w sekcji dostosowywanie wyglądu.

Dostosowywanie linii łamanej

Wygląd wielokątów możesz dostosować na kilka sposobów:

• Wielokolorowe linie łamane mają segmenty w różnych kolorach.
• Linie łamane gradientu określają kolor linii łamanej za pomocą gradientu dwóch kolorów.
• Linie łamane ze pieczęciami określają styl linii łamanej za pomocą powtarzających się map bitowych.

Aby korzystać z dostosowań linii łamanych, musisz korzystać z pakietu SDK Maps na Androida w wersji 18.1.0 lub nowszej i najnowszego mechanizmu renderowania dostępnego w pakiecie Maps SDK na Androida.

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. Poniższy przykład pokazuje ustawianie kolorów segmentów w celu utworzenia linii łamanej z segmentami czerwonym i zielonym:

val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(StyleSpan(Color.RED))
        .addSpan(StyleSpan(Color.GREEN))
)

      

Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(Color.RED))
        .addSpan(new StyleSpan(Color.GREEN)));

      

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(). Ten przykład pokazuje tworzenie ścieżki wielokąta z gradientem od czerwonego do żółtego od Woodland Park Zoo do Kirkland w stanie Waszyngton.

val line = map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(
            StyleSpan(
                StrokeStyle.gradientBuilder(
                    Color.RED,
                    Color.YELLOW
                ).build()
            )
        )
)

      

Polyline line = map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(new StyleSpan(StrokeStyle.gradientBuilder(Color.RED, Color.YELLOW).build())));

      

Tworzenie oznakowanej linii złożonej

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

val stampStyle =
    TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build()
val span = StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build())
map.addPolyline(
    PolylineOptions()
        .add(LatLng(47.6677146, -122.3470447), LatLng(47.6442757, -122.2814693))
        .addSpan(span)
)

      

StampStyle stampStyle =
        TextureStyle.newBuilder(BitmapDescriptorFactory.fromResource(R.drawable.walking_dot)).build();
StyleSpan span = new StyleSpan(StrokeStyle.colorBuilder(Color.RED).stamp(stampStyle).build());
map.addPolyline(new PolylineOptions()
        .add(new LatLng(47.6677146,-122.3470447), new LatLng(47.6442757,-122.2814693))
        .addSpan(span));

      

Zdarzenia dotyczące linii złożonych

Domyślnie ścieżek wielokątów nie można kliknąć. Aby włączyć lub wyłączyć klikalność, wywołaj Polyline.setClickable(boolean).

Użyj elementu OnPolylineClickListener, aby odbierać zdarzenia kliknięcia na klikalnej polilinii. Aby ustawić tego słuchacza na mapie, zadzwoń pod numer GoogleMap.setOnPolylineClickListener(OnPolylineClickListener). Gdy użytkownik kliknie polilinię, otrzymasz wywołanie zwrotneonPolylineClick(Polyline).

Wielokąty

Obiekty Polygon są podobne do obiektów Polyline, ponieważ składają się z szeregu współrzędnych w uporządkowanej sekwencji. Jednak zamiast być otwarte, są one zaprojektowane w taki sposób, aby definiować obszary w zamkniętej pętli z wypełnionym wnętrzem.

Możesz dodać do mapy obiekt Polygon w taki sam sposób, jak dodawanie Polyline. Najpierw utwórz obiekt PolygonOptions i dodaj do niego punkty. Te punkty utworzą kontur wielokąta. Następnie dodaj wielokąt do mapy, wywołując funkcję GoogleMap.addPolygon(PolygonOptions), która zwróci obiekt Polygon.

Ten fragment kodu dodaje na mapie prostokąt.

// Instantiates a new Polygon object and adds points to define a rectangle
val rectOptions = PolygonOptions()
    .add(
        LatLng(37.35, -122.0),
        LatLng(37.45, -122.0),
        LatLng(37.45, -122.2),
        LatLng(37.35, -122.2),
        LatLng(37.35, -122.0)
    )

// Get back the mutable Polygon
val polygon = map.addPolygon(rectOptions)

      

// Instantiates a new Polygon object and adds points to define a rectangle
PolygonOptions polygonOptions = new PolygonOptions()
    .add(new LatLng(37.35, -122.0),
        new LatLng(37.45, -122.0),
        new LatLng(37.45, -122.2),
        new LatLng(37.35, -122.2),
        new LatLng(37.35, -122.0));

// Get back the mutable Polygon
Polygon polygon = map.addPolygon(polygonOptions);

      

Aby zmienić kształt wielokąta po jego dodaniu, możesz wywołać funkcję Polygon.setPoints() i podać nową listę punktów dla konturu wielokąta.

Wygląd wielokąta możesz dostosować zarówno przed dodaniem go do mapy, jak i po dodaniu. Więcej informacji znajdziesz w sekcji dostosowywanie wyglądu.

Autouzupełnianie wielokątów

Wielokąt w tym przykładzie składa się z 5 współrzędnych, ale zwróć uwagę, że pierwsze i ostatnie współrzędne są takie same, co definiuje pętlę. W praktyce jednak, ponieważ wielokąty wyznaczają zamknięte obszary, nie musisz określać tej ostatniej współrzędnej. Jeśli ostatnia współrzędna różni się od pierwszej, interfejs API automatycznie „zamknie” wielokąt, dodając pierwszą współrzędną na końcu sekwencji współrzędnych.

Te 2 wielokąty są równoważne, a wywołanie funkcji polygon.getPoints() w przypadku każdego z nich zwróci wszystkie 4 punkty.

val polygon1 = map.addPolygon(
    PolygonOptions()
        .add(
            LatLng(0.0, 0.0),
            LatLng(0.0, 5.0),
            LatLng(3.0, 5.0),
            LatLng(0.0, 0.0)
        )
        .strokeColor(Color.RED)
        .fillColor(Color.BLUE)
)
val polygon2 = map.addPolygon(
    PolygonOptions()
        .add(
            LatLng(0.0, 0.0),
            LatLng(0.0, 5.0),
            LatLng(3.0, 5.0)
        )
        .strokeColor(Color.RED)
        .fillColor(Color.BLUE)
)

      

Polygon polygon1 = map.addPolygon(new PolygonOptions()
    .add(new LatLng(0, 0),
        new LatLng(0, 5),
        new LatLng(3, 5),
        new LatLng(0, 0))
    .strokeColor(Color.RED)
    .fillColor(Color.BLUE));

Polygon polygon2 = map.addPolygon(new PolygonOptions()
    .add(new LatLng(0, 0),
        new LatLng(0, 5),
        new LatLng(3, 5))
    .strokeColor(Color.RED)
    .fillColor(Color.BLUE));

      

Tworzenie pustego wielokąta

W jednym obiekcie Polygon można połączyć wiele ścieżek, by utworzyć złożone kształty, takie jak wypełnione pierścienie lub „pierścienie” (gdzie wielokąty są widoczne wewnątrz wielokąta jako „wyspy”). Złożone kształty zawsze stanowią kompozycję wielu prostszych ścieżek.

W tym samym obszarze muszą być zdefiniowane 2 ścieżki. Większy z tych regionów określa obszar wypełnienia i jest prostym wielokątem bez dodatkowych opcji. Następnie przekaż drugą ścieżkę do metody addHole(). Gdy drugi, mniejszy ścieżka jest całkowicie otoczona przez większą ścieżkę, wygląda to tak, jakby część wielokąta została usunięta. Jeśli otwór przecina kontur wielokąta, wielokąt zostanie wyrenderowany bez wypełnienia.

Podany niżej fragment kodu utworzy pojedynczy prostokąt z mniejszym prostokątnym otworem.

val hole = listOf(
    LatLng(1.0, 1.0),
    LatLng(1.0, 2.0),
    LatLng(2.0, 2.0),
    LatLng(2.0, 1.0),
    LatLng(1.0, 1.0)
)
val hollowPolygon = map.addPolygon(
    PolygonOptions()
        .add(
            LatLng(0.0, 0.0),
            LatLng(0.0, 5.0),
            LatLng(3.0, 5.0),
            LatLng(3.0, 0.0),
            LatLng(0.0, 0.0)
        )
        .addHole(hole)
        .fillColor(Color.BLUE)
)

      

List<LatLng> hole = Arrays.asList(new LatLng(1, 1),
    new LatLng(1, 2),
    new LatLng(2, 2),
    new LatLng(2, 1),
    new LatLng(1, 1));
Polygon hollowPolygon = map.addPolygon(new PolygonOptions()
    .add(new LatLng(0, 0),
        new LatLng(0, 5),
        new LatLng(3, 5),
        new LatLng(3, 0),
        new LatLng(0, 0))
    .addHole(hole)
    .fillColor(Color.BLUE));

      

Na mapie pusty wielokąt wygląda tak:

Zdarzenia Polygon

Domyślnie wielokąty nie są klikalne. Aby włączyć lub wyłączyć klikalność, wywołaj Polygon.setClickable(boolean).

Użyj sekcji OnPolygonClickListener, aby rejestrować zdarzenia kliknięcia na klikalnym wielokącie. Aby ustawić tego słuchacza na mapie, zadzwoń pod numer GoogleMap.setOnPolygonClickListener(OnPolygonClickListener). Gdy użytkownik kliknie wielokąt, otrzymaszonPolygonClick(Polygon) połączenie zwrotne.

Kręgi

Oprócz ogólnej klasy Polygon interfejs Maps API zawiera też konkretne klasy dla obiektów Circle, aby uprościć ich konstrukcję.

Aby utworzyć okrąg, musisz określić dwie następujące właściwości:

• center jako LatLng.
• radius w metrach.

Okrąg jest wtedy zdefiniowany jako zbiór wszystkich punktów na powierzchni Ziemi, które znajdują się w odległości radius metrów od danego center. Ze względu na to, jak projekcja Mercatora używana przez interfejs API Map Google renderuje kulę na płaskiej powierzchni, na mapie będzie ona wyglądać jak prawie idealne koło, gdy będzie się znajdować w pobliżu równika. Wraz z odchodzeniem od równika koło będzie coraz bardziej nieregularne (na ekranie).

Aby zmienić kształt koła po jego dodaniu, możesz wywołać metodę Circle.setRadius() lub Circle.setCenter() i podać nowe wartości.

Wygląd kręgu możesz dostosować zarówno przed dodaniem go do mapy, jak i po dodaniu. Więcej informacji znajdziesz w sekcji dostosowywanie wyglądu.

Ten fragment kodu dodaje do mapy okrąg, tworząc obiekt CircleOptions i wywołując funkcję GoogleMap.addCircle(CircleOptions):

// Instantiates a new CircleOptions object and defines the center and radius
val circleOptions = CircleOptions()
    .center(LatLng(37.4, -122.1))
    .radius(1000.0) // In meters

// Get back the mutable Circle
val circle = map.addCircle(circleOptions)

      

// Instantiates a new CircleOptions object and defines the center and radius
CircleOptions circleOptions = new CircleOptions()
    .center(new LatLng(37.4, -122.1))
    .radius(1000); // In meters

// Get back the mutable Circle
Circle circle = map.addCircle(circleOptions);

      

Zdarzenia w kręgu

Domyślnie kółka nie są klikalne. Aby włączyć lub wyłączyć klikalność, wywołaj GoogleMap.addCircle(), używając CircleOptions.clickable(boolean) lub Circle.setClickable(boolean).

Użyj elementu OnCircleClickListener, aby nasłuchiwać zdarzeń kliknięcia w klikalnym okręgu. Aby ustawić ten odbiornik na mapie, wywołaj GoogleMap.setOnCircleClickListener(OnCircleClickListener).

Gdy użytkownik kliknie okrąg, otrzymasz wywołanie zwrotne onCircleClick(Circle), jak pokazano w tym przykładowym kodzie:

val circle = map.addCircle(
    CircleOptions()
        .center(LatLng(37.4, -122.1))
        .radius(1000.0)
        .strokeWidth(10f)
        .strokeColor(Color.GREEN)
        .fillColor(Color.argb(128, 255, 0, 0))
        .clickable(true)
)
map.setOnCircleClickListener {
    // Flip the r, g and b components of the circle's stroke color.
    val strokeColor = it.strokeColor xor 0x00ffffff
    it.strokeColor = strokeColor
}

      

Circle circle = map.addCircle(new CircleOptions()
    .center(new LatLng(37.4, -122.1))
    .radius(1000)
    .strokeWidth(10)
    .strokeColor(Color.GREEN)
    .fillColor(Color.argb(128, 255, 0, 0))
    .clickable(true));

map.setOnCircleClickListener(new GoogleMap.OnCircleClickListener() {
    @Override
    public void onCircleClick(Circle circle) {
        // Flip the r, g and b components of the circle's stroke color.
        int strokeColor = circle.getStrokeColor() ^ 0x00ffffff;
        circle.setStrokeColor(strokeColor);
    }
});

      

Dostosowywanie wyglądu

Wygląd kształtu możesz zmienić zarówno przed dodaniem go do mapy (poprzez określenie odpowiedniej właściwości w obiekcie opcji), jak i po dodaniu go do mapy. Gettery są również dostępne we wszystkich właściwościach, dzięki czemu możesz łatwo uzyskać dostęp do bieżącego stanu kształtu.

Ten fragment kodu dodaje grubą niebieską linię wielokąta z geodezyjnymi segmentami z Melbourne do Perth. Właściwości te zostały szczegółowo wyjaśnione w sekcjach poniżej.

val polyline = map.addPolyline(
    PolylineOptions()
        .add(LatLng(-37.81319, 144.96298), LatLng(-31.95285, 115.85734))
        .width(25f)
        .color(Color.BLUE)
        .geodesic(true)
)

      

Polyline polyline = map.addPolyline(new PolylineOptions()
    .add(new LatLng(-37.81319, 144.96298), new LatLng(-31.95285, 115.85734))
    .width(25)
    .color(Color.BLUE)
    .geodesic(true));

      

Mapa wygląda tak:

Uwaga: większość z nich można zastosować do dowolnych opisanych kształtów, jednak niektóre właściwości mogą nie mieć znaczenia dla określonych kształtów (np. linia łamana nie może mieć koloru wypełnienia, ponieważ nie ma wnętrza).

Kolor kreski

Kolor obrysu to 32-bitowa liczba całkowita alfa-czerwony-zielony-niebieski (ARGB), która określa przezroczystość i kolor obrysu kształtu. Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję *Options.strokeColor() (lub PolylineOptions.color() w przypadku ścieżki wielosegmentowej). Jeśli nie określisz tego ustawienia, domyślny kolor obrysu będzie czarny (Color.BLACK).

Po dodaniu kształtu do mapy możesz uzyskać dostęp do koloru obrysu, wywołując funkcję getStrokeColor() (lub getColor() w przypadku ścieżki złożonej) i zmienić go, wywołując funkcję setStrokeColor() (setColor() for a polyline).

Kolor wypełnienia

Kolor wypełnienia dotyczy tylko wielokątów i kół. Nie dotyczy to łuków, ponieważ nie mają one zdefiniowanych wnętrz. W przypadku wielokąta obszary wewnątrz jego otworów nie wchodzą w skład wnętrza wielokąta i nie będą pokolorowane, jeśli ustawisz kolor wypełnienia.

Kolor wypełnienia to 32-bitowa liczba całkowita alfa-czerwony-zielony-niebieski (ARGB), która określa przezroczystość i kolor wnętrza kształtu. Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję *Options.fillColor(). Jeśli nie określono tego koloru, domyślny kolor kreski jest przezroczysty (Color.TRANSPARENT).

Po dodaniu kształtu do mapy możesz uzyskać dostęp do koloru wypełnienia, wywołując funkcję getFillColor(), a jego kolor możesz zmienić, wywołując funkcję setFillColor().

Szerokość kreski

Szerokość obrysu linii jako liczba zmiennoprzecinkowa w pikselach (px). Szerokość nie zmienia się, gdy powiększasz mapę (czyli kształt będzie miał tę sam obrys na wszystkich poziomach powiększenia). Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję *Options.strokeWidth() (lub PolylineOptions.width() w przypadku wielokąta). Jeśli nie określisz tego ustawienia, domyślna grubość będzie wynosić 10 pikseli.

Po dodaniu kształtu do mapy możesz uzyskać dostęp do szerokości obrysu, wywołując funkcję getStrokeWidth() (lub getWidth() w przypadku łańcucha wielokątów) i zmienić ją, wywołując funkcję setStrokeWidth() (setWidth() for a polyline).

Wzór obrysu

Domyślny wzór obrysu to ciągła linia w przypadku wielolinii, konturów wielokątów i kół. Możesz określić niestandardowy wzorzec kreski obiektów PatternItem, gdzie każdy element to myślnik, kropka lub kropka.

Poniższy przykład przedstawia wzór dla linii łamanej na powtórzony sekwencję kropki, a następnie lukę o długości 20 pikseli, łącznik długości 30 pikseli i kolejną 20 pikseli.

val pattern = listOf(
    Dot(), Gap(20F), Dash(30F), Gap(20F)
)
polyline.pattern = pattern

      

List<PatternItem> pattern = Arrays.asList(
    new Dot(), new Gap(20), new Dash(30), new Gap(20));
polyline.setPattern(pattern);

      

Wzór powtarza się wzdłuż linii, zaczynając od pierwszego elementu wzorca na pierwszym wierzchołku określonym dla kształtu.

Typy połączeń

W przypadku linii łamanych i obrysów wielokątów możesz podać ścięcie lub okrąg JointType, aby zastąpić domyślny stały typ połączenia ściętego.

W tym przykładzie do polilinii zastosowano łączenie zaokrąglone:

polyline.jointType = JointType.ROUND

      

polyline.setJointType(JointType.ROUND);

      

Typ złącza wpływa na wewnętrzne wygięcia linii. Jeśli linia ma szew z wzorem, który zawiera łączniki, typ połączenia jest stosowany również wtedy, gdy łącznik znajduje się na styku. Typy połączeń nie mają wpływu na kropki, ponieważ są one zawsze okrągłe.

Ograniczenia prędkości

Możesz określić styl Cap dla każdego końca polilinii. Dostępne opcje to „but” (domyślnie), „kwadratowy”, „okrągły” i „niestandardowa mapa bitowa”. Ustaw styl w PolylineOptions.startCap i PolylineOptions.endCap albo użyj odpowiednich metod gettera i settera.

Ten fragment kodu określa okrągłe ograniczenie na początku linii łamanej.

polyline.startCap = RoundCap()

      

polyline.setStartCap(new RoundCap());

      

Ten fragment kodu określa niestandardową mapę bitową dla reklamy po zakończeniu filmu:

polyline.endCap = CustomCap(BitmapDescriptorFactory.fromResource(R.drawable.arrow), 16F)

      

polyline.setEndCap(
    new CustomCap(BitmapDescriptorFactory.fromResource(R.drawable.arrow), 16));

      

Jeśli używasz niestandardowej bitmapy, musisz podać referencyjny wymiar obrysu w pikselach. Interfejs API odpowiednio skaluje bitmapę. Szerokość kreski referencyjnej to szerokość kreski użyta podczas projektowania obrazu bitmapy dla ograniczenia w pierwotnych wymiarach obrazu. Domyślna szerokość kreski referencyjnej wynosi 10 pikseli. Wskazówka: aby określić szerokość obrysu odniesienia, otwórz obraz bitmapy w 100% powiększeniu w edytorze grafiki i wyznacz pożądaną szerokość obrysu względem obrazu.

Jeśli do utworzenia bitmapy używasz pliku BitmapDescriptorFactory.fromResource(), upewnij się, że używasz zasobu niezależnego od gęstości (nodpi).

Segmenty geodezyjne

Ustawienie geodezyjne dotyczy tylko linii łamanych i wielokątów. Nie dotyczy to kręgów, ponieważ nie są one zdefiniowane jako zbiór segmentów.

Ustawienie geodezyjne określa sposób rysowania odcinków linii między kolejnymi wierzchołkami polilinii lub wielokąta. Odcinki geodezyjne to te, które przebiegają najkrótszą drogą po powierzchni Ziemi (kulki) i często wyglądają na mapie jak linie wygięte w projekcji Mercatora. Odcinki niegeodezyjne są na mapie wyświetlane jako linie proste.

Ustaw tę właściwość na obiekcie opcji kształtu, wywołując właściwość *Options.geodesic(), gdzie true wskazuje, że segmenty powinny być rysowane jako obiekty geodezyjne, a false wskazuje, że mają być rysowane jako linie proste. Jeśli nie podasz żadnej wartości, domyślnie zostaną użyte segmenty niegeodezyjne (false).

Po dodaniu kształtu do mapy można uzyskać dostęp do ustawienia geodezyjnego, wywołując funkcję isGeodesic(), a jego wartość można zmienić, wywołując funkcję setGeodesic().

Kolejność nakładania elementów

Kolejność nakładania elementów określa porządek nakładania się kształtu względem innych nakładek (innych kształtów, warstw i kafelków) na mapie. Nakładka o wysokiej wartości wskaźnika z-index jest wyświetlana nad nakładkami o niższej wartości tego parametru. 2 nakładki o tej samej kolejności nakładania elementów są wyświetlane w dowolnej kolejności.

Pamiętaj, że znaczniki są zawsze rysowane nad innymi nakładkami, niezależnie od kolejności nakładania pozostałych nakładek.

Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję *Options.zIndex(). Jeśli nie określono inaczej, domyślna wartość z-index to 0. Po dodaniu kształtu do mapy możesz uzyskać dostęp do indeksu Z, wywołując metodę getZIndex(), a jego wartość możesz zmienić, wywołując metodę setZIndex().

Widoczność

Widoczność określa, czy kształt ma być rysowany na mapie, gdzie true wskazuje, że powinien być narysowany, a false – nie. Pozwala na tymczasowe ukrycie kształtu na mapie. Aby na stałe usunąć kształt z mapy, wywołaj metodę remove() tego kształtu.

Ustaw tę właściwość w obiekcie opcji kształtu, wywołując funkcję *Options.visible(). Jeśli nie określono inaczej, widoczność domyślna to true. Po dodaniu kształtu do mapy możesz uzyskać dostęp do widoczności, wywołując funkcję isVisible(), a jego zmianę, wywołując funkcję setVisible().

Powiąż dane z kształtem

Możesz przechowywać dowolny obiekt danych za pomocą łamany, wielokąta lub okręgu za pomocą metody setTag() kształtu i pobierać obiekt za pomocą getTag(). Na przykład wywołaj funkcję Polyline.setTag(), aby zapisać obiekt danych z wielokątem, a następnie wywołaj funkcję Polyline.getTag(), aby pobrać obiekt danych.

Poniższy kod definiuje dowolny tag (A) dla określonej ścieżki wielokąta:

val polyline = map.addPolyline(
    PolylineOptions()
        .clickable(true)
        .add(
            LatLng(-35.016, 143.321),
            LatLng(-34.747, 145.592),
            LatLng(-34.364, 147.891),
            LatLng(-33.501, 150.217),
            LatLng(-32.306, 149.248),
            LatLng(-32.491, 147.309)
        )
)
polyline.tag = "A"

      

Polyline polyline = map.addPolyline((new PolylineOptions())
    .clickable(true)
    .add(new LatLng(-35.016, 143.321),
        new LatLng(-34.747, 145.592),
        new LatLng(-34.364, 147.891),
        new LatLng(-33.501, 150.217),
        new LatLng(-32.306, 149.248),
        new LatLng(-32.491, 147.309)));

polyline.setTag("A");

      

Oto kilka przykładów sytuacji, w których przydatne jest przechowywanie i pobieranie danych za pomocą kształtów:

• Twoja aplikacja może obsługiwać różne typy kształtów i chcesz je traktować inaczej, gdy użytkownik kliknie jeden z nich.
• Możesz mieć do czynienia z systemem, który ma unikalne identyfikatory rekordów, a kształty reprezentują konkretne rekordy w tym systemie.
• Dane kształtu mogą wskazywać priorytet, który służy do określenia z-indexu kształtu.