Android Yardımcı Program Kitaplığı için Haritalar SDK'sı

Platform seçin: Android iOS

Haritalarınıza eklemek için gelişmiş özellikler mi arıyorsunuz? Android Yardımcı Program Kitaplığı için Haritalar SDK'sı, çeşitli uygulamalarda faydalı olabilecek açık kaynaklı bir sınıf kitaplığıdır. GitHub deposunda yardımcı program sınıfları ve her sınıfın kullanımını gösteren bir demo uygulaması bulunur.

Bu videoda Chris Broadfoot, çoklu çizgi kod çözme, küresel geometri ve balon simgelerine odaklanarak yardımcı program kitaplığını tartışıyor.

Hızlı kurulum

Android için Haritalar SDK'sı Yardımcı Program Kitaplığı'nı yüklemek için kurulum kılavuzundaki talimatları uygulayın.

Yardımcı programlar

GeoJSON katmanına sahip bir harita

Haritanıza GeoJSON aktarma

Özellikleri GeoJSON biçiminde depolayabilir ve bu yardımcı program ile haritanın üzerinde bir katman oluşturabilirsiniz. GeoJSON verilerinizi haritaya eklemek için addLayer() numaralı telefonu arayın. Bir GeoJsonFeature nesnesini ileterek addFeature() yöntemini çağırarak özellikleri ayrı ayrı da ekleyebilirsiniz.

Ayrıntılar için Google Haritalar Android GeoJSON Utility belgelerine bakın.

KML katmanı içeren bir harita

Haritanıza KML'yi aktarma

Bu yardımcı programı kullanarak, KML nesnelerini coğrafi şekillere dönüştürebilir ve haritanın üzerinde katman olarak oluşturabilirsiniz. Katmanınızı haritaya eklemek için addLayerToMap() numaralı telefonu arayın. Herhangi bir Yer İşareti, GroundOverlay, Doküman veya Klasör üzerinde getProperties() yöntemini çağırarak bir KML nesnesindeki özelliklere erişebilirsiniz.

Ayrıntılar için Google Haritalar Android KML Yardımcı Programı'ndaki dokümanlara bakın.

Isı haritalı bir harita

Haritanıza ısı haritaları ekleyin

Isı haritaları, izleyicilerin haritadaki veri noktalarının dağılımını ve göreli yoğunluğunu anlamasını kolaylaştırır. Isı haritaları, verilerin dağılımını göstermek için her konuma işaretçi yerleştirmek yerine renk ve şekil kullanır. Haritada önemli yerleri temsil eden LatLng nesne koleksiyonunu göndererek bir HeatmapTileProvider oluşturun. Ardından, yeni bir TileOverlay oluşturup bunu ısı haritası kutusu sağlayıcısına iletin ve karo yer paylaşımını haritaya ekleyin.

Ayrıntılar için Google Haritalar Android Isı Haritası Yardımcı Programı'ndaki dokümanlara bakın.

Balon simgeleri bulunan bir harita

Baloncuk simgeleriyle işaretçileri özelleştirin

İşaretçilerinizde bilgi snippet'leri görüntülemek için bir IconGenerator ekleyin. Bu yardımcı program, işaretçi simgelerinizin metin ve başka içerikler barındırabileceğinden, bilgi pencereleri gibi görünmesini sağlamak için bir yol sağlar. Bunun avantajı, aynı anda birden fazla işaretçiyi açık tutabilmeniz ve aynı anda yalnızca bir bilgi penceresinin açılabilmesidir. Ayrıca, işaretçilerin stilini belirleyebilir, işaretçinin ve/veya içeriğin yönünü ve işaretçinin arka plan resmini/dokuz yamasını değiştirebilirsiniz.

Kümelenmiş işaretçileri olan bir harita

İşaretçi kümelerini yönet

ClusterManager, birden fazla işaretçiyi farklı yakınlaştırma düzeylerinde yönetmenize yardımcı olur. Yani, okunmasını zorlaştırmadan haritaya çok sayıda işaretçi yerleştirebilirsiniz. Kullanıcı haritayı yüksek bir yakınlaştırma düzeyinde görüntülediğinde, harita üzerinde tek tek işaretçiler gösterilir. Kullanıcı daha düşük bir yakınlaştırma düzeyine kadar uzaklaştırdığında işaretçiler, haritayı daha kolay görüntülemek için kümeler halinde toplanır.

Ayrıntılar için Google Haritalar Android İşaretçi Kümeleme Yardımcı Programı'ndaki dokümanlara bakın.

Çok katmanlı bir harita

Aynı haritaya birden fazla katman ekleme

GeoJSON, KML ve kümelerdeki özelliklerin yanı sıra kendi işaretçileriniz, çoklu çizgileriniz ve poligonlarınızı da aynı haritada gösterebilirsiniz. Bu katmanlar, her bir katmana tıklama işleyici eklenerek de etkileşimli hale getirilebilir. MarkerManager, GroundOverlayManager, PolygonManager ve PolylineManager sınıflarını örneklendirmeniz ve oluşturduğunuz bunları GeoJsonLayer, KmlLayer, ClusterManager oluşturucularına iletmeniz yeterlidir. Ardından, kendi işaretçilerinizi, çoklu çizgilerinizi ve poligonlarınızı haritaya eklemek için doğrudan yukarıdaki Manager sınıflarını kullanabilirsiniz.

Ayrıntılar için Google Haritalar Android Çok Katmanlı Demo'daki dokümanları inceleyin.

Kodlanmış çoklu çizgiye sahip bir harita

Çoklu çizgileri kodlama ve kodu çözme

PolyUtil, kodlanmış çoklu çizgileri ve poligonları enlem/boylam koordinatlarına (veya tersi) dönüştürmek için kullanışlıdır.

Google Haritalar'da bir çoklu çizgiyi veya poligonu tanımlayan enlem ve boylam koordinatları, kodlanmış dize olarak saklanır. Çoklu çizgi kodlamasının ayrıntılı açıklamasına bakın. Bu kodlanmış dizeyi Directions API gibi bir Google API'sinden gelen yanıtta alabilirsiniz.

Bir enlem/boylam koordinatları dizisini kodlanmış yol dizesine ("EnlLngs") kodlamak ve kodlanmış yol dizesinin kodunu LatLngs dizisine dönüştürmek için Android Utility Kitaplığı için Haritalar SDK'sında PolyUtil kullanabilirsiniz. Bu, Google Haritalar API'leri web hizmetleriyle birlikte çalışabilirlik sağlar.

Bir harita üzerinde iki nokta arasındaki hesaplanmış mesafe

Küresel geometri yardımıyla mesafeleri, alanları ve başlıkları hesaplayın

SphericalUtil içindeki küresel geometri yardımcı programlarını kullanarak enlem ve boylamlara dayalı mesafeleri, alanları ve başlıkları hesaplayabilirsiniz. Yardımcı programda kullanılabilecek yöntemlerden bazıları şunlardır:

  • computeDistanceBetween() – İki enlem/boylam koordinatları arasındaki mesafeyi metre cinsinden döndürür.
  • computeHeading() – İki enlem/boylam koordinatları arasındaki yatağı derece cinsinden döndürür.
  • computeArea() – Dünya üzerinde kapalı bir yolun alanını metrekare olarak döndürür.
  • interpolate() – Verilen iki nokta arasındaki mesafenin belirli bir bölümüne denk gelen bir noktanın enlem/boylam koordinatlarını döndürür. Örneğin, bunu iki nokta arasındaki bir işaretçiyi canlandırmak için kullanabilirsiniz.

Yardımcı programdaki yöntemlerin tam listesi için referans belgelerine bakın.

Street View'da bir konumun desteklenip desteklenmediğini kontrol etme

Bir konumun Street View'da desteklenip desteklenmediğini kontrol edin.

StreetViewUtil sınıfı, bir konumun Street View'da desteklenip desteklenmediğini kontrol etme işlevi sunar. Android uygulamasına Street View panoraması eklerken, bu meta veri yardımcı programını çağırıp Street View panoramasını yalnızca yanıt OK olduğunda ekleyerek hatalardan kaçınabilirsiniz.

Ayrıntılar için GitHub'daki Street View meta veri yardımcı programı kapsamındaki dokümanlara göz atın.