כלי עזר רב-שכבתי של מפות 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);

      

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

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

Kotlin

markerCollection.setOnMarkerClickListener { 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 באפליקציית ההדגמה שנשלחת יחד עם ספריית השירותים. במדריך ההגדרה מוסבר איך להפעיל אפליקציית ההדגמה.