כלי לייבוא 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, שנדרש לפתיחת משאב מקומי חדש.

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