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

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

مقدمة

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

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

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

لاستيراد وعرض مجموعة بيانات KML من مورد محلي، ستحتاج إلى:

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

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

      

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

      

لاستيراد مجموعة بيانات KML وعرضها من مصدر بيانات محلي، تحتاج إلى:

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

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);

      

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

layer.addLayerToMap()

      

layer.addLayerToMap();

      

محو طبقة KML

لنفترض أنك أنشأت KmlLayer:

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);

      

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

layer.removeLayerFromMap()

      

layer.removeLayerFromMap();

      

الدخول إلى حاويات KML

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

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

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

      

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

      

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

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 وتراكبات أرض KML

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

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

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

      

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

      

الدخول إلى خصائص KML

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

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

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

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

      

الاطّلاع على التطبيق التجريبي

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

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