Google Haritalar KML İçe Aktarma Yardımcı Programı

1. Giriş
2. KML katmanı ekleme
3. KML katmanını temizleme
4. KML kapsayıcılarına erişme
5. KML yer işaretlerine ve KML yer bindirmelerine erişme
6. KML özelliklerine erişim
7. KML tarafından desteklenen özellikler

Giriş

KML, XML veri biçiminin bir uzantısıdır ve harita üzerinde coğrafi verileri temsil eder. Bu yardımcı programı kullanarak KML nesnelerini coğrafi şekillere dönüştürebilir ve bunları haritanın üzerinde bir katman olarak oluşturabilirsiniz. KML verilerinizi haritaya eklemek ve haritadan kaldırmak için sırasıyla addLayerToMap() ve removeLayerFromMap() numaralı telefonu arayın. Bir KML nesnesindeki özelliklere erişmek için herhangi bir Yer İşareti, Ground oluşturacak, Belge veya Klasör'de getProperties() komutunu çağırın.

Haritaya KML katmanı eklensin

Haritaya veri katmanı eklemek için önce KmlLayer sınıfının bir örneğini oluşturun. KmlLayer örneğini iki şekilde gösterebilirsiniz.

Yerel bir kaynaktan KML veri kümesini içe aktarmak ve oluşturmak için aşağıdakilere ihtiyacınız vardır:

• Katmanın oluşturulacağı bir GoogleMap nesnesi.
• KML verilerini içeren yerel bir kaynak dosyası.
• Yerel kaynak dosyasını açmak için gerekli olan Context nesnesi.

val layer = KmlLayer(map, R.raw.geojson_file, context)

      

KmlLayer layer = new KmlLayer(map, R.raw.geojson_file, context);

      

Bir KML veri kümesini yerel bir akıştan içe aktarmak ve oluşturmak için aşağıdakilere ihtiyacınız vardır:

• Katmanın oluşturulacağı bir GoogleMap nesnesi.
• KML verilerini içeren bir InputStream.
• Yerel kaynakları açmak için gerekli olan Context nesnesi.

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

Bir KmlLayer oluşturduktan sonra, içe aktarılan verileri haritaya eklemek için addLayerToMap()() işlevini çağırın.

layer.addLayerToMap()

      

layer.addLayerToMap();

      

KML katmanını temizleme

KmlLayer adlı dosyayı sizin oluşturduğunuzu varsayalım:

val inputStream: InputStream? =  // InputStream containing KML data
val layer = KmlLayer(map, inputStream, context)

      

InputStream inputStream = // InputStream containing KML data
KmlLayer layer = new KmlLayer(map, inputStream, context);

      

Katmanı haritadan kaldırmak için removeLayerFromMap() çağrısı yapın:

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

KML kapsayıcılarına erişme

Katmanınıza eklenen kapsayıcılara erişmek için oluşturduğunuz katmanda getContainers() çağırabilirsiniz. Herhangi bir kapsayıcının iç içe yerleştirilmiş kapsayıcıları olup olmadığını kontrol etmek için hasContainers() yöntemini çağırabilirsiniz. Bu iç içe yerleştirilmiş kapsayıcılara erişmek için katmanınızda yapabileceğiniz gibi getContainers() çağrısı yapabilirsiniz

KmlLayer veya KmlContainer: içine yerleştirilmemiş kapsayıcılara erişmek için

for (containers in layer.containers) {
    // Do something to container
}

      

for (KmlContainer containers : layer.getContainers()) {
    // Do something to container
}

      

KmlLayer veya KmlContainer içine yerleştirilmiş kapsayıcılara erişmek için:

fun accessContainers(containers: Iterable<KmlContainer>) {
    for (container in containers) {
        if (container.hasContainers()) {
            accessContainers(container.containers)
        }
    }

      

public void accessContainers(Iterable<KmlContainer> containers) {
    for (KmlContainer container : containers) {
        if (container.hasContainers()) {
            accessContainers(container.getContainers());
        }
    }
}

      

KML yer işaretlerine ve KML yer bindirmelerine erişim

Katmana eklenen herhangi bir yer işaretine veya yer bindirmesine erişmek için bir katman ya da kapsayıcıda getPlacemarks() ya da getGroundOverlays() çağırabilirsiniz. İkisinden birinin çağrılması durumunda, sırasıyla KmlPlacemarks veya KmlGroundOverlays iterasyonlu sonuç döndürülür.

Örneğin, bir katmandan KmlPlacemark nesnesine erişmek için:

for (placemark in layer.placemarks) {
    // Do something to Placemark
}

      

for (KmlPlacemark placemark : layer.getPlacemarks()) {
    // Do something to Placemark
}

      

KML özelliklerine erişim

Bir kapsayıcıdaki veya yer işaretindeki herhangi bir mülke erişmek için getProperty() yöntemini çağırın ve mülke mülk anahtarı verin. Mevcut olup olmadığını kontrol etmek için hasProperty() numaralı telefonu da arayabilirsiniz. Bu örnekte, "name" özellik değerinin bir kapsayıcıdan (varsa) nasıl alınacağı gösterilmektedir.

for (container in layer.containers) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"))
    }
}

      

for (KmlContainer container : layer.getContainers()) {
    if (container.hasProperty("name")) {
        Log.i("KML", container.getProperty("name"));
    }
}

      

KML Geometri Tıklama Etkinlikleri

Haritadaki geometri özelliklerinde tıklama etkinliklerini dinlemek için KmlLayer.OnFeatureClickListener() kullanabilirsiniz. Aşağıdaki örnekte, kullanıcı bir özelliği tıkladığında özelliğin kimliği günlüğe kaydedilir:

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener { feature ->
    Log.i(
        "KML",
        "Feature clicked: " + feature.id
    )
}

      

// Set a listener for geometry clicked events.
layer.setOnFeatureClickListener(new KmlLayer.OnFeatureClickListener() {
    @Override
    public void onFeatureClick(Feature feature) {
        Log.i("KML", "Feature clicked: " + feature.getId());
    }
});

      

Demo uygulamaya göz atın

Bir KML dosyasını içe aktarma ve bununla bir katman oluşturma örneği için demo uygulamasında yardımcı program kitaplığıyla birlikte gönderilen KmlDemoActivity öğesine göz atın. Kurulum kılavuzu, demo uygulamasının nasıl çalıştırılacağını gösterir.

KML tarafından desteklenen özellikler