Android Yardımcı Program Kitaplığı için Haritalar SDK'sı
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Haritalarınıza ekleyebileceğiniz ileri seviye özellikler mi arıyorsunuz? Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sı, çeşitli uygulamalar için kullanışlı olan açık kaynaklı bir sınıf kitaplığıdır. GitHub deposu, yardımcı sınıfları ve her sınıfın kullanımını gösteren bir demo uygulamasını içerir.
Bu videoda Chris Broadfoot, çoklu çizgi kod çözme, küresel geometri ve baloncuk simgelerine odaklanarak yardımcı program kitaplığını anlatıyor.
Hızlı kurulum
Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sını yüklemek için kurulum kılavuzunu inceleyin.
Yardımcı programlar
GeoJSON'u haritanıza aktarma
Özellikleri GeoJSON biçiminde depolayabilir ve bu yardımcı programı kullanarak haritanın üzerinde katman olarak oluşturabilirsiniz.
GeoJSON verilerinizi haritaya eklemek için addLayer() yöntemini çağırın.
Ayrıca addFeature() yöntemini çağırıp bir GeoJsonFeature nesnesi ileterek özellikleri tek tek ekleyebilirsiniz.
Bu yardımcı programı kullanarak KML nesnelerini coğrafi şekillere dönüştürebilir ve haritanın üzerinde bir katman olarak oluşturabilirsiniz. Katmanınızı haritaya eklemek için addLayerToMap() yöntemini çağırın. Herhangi bir Yer İşareti, GroundOverlay, Doküman veya Klasör'de getProperties() yöntemini çağırarak KML nesnesindeki özelliklere erişebilirsiniz.
Isı haritaları, izleyicilerin haritadaki veri noktalarının dağılımını ve göreceli yoğunluğunu anlamasına yardımcı olur. Isı haritaları, her konuma bir işaretçi yerleştirmek yerine verilerin dağılımını göstermek için renk ve şekil kullanır. Haritadaki önemli yerleri temsil eden LatLng nesnelerinin bir koleksiyonunu ileterek HeatmapTileProvider oluşturun. Ardından, ısı haritası karo sağlayıcısını ileterek yeni bir TileOverlay oluşturun ve karo yer paylaşımını haritaya ekleyin.
İşaretçilerinizde bilgi snippet'leri görüntülemek için IconGenerator ekleyin. Bu yardımcı program, işaretçi simgelerinizin bilgi pencerelerine benzemesini sağlar. İşaretçinin kendisi metin ve başka içerikler barındırabilir. Aynı anda yalnızca bir bilgi penceresi açık olabilirken birden fazla işaretçiyi aynı anda açık tutabilmeniz avantaj sağlar.
Ayrıca işaretçileri stillendirebilir, işaretçinin ve/veya içeriğin yönünü değiştirebilir ve işaretçinin arka plan resmini/nine-patch'ini değiştirebilirsiniz.
İşaretçilere animasyon ekleme
Bir işaretçiyi mevcut konumundan yeni bir konuma sorunsuz bir şekilde hareket edecek şekilde animasyonlu hale getirebilirsiniz. AnimationUtil sınıfı bu özelliği sağlar. Nasıl kullanılacağına dair bir örnek için yardımcı program kitaplığının GitHub deposundaki AnimationUtilDemoActivity bölümüne bakın.
İşaretçi gruplarını yönetme
ClusterManager, farklı yakınlaştırma seviyelerinde birden fazla işaretçiyi yönetmenize yardımcı olur. Bu sayede, haritayı okunması zor hale getirmeden haritaya çok sayıda işaretçi yerleştirebilirsiniz. Kullanıcı haritayı yüksek yakınlaştırma seviyesinde görüntülerken haritada tek tek işaretçiler gösterilir. Kullanıcı daha düşük bir yakınlaştırma seviyesine uzaklaştırdığında işaretçiler, haritanın daha kolay görüntülenmesi için kümeler halinde toplanır.
GeoJSON, KML ve kümelerdeki özellikleri, kendi işaretçileriniz, çoklu çizgileriniz ve çokgenlerinizle birlikte aynı haritada gösterebilirsiniz. Ayrıca her katmana bir tıklama dinleyicisi ekleyerek bu katmanları etkileşimli hale getirebilirsiniz.
Bunun için MarkerManager, GroundOverlayManager, PolygonManager ve PolylineManager sınıflarını örneklendirin ve bunları ayarlarken GeoJsonLayer, KmlLayer ve ClusterManager sınıflarının oluşturucularına iletin. Ardından, haritaya kendi işaretçilerinizi, çoklu çizgilerinizi ve poligonlarınızı eklemek için bu Manager sınıflarını doğrudan kullanabilirsiniz.
Ayrıntılar için Google Haritalar Android Çok Katmanlı Demo ile ilgili belgelere bakın.
Çoklu çizgileri kodlama ve kodunu çözme
PolyUtil sınıfı, kodlanmış çoklu çizgileri ve çokgenleri enlem/boylam koordinatlarına, koordinatları ise kodlanmış çoklu çizgilere ve çokgenlere dönüştürür.
Google Haritalar'da, çoklu çizgi veya poligonu tanımlayan enlem ve boylam koordinatları kodlanmış bir dize olarak depolanır. Çoklu çizgi kodlaması ile ilgili ayrıntılı açıklamayı inceleyin. Bu kodlanmış dizeyi, Directions API (Eski) gibi bir Google API'sinden gelen yanıtta alabilirsiniz.
Android Yardımcı Program Kitaplığı İçin Haritalar SDK'sında PolyUtil kullanarak bir enlem/boylam koordinatları ("LatLng") dizisini kodlanmış bir yol dizesine dönüştürebilir ve kodlanmış bir yol dizesini LatLng dizisine dönüştürebilirsiniz. Bu sayede Google Haritalar API'leri web hizmetleriyle birlikte çalışabilirlik sağlanır.
Küresel geometriyle mesafeleri, alanları ve yönleri hesaplama
SphericalUtil içindeki küresel geometri yardımcı programlarını kullanarak enlem ve boylamlara göre mesafeleri, alanları ve yönleri hesaplayabilirsiniz. Yardımcı programda kullanılabilen yöntemlerden bazıları şunlardır:
computeDistanceBetween(): İki enlem/boylam koordinatı arasındaki mesafeyi metre cinsinden döndürür.
computeHeading(): İki enlem/boylam koordinatı arasındaki yönü derece cinsinden döndürür.
computeArea(): Dünya üzerindeki kapalı bir yolun alanını metrekare cinsinden döndürür.
interpolate(): Belirtilen iki nokta arasındaki mesafenin belirli bir kesrinde bulunan bir noktanın enlem/boylam koordinatlarını döndürür. Örneğin, iki nokta arasında bir işaretçiye animasyon eklemek için bu yöntemi kullanabilirsiniz.
Bir konumun Street View'da desteklenip desteklenmediğini kontrol etme
StreetViewUtil sınıfı, bir konumun Street View'da desteklenip desteklenmediğini kontrol etme işlevi sağlar. Bu meta veri yardımcı programını çağırarak ve yalnızca yanıt OK ise Street View panoraması ekleyerek Android uygulamasına Street View panoraması eklerken hata oluşmasını önleyebilirsiniz.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2026-11-04 UTC."],[],["The Maps SDK for Android Utility Library offers tools for enhancing map functionality. Key actions include importing GeoJSON and KML data, adding heatmaps, managing marker clusters, and customizing markers with bubble icons. It supports adding multiple layers, and it also allows users to encode/decode polylines and utilize spherical geometry for distance, area, and heading calculations. Additionally, users can check if a location is supported in street view. All utilities are open-source, and can be viewed with the provided demo app.\n"]]