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

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

מבוא

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

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

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

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

      

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

      

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

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
)

      

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. לדוגמה, אם רוצים להוסיף סמן חדש:

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

      

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, פעולת ה-listens של click תהיה רגילה - כל עוד אתם מעבירים Manager מחלקות ב-constructor של השכבה שמגדירים. לדוגמה, כך מגדירים האזנה לקליקים לשכבת ה-KML:

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

      

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

      

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

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

      

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

      

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

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