Rotaları ve Alanları Gösterecek Çoklu Çizgiler ve Çokgenler

Bu eğiticide, Android uygulamanıza Google Haritası ekleme ve haritadaki rotaları ve alanları göstermek için çoklu çizgiler ve poligonlar kullanma konuları açıklanmaktadır.

Android için Haritalar SDK'sını kullanarak Android uygulaması oluşturmak için eğiticideki adımları uygulayın. Önerilen geliştirme ortamı Android Studio'dur.

Kodu alın

GitHub'dan Google Haritalar Android API v2 Örnekleri deposunu klonlayın veya indirin.

Etkinliğin Java sürümünü görüntüleme:

Kodu Göster / Gizle

    // Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.example.polygons;

import android.os.Bundle;
import android.widget.Toast;
import androidx.appcompat.app.AppCompatActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.BitmapDescriptorFactory;
import com.google.android.gms.maps.model.CustomCap;
import com.google.android.gms.maps.model.Dash;
import com.google.android.gms.maps.model.Dot;
import com.google.android.gms.maps.model.Gap;
import com.google.android.gms.maps.model.JointType;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.PatternItem;
import com.google.android.gms.maps.model.Polygon;
import com.google.android.gms.maps.model.PolygonOptions;
import com.google.android.gms.maps.model.Polyline;
import com.google.android.gms.maps.model.PolylineOptions;
import com.google.android.gms.maps.model.RoundCap;
import java.util.Arrays;
import java.util.List;


/**
 * An activity that displays a Google map with polylines to represent paths or routes,
 * and polygons to represent areas.
 */
public class PolyActivity extends AppCompatActivity
        implements
                OnMapReadyCallback,
                GoogleMap.OnPolylineClickListener,
                GoogleMap.OnPolygonClickListener {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Retrieve the content view that renders the map.
        setContentView(R.layout.activity_maps);

        // Get the SupportMapFragment and request notification when the map is ready to be used.
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /**
     * Manipulates the map when it's available.
     * The API invokes this callback when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera.
     * In this tutorial, we add polylines and polygons to represent routes and areas on the map.
     */
    @Override
    public void onMapReady(GoogleMap googleMap) {

        // Add polylines to the map.
        // Polylines are useful to show a route or some other connection between points.
        Polyline polyline1 = googleMap.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)));
        // Store a data object with the polyline, used here to indicate an arbitrary type.
        polyline1.setTag("A");
        // Style the polyline.
        stylePolyline(polyline1);

        Polyline polyline2 = googleMap.addPolyline(new PolylineOptions()
                .clickable(true)
                .add(
                        new LatLng(-29.501, 119.700),
                        new LatLng(-27.456, 119.672),
                        new LatLng(-25.971, 124.187),
                        new LatLng(-28.081, 126.555),
                        new LatLng(-28.848, 124.229),
                        new LatLng(-28.215, 123.938)));
        polyline2.setTag("B");
        stylePolyline(polyline2);

        // Add polygons to indicate areas on the map.
        Polygon polygon1 = googleMap.addPolygon(new PolygonOptions()
                .clickable(true)
                .add(
                        new LatLng(-27.457, 153.040),
                        new LatLng(-33.852, 151.211),
                        new LatLng(-37.813, 144.962),
                        new LatLng(-34.928, 138.599)));
        // Store a data object with the polygon, used here to indicate an arbitrary type.
        polygon1.setTag("alpha");
        // Style the polygon.
        stylePolygon(polygon1);

        Polygon polygon2 = googleMap.addPolygon(new PolygonOptions()
                .clickable(true)
                .add(
                        new LatLng(-31.673, 128.892),
                        new LatLng(-31.952, 115.857),
                        new LatLng(-17.785, 122.258),
                        new LatLng(-12.4258, 130.7932)));
        polygon2.setTag("beta");
        stylePolygon(polygon2);

        // Position the map's camera near Alice Springs in the center of Australia,
        // and set the zoom factor so most of Australia shows on the screen.
        googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(-23.684, 133.903), 4));

        // Set listeners for click events.
        googleMap.setOnPolylineClickListener(this);
        googleMap.setOnPolygonClickListener(this);
    }

    private static final int COLOR_BLACK_ARGB = 0xff000000;
    private static final int POLYLINE_STROKE_WIDTH_PX = 12;

    /**
     * Styles the polyline, based on type.
     * @param polyline The polyline object that needs styling.
     */
    private void stylePolyline(Polyline polyline) {
        String type = "";
        // Get the data object stored with the polyline.
        if (polyline.getTag() != null) {
            type = polyline.getTag().toString();
        }

        switch (type) {
            // If no type is given, allow the API to use the default.
            case "A":
                // Use a custom bitmap as the cap at the start of the line.
                polyline.setStartCap(
                        new CustomCap(
                                BitmapDescriptorFactory.fromResource(R.drawable.ic_arrow), 10));
                break;
            case "B":
                // Use a round cap at the start of the line.
                polyline.setStartCap(new RoundCap());
                break;
        }

        polyline.setEndCap(new RoundCap());
        polyline.setWidth(POLYLINE_STROKE_WIDTH_PX);
        polyline.setColor(COLOR_BLACK_ARGB);
        polyline.setJointType(JointType.ROUND);
    }

    private static final int PATTERN_GAP_LENGTH_PX = 20;
    private static final PatternItem DOT = new Dot();
    private static final PatternItem GAP = new Gap(PATTERN_GAP_LENGTH_PX);

    // Create a stroke pattern of a gap followed by a dot.
    private static final List<PatternItem> PATTERN_POLYLINE_DOTTED = Arrays.asList(GAP, DOT);

    /**
     * Listens for clicks on a polyline.
     * @param polyline The polyline object that the user has clicked.
     */
    @Override
    public void onPolylineClick(Polyline polyline) {
        // Flip from solid stroke to dotted stroke pattern.
        if ((polyline.getPattern() == null) || (!polyline.getPattern().contains(DOT))) {
            polyline.setPattern(PATTERN_POLYLINE_DOTTED);
        } else {
            // The default pattern is a solid stroke.
            polyline.setPattern(null);
        }

        Toast.makeText(this, "Route type " + polyline.getTag().toString(),
                Toast.LENGTH_SHORT).show();
    }

    /**
     * Listens for clicks on a polygon.
     * @param polygon The polygon object that the user has clicked.
     */
    @Override
    public void onPolygonClick(Polygon polygon) {
        // Flip the values of the red, green, and blue components of the polygon's color.
        int color = polygon.getStrokeColor() ^ 0x00ffffff;
        polygon.setStrokeColor(color);
        color = polygon.getFillColor() ^ 0x00ffffff;
        polygon.setFillColor(color);

        Toast.makeText(this, "Area type " + polygon.getTag().toString(), Toast.LENGTH_SHORT).show();
    }

    private static final int COLOR_WHITE_ARGB = 0xffffffff;
    private static final int COLOR_DARK_GREEN_ARGB = 0xff388E3C;
    private static final int COLOR_LIGHT_GREEN_ARGB = 0xff81C784;
    private static final int COLOR_DARK_ORANGE_ARGB = 0xffF57F17;
    private static final int COLOR_LIGHT_ORANGE_ARGB = 0xffF9A825;

    private static final int POLYGON_STROKE_WIDTH_PX = 8;
    private static final int PATTERN_DASH_LENGTH_PX = 20;
    private static final PatternItem DASH = new Dash(PATTERN_DASH_LENGTH_PX);

    // Create a stroke pattern of a gap followed by a dash.
    private static final List<PatternItem> PATTERN_POLYGON_ALPHA = Arrays.asList(GAP, DASH);

    // Create a stroke pattern of a dot followed by a gap, a dash, and another gap.
    private static final List<PatternItem> PATTERN_POLYGON_BETA =
        Arrays.asList(DOT, GAP, DASH, GAP);

    /**
     * Styles the polygon, based on type.
     * @param polygon The polygon object that needs styling.
     */
    private void stylePolygon(Polygon polygon) {
        String type = "";
        // Get the data object stored with the polygon.
        if (polygon.getTag() != null) {
            type = polygon.getTag().toString();
        }

        List<PatternItem> pattern = null;
        int strokeColor = COLOR_BLACK_ARGB;
        int fillColor = COLOR_WHITE_ARGB;

        switch (type) {
            // If no type is given, allow the API to use the default.
            case "alpha":
                // Apply a stroke pattern to render a dashed line, and define colors.
                pattern = PATTERN_POLYGON_ALPHA;
                strokeColor = COLOR_DARK_GREEN_ARGB;
                fillColor = COLOR_LIGHT_GREEN_ARGB;
                break;
            case "beta":
                // Apply a stroke pattern to render a line of dots and dashes, and define colors.
                pattern = PATTERN_POLYGON_BETA;
                strokeColor = COLOR_DARK_ORANGE_ARGB;
                fillColor = COLOR_LIGHT_ORANGE_ARGB;
                break;
        }

        polygon.setStrokePattern(pattern);
        polygon.setStrokeWidth(POLYGON_STROKE_WIDTH_PX);
        polygon.setStrokeColor(strokeColor);
        polygon.setFillColor(fillColor);
    }
}

    

Etkinliğin Kotlin sürümünü görüntüleyin:

Kodu Göster / Gizle

    // Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.example.polygons

import android.os.Bundle
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import com.google.android.gms.maps.CameraUpdateFactory
import com.google.android.gms.maps.GoogleMap
import com.google.android.gms.maps.GoogleMap.OnPolygonClickListener
import com.google.android.gms.maps.GoogleMap.OnPolylineClickListener
import com.google.android.gms.maps.OnMapReadyCallback
import com.google.android.gms.maps.SupportMapFragment
import com.google.android.gms.maps.model.BitmapDescriptorFactory
import com.google.android.gms.maps.model.CustomCap
import com.google.android.gms.maps.model.Dash
import com.google.android.gms.maps.model.Dot
import com.google.android.gms.maps.model.Gap
import com.google.android.gms.maps.model.JointType
import com.google.android.gms.maps.model.LatLng
import com.google.android.gms.maps.model.PatternItem
import com.google.android.gms.maps.model.Polygon
import com.google.android.gms.maps.model.PolygonOptions
import com.google.android.gms.maps.model.Polyline
import com.google.android.gms.maps.model.PolylineOptions
import com.google.android.gms.maps.model.RoundCap

/**
 * An activity that displays a Google map with polylines to represent paths or routes,
 * and polygons to represent areas.
 */
class PolyActivity : AppCompatActivity(), OnMapReadyCallback, OnPolylineClickListener, OnPolygonClickListener {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Retrieve the content view that renders the map.
        setContentView(R.layout.activity_maps)

        // Get the SupportMapFragment and request notification when the map is ready to be used.
        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment?
        mapFragment?.getMapAsync(this)
    }

    /**
     * Manipulates the map when it's available.
     * The API invokes this callback when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera.
     * In this tutorial, we add polylines and polygons to represent routes and areas on the map.
     */
    override fun onMapReady(googleMap: GoogleMap) {

        // Add polylines to the map.
        // Polylines are useful to show a route or some other connection between points.
        val polyline1 = googleMap.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)))
        // Store a data object with the polyline, used here to indicate an arbitrary type.
        polyline1.tag = "A"
        // Style the polyline.
        stylePolyline(polyline1)

        val polyline2 = googleMap.addPolyline(PolylineOptions()
            .clickable(true)
            .add(
                LatLng(-29.501, 119.700),
                LatLng(-27.456, 119.672),
                LatLng(-25.971, 124.187),
                LatLng(-28.081, 126.555),
                LatLng(-28.848, 124.229),
                LatLng(-28.215, 123.938)))
        polyline2.tag = "B"
        stylePolyline(polyline2)

        // Add polygons to indicate areas on the map.
        val polygon1 = googleMap.addPolygon(PolygonOptions()
            .clickable(true)
            .add(
                LatLng(-27.457, 153.040),
                LatLng(-33.852, 151.211),
                LatLng(-37.813, 144.962),
                LatLng(-34.928, 138.599)))
        // Store a data object with the polygon, used here to indicate an arbitrary type.
        polygon1.tag = "alpha"
        // Style the polygon.
        stylePolygon(polygon1)

        val polygon2 = googleMap.addPolygon(PolygonOptions()
            .clickable(true)
            .add(
                LatLng(-31.673, 128.892),
                LatLng(-31.952, 115.857),
                LatLng(-17.785, 122.258),
                LatLng(-12.4258, 130.7932)))
        polygon2.tag = "beta"
        stylePolygon(polygon2)

        // Position the map's camera near Alice Springs in the center of Australia,
        // and set the zoom factor so most of Australia shows on the screen.
        googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(LatLng(-23.684, 133.903), 4f))

        // Set listeners for click events.
        googleMap.setOnPolylineClickListener(this)
        googleMap.setOnPolygonClickListener(this)
    }

    private val COLOR_BLACK_ARGB = -0x1000000
    private val POLYLINE_STROKE_WIDTH_PX = 12

    /**
     * Styles the polyline, based on type.
     * @param polyline The polyline object that needs styling.
     */
    private fun stylePolyline(polyline: Polyline) {
        // Get the data object stored with the polyline.
        val type = polyline.tag?.toString() ?: ""
        when (type) {
            "A" -> {
                // Use a custom bitmap as the cap at the start of the line.
                polyline.startCap = CustomCap(
                    BitmapDescriptorFactory.fromResource(R.drawable.ic_arrow), 10f)
            }
            "B" -> {
               // Use a round cap at the start of the line.
                polyline.startCap = RoundCap()
            }
        }
        polyline.endCap = RoundCap()
        polyline.width = POLYLINE_STROKE_WIDTH_PX.toFloat()
        polyline.color = COLOR_BLACK_ARGB
        polyline.jointType = JointType.ROUND
    }

    private val PATTERN_GAP_LENGTH_PX = 20
    private val DOT: PatternItem = Dot()
    private val GAP: PatternItem = Gap(PATTERN_GAP_LENGTH_PX.toFloat())

    // Create a stroke pattern of a gap followed by a dot.
    private val PATTERN_POLYLINE_DOTTED = listOf(GAP, DOT)

    /**
     * Listens for clicks on a polyline.
     * @param polyline The polyline object that the user has clicked.
     */
    override fun onPolylineClick(polyline: Polyline) {
        // Flip from solid stroke to dotted stroke pattern.
        if (polyline.pattern == null || !polyline.pattern!!.contains(DOT)) {
            polyline.pattern = PATTERN_POLYLINE_DOTTED
        } else {
            // The default pattern is a solid stroke.
            polyline.pattern = null
        }
        Toast.makeText(this, "Route type " + polyline.tag.toString(),
            Toast.LENGTH_SHORT).show()
    }

    /**
     * Listens for clicks on a polygon.
     * @param polygon The polygon object that the user has clicked.
     */
    override fun onPolygonClick(polygon: Polygon) {
        // Flip the values of the red, green, and blue components of the polygon's color.
        var color = polygon.strokeColor xor 0x00ffffff
        polygon.strokeColor = color
        color = polygon.fillColor xor 0x00ffffff
        polygon.fillColor = color
        Toast.makeText(this, "Area type ${polygon.tag?.toString()}", Toast.LENGTH_SHORT).show()
    }

    private val COLOR_WHITE_ARGB = -0x1
    private val COLOR_DARK_GREEN_ARGB = -0xc771c4
    private val COLOR_LIGHT_GREEN_ARGB = -0x7e387c
    private val COLOR_DARK_ORANGE_ARGB = -0xa80e9
    private val COLOR_LIGHT_ORANGE_ARGB = -0x657db
    private val POLYGON_STROKE_WIDTH_PX = 8
    private val PATTERN_DASH_LENGTH_PX = 20

    private val DASH: PatternItem = Dash(PATTERN_DASH_LENGTH_PX.toFloat())

    // Create a stroke pattern of a gap followed by a dash.
    private val PATTERN_POLYGON_ALPHA = listOf(GAP, DASH)

    // Create a stroke pattern of a dot followed by a gap, a dash, and another gap.
    private val PATTERN_POLYGON_BETA = listOf(DOT, GAP, DASH, GAP)

    /**
     * Styles the polygon, based on type.
     * @param polygon The polygon object that needs styling.
     */
    private fun stylePolygon(polygon: Polygon) {
        // Get the data object stored with the polygon.
        val type = polygon.tag?.toString() ?: ""
        var pattern: List<PatternItem>? = null
        var strokeColor = COLOR_BLACK_ARGB
        var fillColor = COLOR_WHITE_ARGB
        when (type) {
            "alpha" -> {
                // Apply a stroke pattern to render a dashed line, and define colors.
                pattern = PATTERN_POLYGON_ALPHA
                strokeColor = COLOR_DARK_GREEN_ARGB
                fillColor = COLOR_LIGHT_GREEN_ARGB
            }
            "beta" -> {
                // Apply a stroke pattern to render a line of dots and dashes, and define colors.
                pattern = PATTERN_POLYGON_BETA
                strokeColor = COLOR_DARK_ORANGE_ARGB
                fillColor = COLOR_LIGHT_ORANGE_ARGB
            }
        }
        polygon.strokePattern = pattern
        polygon.strokeWidth = POLYGON_STROKE_WIDTH_PX.toFloat()
        polygon.strokeColor = strokeColor
        polygon.fillColor = fillColor
    }
}

    

Geliştirme projenizi oluşturma

Android Studio'da eğitim projesi oluşturmak için aşağıdaki adımları uygulayın.

1. Android Studio'yu indirip yükleyin.
2. Android Studio'ya Google Play Hizmetleri paketini ekleyin.
3. Bu eğitseli okumaya başladığınızda yapmadıysanız Google Maps Android API v2 Samples deposunu klonlayın veya indirin.

4. Eğitim projesini içe aktarın:

   • Android Studio'da File > New > Import Project'i (Dosya > Yeni > Projeyi İçe Aktar) seçin.
   • Google Maps Android API v2 Samples repository'yi indirdikten sonra kaydettiğiniz konuma gidin.
   • Polygons projesini şu konumda bulabilirsiniz:
     PATH-TO-SAVED-REPO/android-samples/tutorials/java/Polygons (Java) veya
     PATH-TO-SAVED-REPO/android-samples/tutorials/kotlin/Polygons (Kotlin)
   • Proje dizinini seçin ve Aç'ı tıklayın. Android Studio artık Gradle derleme aracını kullanarak projenizi derliyor.

Gerekli API'leri etkinleştirme ve API anahtarı alma

Bu eğitimi tamamlamak için gerekli API'lerin etkinleştirildiği bir Google Cloud projesine ve Android için Haritalar SDK'sını kullanmaya yetkili bir API anahtarına ihtiyacınız vardır. Daha fazla bilgi için:

• Google Cloud projenizi oluşturun
• API anahtarı kullanma

API anahtarını uygulamanıza ekleme

1. Projenizin local.properties dosyasını açın.

2. Aşağıdaki dizeyi ekleyin ve ardından YOUR_API_KEY kısmını API anahtarınızın değeriyle değiştirin:

   MAPS_API_KEY=YOUR_API_KEY
   

   Uygulamanızı oluşturduğunuzda Android İçin Secrets Gradle Plugin API anahtarını kopyalar ve aşağıda açıklandığı gibi Android manifestinde derleme değişkeni olarak kullanılabilir hale getirir.

Uygulamanızı derleyip çalıştırma

Uygulamayı derleyip çalıştırmak için:

1. Android cihazı bilgisayarınıza bağlayın. Android cihazınızda geliştirici seçeneklerini etkinleştirmek ve sisteminizi cihazı algılayacak şekilde yapılandırmak için talimatları uygulayın.

   Alternatif olarak, sanal cihazı yapılandırmak için Android Virtual Device (AVD) Manager'ı kullanabilirsiniz. Bir emülatör seçerken Google API'lerini içeren bir görüntü seçtiğinizden emin olun. Daha fazla bilgi için Android Studio projesi oluşturma başlıklı makaleyi inceleyin.

2. Android Studio'da Run (Çalıştır) menü seçeneğini (veya oynatma düğmesi simgesini) tıklayın. İstendiğinde bir cihaz seçin.

Android Studio, uygulamayı oluşturmak için Gradle'ı çağırır ve ardından uygulamayı cihazda veya emülatörde çalıştırır.

Bu sayfadaki resme benzer şekilde, Avustralya'nın üzerinde iki çokgenin yer aldığı bir harita görmeniz gerekir.

Sorun Giderme:

• Harita görmüyorsanız yukarıda açıklandığı gibi bir API anahtarı aldığınızı ve bunu uygulamaya eklediğinizi kontrol edin. Android Studio'nun Android Monitor bölümündeki günlükte API anahtarıyla ilgili hata mesajlarını kontrol edin.
• Günlükleri görüntülemek ve uygulamada hata ayıklamak için Android Studio hata ayıklama araçlarını kullanın.

Kodu anlama

Bu eğitimin bu bölümünde, benzer bir uygulama oluşturmayı anlamanıza yardımcı olmak için Polygons uygulamasının en önemli kısımları açıklanmaktadır.

Android manifest dosyanızı kontrol etme

Uygulamanızın AndroidManifest.xml dosyasında aşağıdaki öğelere dikkat edin:

• Uygulamanın derlendiği Google Play Hizmetleri sürümünü yerleştirmek için meta-data öğesi ekleyin.

  <meta-data
      android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version" />
  

• API anahtarınızı belirten bir meta-data öğesi ekleyin. Bu eğiticinin beraberindeki örnek, API anahtarının değerini, daha önce tanımladığınız anahtarın adıyla eşleşen bir derleme değişkeniyle (MAPS_API_KEY) eşler. Uygulamanızı oluşturduğunuzda Android İçin Secrets Gradle Plugin, local.properties dosyanızdaki anahtarları manifest oluşturma değişkenleri olarak kullanılabilir hale getirir.

  <meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${MAPS_API_KEY}" />
  

  build.gradle dosyanızda aşağıdaki satır, API anahtarınızı Android manifestinize iletir.

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
  

Aşağıda, manifestin eksiksiz bir örneği verilmiştir:

  <?xml version="1.0" encoding="utf-8"?>
<!--
 Copyright 2020 Google LLC

 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
 You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<manifest xmlns:android="http://schemas.android.com/apk/res/android">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <meta-data
            android:name="com.google.android.gms.version"
            android:value="@integer/google_play_services_version" />

        <!--
             The API key for Google Maps-based APIs.
        -->
        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="${MAPS_API_KEY}" />

        <activity
            android:name="com.example.polygons.PolyActivity"
            android:exported="true"
            android:label="@string/title_activity_maps">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

  

Harita ekleme

Android için Haritalar SDK'sını kullanarak bir harita görüntüleyin.

1. Etkinliğinizin düzen dosyasına <fragment> öğesi ekleyin, activity_maps.xml. Bu öğe, harita için kapsayıcı görevi görecek ve GoogleMap nesnesine erişim sağlayacak bir SupportMapFragment tanımlar. Bu eğitimde, Android çerçevesinin önceki sürümleriyle geriye dönük uyumluluğu sağlamak için harita parçasının Android destek kitaplığı sürümü kullanılmaktadır.

   <!--
    Copyright 2020 Google LLC
   
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
   
         http://www.apache.org/licenses/LICENSE-2.0
   
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
   -->
   
   <fragment xmlns:android="http://schemas.android.com/apk/res/android"
       xmlns:tools="http://schemas.android.com/tools"
       android:id="@+id/map"
       android:name="com.google.android.gms.maps.SupportMapFragment"
       android:layout_width="match_parent"
       android:layout_height="match_parent"
       tools:context="com.example.polygons.PolyActivity" />

2. Etkinliğinizin onCreate() yönteminde düzen dosyasını içerik görünümü olarak ayarlayın. FragmentManager.findFragmentById() işlevini çağırarak harita parçası için bir tutma yeri alın. Ardından, harita geri çağırma için kaydolmak üzere getMapAsync() kullanın:

   Java

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
   
       // Retrieve the content view that renders the map.
       setContentView(R.layout.activity_maps);
   
       // Get the SupportMapFragment and request notification when the map is ready to be used.
       SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
               .findFragmentById(R.id.map);
       mapFragment.getMapAsync(this);
   }
   PolyActivity.java

   Kotlin

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
   
       // Retrieve the content view that renders the map.
       setContentView(R.layout.activity_maps)
   
       // Get the SupportMapFragment and request notification when the map is ready to be used.
       val mapFragment = supportFragmentManager
           .findFragmentById(R.id.map) as SupportMapFragment?
       mapFragment?.getMapAsync(this)
   }
   PolyActivity.kt

3. OnMapReadyCallback arayüzünü uygulayın ve onMapReady() yöntemini geçersiz kılın. API, GoogleMap nesnesi kullanılabilir olduğunda bu geri çağırmayı çağırır. Böylece, haritaya nesneler ekleyebilir ve uygulamanız için daha fazla özelleştirebilirsiniz:

   Java

   public class PolyActivity extends AppCompatActivity
           implements
                   OnMapReadyCallback,
                   GoogleMap.OnPolylineClickListener,
                   GoogleMap.OnPolygonClickListener {
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
   
           // Retrieve the content view that renders the map.
           setContentView(R.layout.activity_maps);
   
           // Get the SupportMapFragment and request notification when the map is ready to be used.
           SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                   .findFragmentById(R.id.map);
           mapFragment.getMapAsync(this);
       }
   
       /**
        * Manipulates the map when it's available.
        * The API invokes this callback when the map is ready to be used.
        * This is where we can add markers or lines, add listeners or move the camera.
        * In this tutorial, we add polylines and polygons to represent routes and areas on the map.
        */
       @Override
       public void onMapReady(GoogleMap googleMap) {
   
           // Add polylines to the map.
           // Polylines are useful to show a route or some other connection between points.
           Polyline polyline1 = googleMap.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)));
   
           // Position the map's camera near Alice Springs in the center of Australia,
           // and set the zoom factor so most of Australia shows on the screen.
           googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(-23.684, 133.903), 4));
   
           // Set listeners for click events.
           googleMap.setOnPolylineClickListener(this);
           googleMap.setOnPolygonClickListener(this);
       }
   PolyActivity.java

   Kotlin

   class PolyActivity : AppCompatActivity(), OnMapReadyCallback, OnPolylineClickListener, OnPolygonClickListener {
   
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
   
           // Retrieve the content view that renders the map.
           setContentView(R.layout.activity_maps)
   
           // Get the SupportMapFragment and request notification when the map is ready to be used.
           val mapFragment = supportFragmentManager
               .findFragmentById(R.id.map) as SupportMapFragment?
           mapFragment?.getMapAsync(this)
       }
   
       /**
        * Manipulates the map when it's available.
        * The API invokes this callback when the map is ready to be used.
        * This is where we can add markers or lines, add listeners or move the camera.
        * In this tutorial, we add polylines and polygons to represent routes and areas on the map.
        */
       override fun onMapReady(googleMap: GoogleMap) {
   
           // Add polylines to the map.
           // Polylines are useful to show a route or some other connection between points.
           val polyline1 = googleMap.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)))
   
           // Position the map's camera near Alice Springs in the center of Australia,
           // and set the zoom factor so most of Australia shows on the screen.
           googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(LatLng(-23.684, 133.903), 4f))
   
           // Set listeners for click events.
           googleMap.setOnPolylineClickListener(this)
           googleMap.setOnPolygonClickListener(this)
       }
   PolyActivity.kt

Haritada çizgi çizmek için çoklu çizgi ekleme

Polyline, birbirine bağlı çizgi parçalarından oluşan bir seridir. Çoklu çizgiler, haritadaki konumlar arasındaki rotaları, yolları veya diğer bağlantıları göstermek için kullanışlıdır.

1. PolylineOptions nesnesi oluşturun ve buna nokta ekleyin. Her nokta, haritada bir konumu temsil eder. Bu konumu, enlem ve boylam değerlerini içeren bir LatLng nesnesiyle tanımlarsınız. Aşağıdaki kod örneği, 6 noktalı bir çoklu çizgi oluşturur.

2. Çoklu çizgiyi haritaya eklemek için GoogleMap.addPolyline() numaralı telefonu arayın.

   Java

   Polyline polyline1 = googleMap.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)));
   PolyActivity.java

   Kotlin

   val polyline1 = googleMap.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)))
   PolyActivity.kt

Çoklu çizgi üzerindeki tıklama etkinliklerini işlemek istiyorsanız çoklu çizginin clickable seçeneğini true olarak ayarlayın. Bu eğitimin ilerleyen bölümlerinde etkinlik işleme hakkında daha fazla bilgi verilmektedir.

Çoklu çizgiyle rastgele verileri depolama

Çoklu çizgiler ve diğer geometri nesneleriyle rastgele veri nesnelerini depolayabilirsiniz.

1. Çoklu çizgiyle bir veri nesnesi depolamak için Polyline.setTag() işlevini çağırın. Aşağıdaki kod, bir çoklu çizgi türünü belirten rastgele bir etiketi (A) tanımlar.

   Java

   Polyline polyline1 = googleMap.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)));
   // Store a data object with the polyline, used here to indicate an arbitrary type.
   polyline1.setTag("A");

   Kotlin

   val polyline1 = googleMap.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)))
   // Store a data object with the polyline, used here to indicate an arbitrary type.
   polyline1.tag = "A

2. Bir sonraki bölümde gösterildiği gibi, Polyline.getTag() kullanarak verileri alın.

Çoklu çizginize özel stil ekleme

PolylineOptions nesnesinde çeşitli stil özellikleri belirtebilirsiniz. Stil seçenekleri arasında kontur rengi, kontur genişliği, kontur deseni, birleştirme türleri, başlangıç ve bitiş kapakları yer alır. Belirli bir özelliği belirtmezseniz API, bu özellik için varsayılan bir değer kullanır.

Aşağıdaki kod, çizginin sonuna yuvarlak bir uç, çoklu çizginin türüne bağlı olarak farklı bir başlangıç ucu uygular. Tür, çoklu çizgi için veri nesnesinde depolanan rastgele bir özelliktir. Örnekte ayrıca bir çizgi genişliği, çizgi rengi ve birleştirme türü belirtilir:

Java

private static final int COLOR_BLACK_ARGB = 0xff000000;
private static final int POLYLINE_STROKE_WIDTH_PX = 12;

/**
 * Styles the polyline, based on type.
 * @param polyline The polyline object that needs styling.
 */
private void stylePolyline(Polyline polyline) {
    String type = "";
    // Get the data object stored with the polyline.
    if (polyline.getTag() != null) {
        type = polyline.getTag().toString();
    }

    switch (type) {
        // If no type is given, allow the API to use the default.
        case "A":
            // Use a custom bitmap as the cap at the start of the line.
            polyline.setStartCap(
                    new CustomCap(
                            BitmapDescriptorFactory.fromResource(R.drawable.ic_arrow), 10));
            break;
        case "B":
            // Use a round cap at the start of the line.
            polyline.setStartCap(new RoundCap());
            break;
    }

    polyline.setEndCap(new RoundCap());
    polyline.setWidth(POLYLINE_STROKE_WIDTH_PX);
    polyline.setColor(COLOR_BLACK_ARGB);
    polyline.setJointType(JointType.ROUND);
}
PolyActivity.java

Kotlin

private val COLOR_BLACK_ARGB = -0x1000000
private val POLYLINE_STROKE_WIDTH_PX = 12

/**
 * Styles the polyline, based on type.
 * @param polyline The polyline object that needs styling.
 */
private fun stylePolyline(polyline: Polyline) {
    // Get the data object stored with the polyline.
    val type = polyline.tag?.toString() ?: ""
    when (type) {
        "A" -> {
            // Use a custom bitmap as the cap at the start of the line.
            polyline.startCap = CustomCap(
                BitmapDescriptorFactory.fromResource(R.drawable.ic_arrow), 10f)
        }
        "B" -> {
           // Use a round cap at the start of the line.
            polyline.startCap = RoundCap()
        }
    }
    polyline.endCap = RoundCap()
    polyline.width = POLYLINE_STROKE_WIDTH_PX.toFloat()
    polyline.color = COLOR_BLACK_ARGB
    polyline.jointType = JointType.ROUND
}
PolyActivity.kt

Yukarıdaki kod, A türü çoklu çizginin başlangıç ucu için özel bir bit eşlem belirtir ve 10 piksellik bir referans kontur genişliği belirtir. API, referans kontur genişliğine göre bit eşlemi ölçeklendirir. Referans kontur genişliğini belirtirken, görüntünün orijinal boyutunda, bit eşlem görüntüyü tasarlarken kullandığınız genişliği girin. İpucu: Bit eşlem resminizi bir resim düzenleyicide% 100 yakınlaştırmayla açın ve çizgi konturunun istediğiniz genişliğini resme göre belirleyin.

Çizgi uçları ve şekilleri özelleştirmeye yönelik diğer seçenekler hakkında daha fazla bilgi edinin.

Çoklu çizgi üzerindeki tıklama etkinliklerini işleme

1. Polyline.setClickable() işlevini çağırarak çoklu çizginin tıklanabilir olmasını sağlayın. (Varsayılan olarak, çoklu çizgiler tıklanabilir değildir ve kullanıcı bir çoklu çizmeye dokunduğunda uygulamanız bildirim almaz.)

2. OnPolylineClickListener arayüzünü uygulayın ve haritada dinleyiciyi ayarlamak için GoogleMap.setOnPolylineClickListener() çağrısı yapın:

   Java

   public class PolyActivity extends AppCompatActivity
           implements
                   OnMapReadyCallback,
                   GoogleMap.OnPolylineClickListener,
                   GoogleMap.OnPolygonClickListener {
   
       @Override
       protected void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
   
           // Retrieve the content view that renders the map.
           setContentView(R.layout.activity_maps);
   
           // Get the SupportMapFragment and request notification when the map is ready to be used.
           SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                   .findFragmentById(R.id.map);
           mapFragment.getMapAsync(this);
       }
   
       /**
        * Manipulates the map when it's available.
        * The API invokes this callback when the map is ready to be used.
        * This is where we can add markers or lines, add listeners or move the camera.
        * In this tutorial, we add polylines and polygons to represent routes and areas on the map.
        */
       @Override
       public void onMapReady(GoogleMap googleMap) {
   
           // Add polylines to the map.
           // Polylines are useful to show a route or some other connection between points.
           Polyline polyline1 = googleMap.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)));
   
           // Position the map's camera near Alice Springs in the center of Australia,
           // and set the zoom factor so most of Australia shows on the screen.
           googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(new LatLng(-23.684, 133.903), 4));
   
           // Set listeners for click events.
           googleMap.setOnPolylineClickListener(this);
           googleMap.setOnPolygonClickListener(this);
       }
   PolyActivity.java

   Kotlin

   class PolyActivity : AppCompatActivity(), OnMapReadyCallback, OnPolylineClickListener, OnPolygonClickListener {
   
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
   
           // Retrieve the content view that renders the map.
           setContentView(R.layout.activity_maps)
   
           // Get the SupportMapFragment and request notification when the map is ready to be used.
           val mapFragment = supportFragmentManager
               .findFragmentById(R.id.map) as SupportMapFragment?
           mapFragment?.getMapAsync(this)
       }
   
       /**
        * Manipulates the map when it's available.
        * The API invokes this callback when the map is ready to be used.
        * This is where we can add markers or lines, add listeners or move the camera.
        * In this tutorial, we add polylines and polygons to represent routes and areas on the map.
        */
       override fun onMapReady(googleMap: GoogleMap) {
   
           // Add polylines to the map.
           // Polylines are useful to show a route or some other connection between points.
           val polyline1 = googleMap.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)))
   
           // Position the map's camera near Alice Springs in the center of Australia,
           // and set the zoom factor so most of Australia shows on the screen.
           googleMap.moveCamera(CameraUpdateFactory.newLatLngZoom(LatLng(-23.684, 133.903), 4f))
   
           // Set listeners for click events.
           googleMap.setOnPolylineClickListener(this)
           googleMap.setOnPolygonClickListener(this)
       }
   PolyActivity.kt

3. onPolylineClick() geri çağırma yöntemini geçersiz kılın. Aşağıdaki örnekte, kullanıcı çoklu çizgiye her tıkladığında çizginin kontur deseni düz ve noktalı arasında değişir:

   Java

   private static final int PATTERN_GAP_LENGTH_PX = 20;
   private static final PatternItem DOT = new Dot();
   private static final PatternItem GAP = new Gap(PATTERN_GAP_LENGTH_PX);
   
   // Create a stroke pattern of a gap followed by a dot.
   private static final List<PatternItem> PATTERN_POLYLINE_DOTTED = Arrays.asList(GAP, DOT);
   
   /**
    * Listens for clicks on a polyline.
    * @param polyline The polyline object that the user has clicked.
    */
   @Override
   public void onPolylineClick(Polyline polyline) {
       // Flip from solid stroke to dotted stroke pattern.
       if ((polyline.getPattern() == null) || (!polyline.getPattern().contains(DOT))) {
           polyline.setPattern(PATTERN_POLYLINE_DOTTED);
       } else {
           // The default pattern is a solid stroke.
           polyline.setPattern(null);
       }
   
       Toast.makeText(this, "Route type " + polyline.getTag().toString(),
               Toast.LENGTH_SHORT).show();
   }
   PolyActivity.java

   Kotlin

   private val PATTERN_GAP_LENGTH_PX = 20
   private val DOT: PatternItem = Dot()
   private val GAP: PatternItem = Gap(PATTERN_GAP_LENGTH_PX.toFloat())
   
   // Create a stroke pattern of a gap followed by a dot.
   private val PATTERN_POLYLINE_DOTTED = listOf(GAP, DOT)
   
   /**
    * Listens for clicks on a polyline.
    * @param polyline The polyline object that the user has clicked.
    */
   override fun onPolylineClick(polyline: Polyline) {
       // Flip from solid stroke to dotted stroke pattern.
       if (polyline.pattern == null || !polyline.pattern!!.contains(DOT)) {
           polyline.pattern = PATTERN_POLYLINE_DOTTED
       } else {
           // The default pattern is a solid stroke.
           polyline.pattern = null
       }
       Toast.makeText(this, "Route type " + polyline.tag.toString(),
           Toast.LENGTH_SHORT).show()
   }
   PolyActivity.kt

Haritada alanları temsil etmek için poligonlar ekleme

Polygon, Polyline'a benzer şekilde, sıralı bir dizideki bir dizi koordinattan oluşan bir şekildir. Aradaki fark, poligonun doldurulabilir bir iç alanla kapalı bir alanı tanımlaması, çoklu çizginin ise açık uçlu olmasıdır.

1. PolygonOptions nesnesi oluşturun ve buna nokta ekleyin. Her nokta, haritada bir konumu temsil eder. Bu konumu, enlem ve boylam değerlerini içeren bir LatLng nesnesiyle tanımlarsınız. Aşağıdaki kod örneği, 4 noktalı bir poligon oluşturur.

2. Polygon.setClickable() işlevini çağırarak poligonu tıklanabilir hale getirin. (Varsayılan olarak, çokgenler tıklanabilir değildir ve kullanıcı bir çokgene dokunduğunda uygulamanız bildirim almaz.) Çokgen tıklama etkinliklerini işleme, bu eğitimin önceki bölümlerinde açıklanan çok çizgilerdeki etkinlikleri işlemeye benzer.

3. Poligonu haritaya eklemek için GoogleMap.addPolygon() numaralı telefonu arayın.

4. Bir veri nesnesini çokgenle birlikte depolamak için Polygon.setTag() işlevini çağırın. Aşağıdaki kod, poligon için rastgele bir tür (alpha) tanımlar.

   Java

   // Add polygons to indicate areas on the map.
   Polygon polygon1 = googleMap.addPolygon(new PolygonOptions()
           .clickable(true)
           .add(
                   new LatLng(-27.457, 153.040),
                   new LatLng(-33.852, 151.211),
                   new LatLng(-37.813, 144.962),
                   new LatLng(-34.928, 138.599)));
   // Store a data object with the polygon, used here to indicate an arbitrary type.
   polygon1.setTag("alpha");
   PolyActivity.java

   Kotlin

   // Add polygons to indicate areas on the map.
   val polygon1 = googleMap.addPolygon(PolygonOptions()
       .clickable(true)
       .add(
           LatLng(-27.457, 153.040),
           LatLng(-33.852, 151.211),
           LatLng(-37.813, 144.962),
           LatLng(-34.928, 138.599)))
   // Store a data object with the polygon, used here to indicate an arbitrary type.
   polygon1.tag = "alpha"
   // Style the polygon.
   PolyActivity.kt

Poligonunuza özel stil ekleme

PolygonOptions nesnesinde bir dizi stil özelliği belirtebilirsiniz. Stil seçenekleri arasında kontur rengi, kontur genişliği, kontur deseni, kontur birleştirme türleri ve dolgu rengi bulunur. Belirli bir özelliği belirtmezseniz API, bu özellik için varsayılan bir değer kullanır.

Aşağıdaki kod, poligonun türüne bağlı olarak belirli renkler ve kontur desenleri uygular. Tür, poligonun veri nesnesinde depolanan rastgele bir özelliktir:

Java

private static final int COLOR_WHITE_ARGB = 0xffffffff;
private static final int COLOR_DARK_GREEN_ARGB = 0xff388E3C;
private static final int COLOR_LIGHT_GREEN_ARGB = 0xff81C784;
private static final int COLOR_DARK_ORANGE_ARGB = 0xffF57F17;
private static final int COLOR_LIGHT_ORANGE_ARGB = 0xffF9A825;

private static final int POLYGON_STROKE_WIDTH_PX = 8;
private static final int PATTERN_DASH_LENGTH_PX = 20;
private static final PatternItem DASH = new Dash(PATTERN_DASH_LENGTH_PX);

// Create a stroke pattern of a gap followed by a dash.
private static final List<PatternItem> PATTERN_POLYGON_ALPHA = Arrays.asList(GAP, DASH);

// Create a stroke pattern of a dot followed by a gap, a dash, and another gap.
private static final List<PatternItem> PATTERN_POLYGON_BETA =
    Arrays.asList(DOT, GAP, DASH, GAP);

/**
 * Styles the polygon, based on type.
 * @param polygon The polygon object that needs styling.
 */
private void stylePolygon(Polygon polygon) {
    String type = "";
    // Get the data object stored with the polygon.
    if (polygon.getTag() != null) {
        type = polygon.getTag().toString();
    }

    List<PatternItem> pattern = null;
    int strokeColor = COLOR_BLACK_ARGB;
    int fillColor = COLOR_WHITE_ARGB;

    switch (type) {
        // If no type is given, allow the API to use the default.
        case "alpha":
            // Apply a stroke pattern to render a dashed line, and define colors.
            pattern = PATTERN_POLYGON_ALPHA;
            strokeColor = COLOR_DARK_GREEN_ARGB;
            fillColor = COLOR_LIGHT_GREEN_ARGB;
            break;
        case "beta":
            // Apply a stroke pattern to render a line of dots and dashes, and define colors.
            pattern = PATTERN_POLYGON_BETA;
            strokeColor = COLOR_DARK_ORANGE_ARGB;
            fillColor = COLOR_LIGHT_ORANGE_ARGB;
            break;
    }

    polygon.setStrokePattern(pattern);
    polygon.setStrokeWidth(POLYGON_STROKE_WIDTH_PX);
    polygon.setStrokeColor(strokeColor);
    polygon.setFillColor(fillColor);
}
PolyActivity.java

Kotlin

private val COLOR_WHITE_ARGB = -0x1
private val COLOR_DARK_GREEN_ARGB = -0xc771c4
private val COLOR_LIGHT_GREEN_ARGB = -0x7e387c
private val COLOR_DARK_ORANGE_ARGB = -0xa80e9
private val COLOR_LIGHT_ORANGE_ARGB = -0x657db
private val POLYGON_STROKE_WIDTH_PX = 8
private val PATTERN_DASH_LENGTH_PX = 20

private val DASH: PatternItem = Dash(PATTERN_DASH_LENGTH_PX.toFloat())

// Create a stroke pattern of a gap followed by a dash.
private val PATTERN_POLYGON_ALPHA = listOf(GAP, DASH)

// Create a stroke pattern of a dot followed by a gap, a dash, and another gap.
private val PATTERN_POLYGON_BETA = listOf(DOT, GAP, DASH, GAP)

/**
 * Styles the polygon, based on type.
 * @param polygon The polygon object that needs styling.
 */
private fun stylePolygon(polygon: Polygon) {
    // Get the data object stored with the polygon.
    val type = polygon.tag?.toString() ?: ""
    var pattern: List<PatternItem>? = null
    var strokeColor = COLOR_BLACK_ARGB
    var fillColor = COLOR_WHITE_ARGB
    when (type) {
        "alpha" -> {
            // Apply a stroke pattern to render a dashed line, and define colors.
            pattern = PATTERN_POLYGON_ALPHA
            strokeColor = COLOR_DARK_GREEN_ARGB
            fillColor = COLOR_LIGHT_GREEN_ARGB
        }
        "beta" -> {
            // Apply a stroke pattern to render a line of dots and dashes, and define colors.
            pattern = PATTERN_POLYGON_BETA
            strokeColor = COLOR_DARK_ORANGE_ARGB
            fillColor = COLOR_LIGHT_ORANGE_ARGB
        }
    }
    polygon.strokePattern = pattern
    polygon.strokeWidth = POLYGON_STROKE_WIDTH_PX.toFloat()
    polygon.strokeColor = strokeColor
    polygon.fillColor = fillColor
}
PolyActivity.kt

Kontur desenleri ve şekilleri özelleştirmeye yönelik diğer seçenekler hakkında daha fazla bilgi edinin.

Tebrikler! Haritadaki alanları temsil eden poligonlar ve konumlar arasındaki rotaları veya diğer bağlantıları temsil eden çoklu çizgiler içeren bir Google Haritası'nın yer aldığı bir Android uygulaması geliştirdiniz. Ayrıca Android için Haritalar SDK'sını nasıl kullanacağınızı da öğrendiniz.

Sonraki adımlar

Daire nesnesi hakkında bilgi edinin. Daireler poligonlara benzer ancak dairenin şeklini yansıtan özelliklere sahiptir.