ابزار وارد کردن KML Maps Google

1. مقدمه
2. یک لایه KML اضافه کنید
3. یک لایه KML را پاک کنید
4. به کانتینرهای KML دسترسی داشته باشید
5. به مکان‌نماهای KML و همپوشانی‌های زمینی KML دسترسی داشته باشید
6. دسترسی به خصوصیات KML
7. ویژگی های پشتیبانی شده از KML

مقدمه

KML توسعه فرمت داده XML است و داده های جغرافیایی را بر روی نقشه نشان می دهد. با استفاده از این ابزار، می توانید اشیاء KML را به اشکال جغرافیایی تبدیل کرده و آنها را به صورت یک لایه در بالای نقشه رندر کنید. برای افزودن و حذف داده‌های KML خود به نقشه، به ترتیب addLayerToMap() و removeLayerFromMap() را فراخوانی کنید. برای دسترسی به خصوصیات در یک شی KML، getProperties() را در هر Placemark، GroundOverlay، Document یا Folder فراخوانی کنید.

یک لایه 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() تماس بگیرید. این نمونه نحوه بازیابی مقدار ویژگی "name" را از یک ظرف، در صورت وجود نشان می دهد.

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