Samples/Clustering/Areas/Cluster Areas.html

﻿<!DOCTYPE html>
<html lang="en">
<head>
    <title>Cluster Areas - Bing Maps Samples</title>

    <meta charset="utf-8" />
	<link rel="shortcut icon" href="/favicon.ico"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
    <meta name="description" content="This sample shows how to show the area in which the pushpins in a cluster cover when hovering over a cluster." />
    <meta name="keywords" content="Microsoft maps, map, gis, API, SDK, Bing, Bing Maps" />
    <meta name="author" content="Microsoft Bing Maps" />
    <meta name="screenshot" content="screenshot.jpg" />
    
    <script type="text/javascript">
    var map, clusterLayer, areaLayer;

    function GetMap() {
        map = new Microsoft.Maps.Map('#myMap', {});

        //Load the Clustering and Spatial Math module.
        Microsoft.Maps.loadModule(["Microsoft.Maps.Clustering", "Microsoft.Maps.SpatialMath"], function () {
            //Generate 1,000 random pushpins in the map view.
            var pins = Microsoft.Maps.TestDataGenerator.getPushpins(1000, map.getBounds());

            //Add a layer for displaying the cluster areas.
            areaLayer = new Microsoft.Maps.Layer();
            map.layers.insert(areaLayer);

            //Create a ClusterLayer and add it to the map.
            clusterLayer = new Microsoft.Maps.ClusterLayer(pins, {
                gridSize: 80
            });
            map.layers.insert(clusterLayer);

            //Add mouse over/out events to hide/show areas.
            Microsoft.Maps.Events.addHandler(clusterLayer, 'mouseover', showArea);
            Microsoft.Maps.Events.addHandler(clusterLayer, 'mouseout', function () {
                //Clear all data in the area layer.
                areaLayer.clear();
            });
        });
    }

    function showArea(e) {
        //Check to see if the clicked pushpin has any contained pushpins (this would be a cluster).
        if (e.target.containedPushpins) {
            //Check to see if a convex hull was already calculated for this cluster.
            if (e.target.metadata && e.target.metadata.hull) {
                areaLayer.add(e.target.metadata.hull);
            } else {
                //Calculate the convex hull.
                var hullPolygon = Microsoft.Maps.SpatialMath.Geometry.convexHull(e.target.containedPushpins, {
                    fillColor: 'rgba(0,0,250,0.3)',
                    strokeColor: 'blue'
                });

                //Add the data to the map.
                areaLayer.add(hullPolygon);

                //Cache the calculated convex hull in case the used hovers over it again.
                e.target.metadata = {
                    hull: hullPolygon
                };
            }
        }
    }
    </script>
    
</head>
<body>
    <div id="myMap" style="position:relative;width:100%;min-width:290px;height:600px;background-color:gray"></div>

    <fieldset style="width:800px;margin-top:10px;">
        <legend>Cluster Areas Sample</legend>
        This sample shows how to show the area in which the pushpins in a cluster cover when hovering over a cluster. 
        This is done by simply calculating the convex hull of the pushpins in a cluster.
    </fieldset>

    <script>
        // Dynamic load the Bing Maps Key and Script
        // Get your own Bing Maps key at https://www.microsoft.com/maps
        (async () => {
            let script = document.createElement("script");
            let bingKey = await fetch("https://samples.azuremaps.com/api/GetBingMapsKey").then(r => r.text()).then(key => { return key });
            script.setAttribute("src", `https://www.bing.com/api/maps/mapcontrol?callback=GetMap&key=${bingKey}`);
            document.body.appendChild(script);
        })();
    </script>
</body>
</html>