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

Platform seçin: Android iOS

Haritalarınıza ekleyebileceğiniz gelişmiş özellikler mi arıyorsunuz? Android için Haritalar SDK'sı Yardımcı Kitaplığı, çeşitli uygulamalar için yararlı olan sınıflardan oluşan açık kaynak bir kitaplıktı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, yardımcı program kitaplığını ele alıyor. Özellikle çoklu çizgi kod çözme, küresel geometri ve balon simgelerine odaklanıyor.

Hızlı kurulum

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

Yardımcı programlar

GeoJSON katmanı içeren bir harita

GeoJSON'u haritanıza aktarma

Öğeleri GeoJSON biçiminde saklayabilir ve bu yardımcı programı kullanarak haritanın üzerine katman olarak oluşturabilirsiniz. GeoJSON verilerinizi haritaya eklemek için addLayer() numaralı telefonu arayın. Ayrıca addFeature() işlevini çağırarak ve GeoJsonFeature nesnesi göndererek tek tek özellikler de ekleyebilirsiniz.

Ayrıntılar için Google Haritalar Android GeoJSON Utility ile ilgili dokümanları inceleyin.

KML katmanı içeren bir harita

KML'yi haritanıza aktarma

Bu yardımcı programı kullanarak KML nesnelerini coğrafi şekillere dönüştürebilir ve haritanın üstünde bir katman olarak oluşturabilirsiniz. Katmanınızı haritaya eklemek için addLayerToMap() işlevini çağırın. Herhangi bir yer işareti, yer paylaşımı, doküman veya klasörde getProperties()'yi çağırarak KML nesnesinde mülklere erişebilirsiniz.

Ayrıntılar için Google Haritalar Android KML Utility ile ilgili dokümanları inceleyin.

Isı haritası içeren bir harita

Haritanıza ısı haritası ekleme

Isı haritaları, izleyicilerin haritada veri noktalarının dağılımını ve göreceli yoğunluğunu anlamasını kolaylaştırır. Isı haritaları, her konuma bir işaretçi yerleştirmek yerine verilerin dağılımını temsil etmek için renk ve şekil kullanır. Haritadaki önemli yerleri temsil eden bir LatLng nesnesi koleksiyonu ile bir 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.

Ayrıntılar için Google Haritalar Android Isıtma Haritası Yardımcı Programı ile ilgili dokümanları inceleyin.

Baloncuk simgelerinin yer aldığı bir harita

Balon simgeleri aracılığıyla işaretçileri özelleştirme

İşaretçilerinizde bilgi snippet'leri görüntülemek için IconGenerator ekleyin. Bu yardımcı program, işaretçi simgelerinizi bilgi pencerelerine benzetmenize olanak tanır. Bu sayede, işaretçi metin ve diğer içerikler içerebilir. Bunun avantajı, aynı anda birden fazla işaretçiyi açık tutabilmenizdir. Bilgi pencereleri ise aynı anda yalnızca bir tane açık olabilir. Ayrıca işaretçilere stil uygulayabilir, işaretçinin ve/veya içeriğin yönünü değiştirebilir ve işaretçinin arka plan resmini/dokuzlu yama'yı değiştirebilirsiniz.

Kümelenmiş işaretçiler içeren bir harita

İşaretçi kümelerini yönetme

ClusterManager, farklı yakınlaştırma düzeylerinde birden fazla işaretçiyi yönetmenize yardımcı olur. Bu sayede, haritanın okunmasını zorlaştırmadan haritaya çok sayıda işaretçi ekleyebilirsiniz. Kullanıcı haritayı yüksek bir yakınlaştırma düzeyinde görüntülediğinde, işaretçiler ayrı ayrı gösterilir. Kullanıcı daha düşük bir yakınlaştırma düzeyine gittiğinde, haritayı daha kolay görüntülemek için işaretçiler kümeler halinde toplanır.

Ayrıntılar için Google Haritalar Android İşaretçi Kümeleme Yardımcı Programı ile ilgili dokümanları inceleyin.

Birden çok katmanı olan bir harita

Aynı haritaya birden fazla katman ekleme

GeoJSON, KML ve kümelerdeki özelliklerin yanı sıra kendi işaretçilerinizi, poli çizgilerinizi ve poligonlarınızı da aynı haritada gösterebilirsiniz. Bu katmanlar, her katmana bir tıklama dinleyici ekleyerek de etkileşimli hale getirilebilir. MarkerManager, GroundOverlayManager, PolygonManager ve PolylineManager sınıflarını oluşturmanız ve bunları oluşturduğunuzda GeoJsonLayer, KmlLayer, ClusterManager sınıflarının yapıcılarına iletmeniz yeterlidir. Ardından, haritaya kendi işaretçilerinizi, poli çizgilerinizi ve poligonlarınızı 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 belgelere bakın.

Kodlanmış bir çoklu çizgi içeren bir harita

Çoklu çizgileri kodlama ve kod çözme

PolyUtil, kodlanmış çoklu çizgileri ve poligonları enlem/boylam koordinatlarına ve tam tersini dönüştürmek için yararlıdır.

Google Haritalar'da, bir çok çizgiyi veya poligonu tanımlayan enlem ve boylam koordinatları kodlanmış bir dize olarak saklanır. Poli çizgisi kodlamasının ayrıntılı açıklamasını inceleyin. Bu kodlanmış dizeyi, Directions API (eski) gibi bir Google API'den gelen yanıtta alabilirsiniz.

Android Utility Library için Haritalar SDK'sındaki PolyUtil işlevini kullanarak bir enlem/boylam koordinatı dizisini ("LatLngs") kodlanmış bir yol dizesi olarak kodlayabilir ve kodlanmış bir yol dizesinin kodunu LatLngs dizisi olarak çözebilirsiniz. Bu, Google Haritalar API'leri web hizmetleriyle birlikte çalışabilirliği sağlar.

Haritada iki nokta arasındaki hesaplanan mesafe

Küresel geometri aracılığıyla mesafeleri, alanları ve yönleri hesaplama

SphericalUtil'teki küresel geometri yardımcı programlarını kullanarak enlemlere 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 azimutu (derece cinsinden) döndürür.
  • computeArea(): Dünya'daki kapalı bir yolun metrekare cinsinden alanını döndürür.
  • interpolate(): İki belirli nokta arasındaki mesafenin belirli bir kesri üzerinde bulunan bir noktanın enlem/boylam koordinatlarını döndürür. Örneğin, iki nokta arasında bir işaretçiyi animasyonlu olarak hareket ettirmek için bu özelliği kullanabilirsiniz.

Yardımcı programdaki yöntemlerin tam listesi için referans dokümanlarına bakın.

Bir konumun Street View'da 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 sağlar. Bu meta veri yardımcı programını çağırarak ve yalnızca yanıt OK ise bir Android uygulamasına Street View panoraması eklerken hatalardan kaçınabilirsiniz.

Ayrıntılar için GitHub'daki Street View meta veri yardımcı programı dokümanlarına bakın.