Android için Haritalar SDK'sı v3.1.0 BETA'yı kullanma

Android için Haritalar SDK'sının 3.1.0 beta sürümü, önceki sürümle aynı API yüzeyine sahip yeni bir uygulamadır (tüm sınıflar ve yöntemler aynı kalır) ve deneyebileceğiniz bazı yeni özellikler:

  • Haritalar'ı özelleştirme
  • İşaretçi çarpışması kontrolü
  • Çoklu çizgi özelleştirme

Bu kılavuzda, yeni özelliklerin nasıl kullanılacağı gösterilmektedir.

Google Haritalar'ı özelleştirme (beta)

bulut tabanlı harita stilleri, haritalarınızın stil özelliklerini daha kolay özelleştirmenizi ve yönetmenizi sağlayan çeşitli araçlar ve özellikler sunar. Haritalar API'lerini ve SDK'larını kullanarak haritanızı kod halinde biçimlendirmek yerine, Google Cloud Console'da haritalarınızı yönetebilir ve biçimlendirebilirsiniz. Daha fazla bilgi için Android Haritası Özelleştirmeye Genel Bakış bölümüne bakın.

İşaretçi çakışmasını giderme (beta)

Özel işaretçilerin, bir çakışma olduğunda varsayılan temel harita etiketlerini geçersiz kılıp kılmayacağını ve özel işaretçiler arasındaki göreli önceliği belirtip göstermeyeceğini belirtebilirsiniz. Daha fazla bilgi için İşaretçi Çakışması Yönetimi (Android) konusuna bakın.

Çoklu Çizgi Özelleştirme (beta)

Artık Çoklu çizgilerin görünümünü özelleştirmenin birkaç yeni yolu var:

  • Çok renkli çoklu çizgiler, çoklu çizgi segmentlerini farklı renklere ayarlar.
  • Gradyan çoklu çizgileri, iki renkten oluşan bir gradyan kullanarak bir çoklu çizgiyi renklendirir.
  • Sabitlenmiş çoklu çizgiler, tekrarlanan bit eşlemleri kullanarak çoklu çizgiyi biçimlendirir.

Çok renkli çoklu çizgi oluşturma

Bir çoklu çizginin segmentlerini tek tek renklendirmek için StyleSpan nesneleri oluşturup addSpan() veya addSpans() yöntemlerini kullanarak bunları PolylineOptions öğesine ekleyerek kapsamları kullanabilirsiniz. Dizideki her öğe, varsayılan olarak karşılık gelen çizgi segmentinin rengini belirler. Aşağıdaki örnekte, kırmızı ve yeşil segmentleri olan bir çoklu çizgi oluşturmak için segment renklerini ayarlama işlemi gösterilmektedir:

Kotlin



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

Java


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)));

Gradyan çoklu çizgisi oluşturma

Fırçanın başlangıç ve bitiş renklerini belirtmek için iki adet 32 bit alfa-kırmızı-yeşil-mavi (ARGB) tam sayı belirterek renk geçişi tanımlayabilirsiniz. PolylineOptions.addSpan() yöntemini çağırarak şeklin seçenekler nesnesinde bu özelliği ayarlayın. Aşağıdaki örnekte, Woodland Park Hayvanat Bahçesi'nden Kirkland, WA'ya kırmızıdan sarıya gradyan bir çoklu çizgi oluşturma gösterilmektedir.

Kotlin



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()
            )
        )
)

Java


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())));

Damgalı çoklu çizgi oluşturma

Çoklu çizginin görünümünü tekrarlanan bit eşlem dokusu olarak ayarlayabilirsiniz. Bunu yapmak için TextureStyle içinde bir StampStyle oluşturun ve ardından burada gösterildiği gibi PolylineOptions.addSpan() yöntemini çağırarak şeklin seçenekler nesnesinde bu özelliği ayarlayın:

Kotlin



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)
)

Java


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));

Beta uyumlu yardımcı program kitaplığını içe aktarma

Google Haritalar Android API yardımcı programı kitaplığını kullanıyorsanız, mevcut sürümü beta uyumlu sürümle değiştirmek için aşağıdakileri yaparak proje bağımlılıklarınızı da güncellemeniz gerekir:

  1. Beta uyumlu util kitaplığını build.gradle dosyanıza aktarın: 
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. Beta ile uyumlu olmayan yardımcı program kitaplığını kaldırmak için aşağıdaki kodu build.gradle cihazınızdan kaldırın: 
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

Örnekleri çalıştırma

GitHub'daki Google Samples deposu, Android için 3.1.0 Beta Haritalar SDK'sının kullanımını gösteren örnek uygulamaları içerir.