أداة استيراد KML في خرائط Google

1. مقدمة
2. إضافة طبقة KML
3. محو طبقة KML
4. الوصول إلى حاويات KML
5. الوصول إلى العلامات الموضعية في KML وتراكبات صور KML
6. الوصول إلى مواقع KML
7. الميزات المتوافقة مع KML

مقدمة

تشكّل KML امتدادًا لتنسيق بيانات XML وتمثّل البيانات الجغرافية على الخريطة. وباستخدام هذه الأداة، يمكنك تحويل كائنات KML إلى أشكال جغرافية وعرضها كطبقة على الخريطة. لإضافة بيانات KML إلى الخريطة وإزالتها منها، يمكنك طلب addLayerToMap() وremoveLayerFromMap() على التوالي. للوصول إلى المواقع في عنصر KML، يمكنك استدعاء getProperties() على أي علامة موضعية أو علامة أرضية أو مستند أو مجلد.

إضافة طبقة KML إلى الخريطة

لإضافة طبقة بيانات إلى الخريطة، عليك أولاً إنشاء مثيل للفئة KmlLayer. هناك طريقتان لإنشاء مثيل KmlLayer.

لاستيراد مجموعة بيانات KML من مورد محلي وعرضها.

• عنصر GoogleMap حيث يتم عرض الطبقة.
• ملف مورد محلي يحتوي على بيانات KML.
• عنصر Context مطلوب لفتح ملف موارد محلية.

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

      

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

      

لاستيراد وعرض مجموعة بيانات KML من بث محلي، يجب أن يكون لديك ما يلي:

• عنصر GoogleMap حيث يتم عرض الطبقة.
• InputStream يحتوي على بيانات KML.
• عنصر Context مطلوب لفتح الموارد المحلية.

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

      

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

      

بعد إنشاء KmlLayer، يمكنك استدعاء addLayerToMap()() لإضافة البيانات التي تم استيرادها إلى الخريطة.

layer.addLayerToMap();

      

layer.addLayerToMap()

      

محو طبقة KML

لنفترض أنّك أنشأت ملف KmlLayer هذا:

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

      

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

      

لإزالة الطبقة من الخريطة، اتصل بـ removeLayerFromMap():

layer.removeLayerFromMap();

      

layer.removeLayerFromMap()

      

الوصول إلى حاويات KML

للوصول إلى أي حاويات تمت إضافتها إلى طبقتك، يمكنك استدعاء getContainers() على الطبقة التي أنشأتها. للتحقّق مما إذا كانت أي حاوية تتضمّن حاويات متداخلة، يمكنك طلب hasContainers(). للوصول إلى هذه الحاويات المتداخلة، تمامًا مثل ما يمكنك فعله في الطبقة، يمكنك استدعاء getContainers()

للوصول إلى الحاويات غير المُدمَجة في KmlLayer أو KmlContainer:

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

      

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

      

للوصول إلى الحاويات المدمجة في KmlLayer أو KmlContainer:

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

      

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

      

الوصول إلى علامات موضعية في KML وتراكبات على سطح KML

للوصول إلى أي علامة موضعية أو تراكب أرض تمت إضافته إلى الطبقة، يمكنك استدعاء getPlacemarks() أو getGroundOverlays() على طبقة أو حاوية. سيؤدي الاتصال إما إلى عرض تكرار في KmlPlacemarks أو KmlGroundOverlays على التوالي.

على سبيل المثال، للوصول إلى عناصر KmlPlacemark من طبقة:

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

      

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

      

الدخول إلى مواقع KML

للوصول إلى أي موقع في الحاوية أو العلامة الموضعية، اطلب getProperty() وامنحه مفتاح الموقع. ويمكنك أيضًا الاتصال برقم hasProperty() للتأكد من توفّر العنصر. يعرض هذا النموذج كيفية استرداد قيمة الخاصية "name;quot; من الحاوية، في حال وجودها.

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

      

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

      

أحداث النقر الهندسي في KML

يمكنك استخدام KmlLayer.OnFeatureClickListener() للاستماع إلى فعاليات النقر على الميزات الهندسية على الخريطة. يسجّل المثال التالي رقم تعريف ميزة عندما ينقر المستخدم على الميزة:

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

      

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

      

عرض التطبيق التجريبي

للحصول على مثال لاستيراد ملف KML وإنشاء طبقة به، يمكنك الاطّلاع على KmlDemoActivity في التطبيق التجريبي الذي يتم شحنه مع مكتبة الأدوات. يوضّح لك دليل الإعداد كيفية تشغيل التطبيق التجريبي.

الميزات المتوافقة مع KML