כלי עזר רב-שכבתי של מפות Google

בחירת פלטפורמה: Android JavaScript

1. מבוא
2. הוספת שכבות מרובות של אשכול, KML ו-GeoJSON
3. הוספת תכונות משלכם
4. טיפול באירועי קליקים
5. לצפייה באפליקציית ההדגמה

מבוא

במדריכים הקודמים למדת איך להוסיף תכונות מ-KML ומ-GeoJSON למפה, וכן מאשכולות של סמנים. אבל מה קורה אם רוצים להוסיף כמה משכבות אלה באותה מפה ולקבל אירועי קליקים עצמאיים עבור כל אחת?

הוספת שכבות מרובות של אשכול, KML ו-GeoJSON

הספרייה כוללת Managerאובייקטים שעוזרים לנהל אירועי קליק בכמה סוגים של שכבות. לכן, לפני שמגדירים את השכבות, צריך קודם ליצור אותן ולהעביר אותן ב-GoogleMap:

Kotlin

val markerManager = MarkerManager(map)
val groundOverlayManager = GroundOverlayManager(map!!)
val polygonManager = PolygonManager(map)
val polylineManager = PolylineManager(map)

      

Java

MarkerManager markerManager = new MarkerManager(map);
GroundOverlayManager groundOverlayManager = new GroundOverlayManager(map);
PolygonManager polygonManager = new PolygonManager(map);
PolylineManager polylineManager = new PolylineManager(map);

      

בשלב הבא אפשר להעביר את מחלקות הניהול האלה ל-constructs של השכבות האחרות בזמן שמגדירים אותן:

Kotlin

val clusterManager =
    ClusterManager<MyItem>(context, map, markerManager)
val geoJsonLineLayer = GeoJsonLayer(
    map,
    R.raw.geojson_file,
    context,
    markerManager,
    polygonManager,
    polylineManager,
    groundOverlayManager
)
val kmlPolylineLayer = KmlLayer(
    map,
    R.raw.kml_file,
    context,
    markerManager,
    polygonManager,
    polylineManager,
    groundOverlayManager,
    null
)

      

Java

ClusterManager<MyItem> clusterManager = new ClusterManager<>(context, map, markerManager);
GeoJsonLayer geoJsonLineLayer = new GeoJsonLayer(map, R.raw.geojson_file, context, markerManager, polygonManager, polylineManager, groundOverlayManager);
KmlLayer kmlPolylineLayer = new KmlLayer(map, R.raw.kml_file, context, markerManager, polygonManager, polylineManager, groundOverlayManager, null);

      

הוספת תכונות משלך

אם רוצים להוסיף סמנים, שכבות-על של קרקע, פוליגונים או פוליגונים לצד השכבות האלה, צריך ליצור Collection משלכם ואז להשתמש ב-Managers כדי להוסיף את התכונה במקום להוסיף אותן ישירות לאובייקט GoogleMap. לדוגמה, אם רוצים להוסיף סמן חדש:

Kotlin

val markerCollection =
    markerManager.newCollection()
markerCollection.addMarker(
    MarkerOptions()
        .position(LatLng(51.150000, -0.150032))
        .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
        .title("Unclustered marker")
)

      

Java

MarkerManager.Collection markerCollection = markerManager.newCollection();
markerCollection.addMarker(new MarkerOptions()
    .position(new LatLng(51.150000, -0.150032))
    .icon(BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_AZURE))
    .title("Unclustered marker"));

      

טיפול באירועי קליקים

באשכולות, KML ו-GeoJSON, פונקציות ה-Listener פועלות כרגיל – כל עוד מעבירים ב-Manager המחלקות בבונה של השכבה שמגדירים. לדוגמה, כך מגדירים האזנה לקליקים עבור שכבת ה-KML:

Kotlin

kmlPolylineLayer.addLayerToMap()
kmlPolylineLayer.setOnFeatureClickListener { feature: Feature ->
    Toast.makeText(context,
        "KML polyline clicked: ${feature.getProperty("name")}",
        Toast.LENGTH_SHORT
    ).show()
}

      

Java

kmlPolylineLayer.addLayerToMap();
kmlPolylineLayer.setOnFeatureClickListener(feature -> Toast.makeText(context,
    "KML polyline clicked: " + feature.getProperty("name"),
    Toast.LENGTH_SHORT).show());

      

כשמוסיפים סמנים, שכבות-על של קרקע, פוליגונים או פוליגונים, חשוב להוסיף ל-Collection האובייקטים האלה פונקציות מסוג click listener. לדוגמה, כך מגדירים את Click listener של הסמן ב-markerCollection:

Kotlin

markerCollection.setOnMarkerClickListener { marker: Marker ->
    Toast.makeText(
        context,
        "Marker clicked: ${marker.title}",
        Toast.LENGTH_SHORT
    ).show()
    false
}

      

Java

markerCollection.setOnMarkerClickListener(marker -> { Toast.makeText(context,
    "Marker clicked: " + marker.getTitle(),
        Toast.LENGTH_SHORT).show();
    return false;
});

      

לצפייה באפליקציית ההדגמה

דוגמה להוספת כמה שכבות: אפשר לראות את MultiLayerDemoActivity באפליקציה לדוגמה שכלולה עם ספריית כלי השירות. במדריך ההגדרה מוסבר איך להפעיל את אפליקציית ההדגמה.