การคลัสเตอร์เครื่องหมาย

เลือกแพลตฟอร์ม Android iOS JavaScript

ภาพรวม

บทแนะนำนี้จะแสดงวิธีใช้คลัสเตอร์เครื่องหมายเพื่อแสดงเครื่องหมายจำนวนมากบนแผนที่ คุณสามารถใช้ไลบรารี @googlemaps/markerclusterer ร่วมกับ Maps JavaScript API เพื่อรวมเครื่องหมายที่อยู่ใกล้กันไว้ในคลัสเตอร์ และลดความซับซ้อนในการแสดงเครื่องหมายบนแผนที่

หากต้องการดูวิธีการทำงานของการรวมกลุ่มเครื่องหมาย ให้ดูแผนที่ด้านล่าง

ฟีเจอร์ลองฟังอาจไม่พร้อมให้บริการในภูมิภาคของคุณ

ตัวเลขในคลัสเตอร์แสดงจํานวนเครื่องหมายในคลัสเตอร์นั้น โปรดทราบว่าเมื่อคุณซูมเข้าที่ตำแหน่งใดก็ได้ของคลัสเตอร์ จำนวนในคลัสเตอร์จะลดลง และคุณจะเริ่มเห็นเครื่องหมายแต่ละรายการบนแผนที่ การซูมออกจากแผนที่จะรวมเครื่องหมายเป็นกลุ่มอีกครั้ง

ตัวอย่างด้านล่างแสดงโค้ดทั้งหมดที่จําเป็นในการสร้างแผนที่นี้

TypeScript

import { MarkerClusterer } from "@googlemaps/markerclusterer";

async function initMap() {
  // Request needed libraries.
  const { Map, InfoWindow } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;
  const { AdvancedMarkerElement, PinElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;

  const map = new google.maps.Map(
    document.getElementById("map") as HTMLElement,
    {
      zoom: 3,
      center: { lat: -28.024, lng: 140.887 },
      mapId: 'DEMO_MAP_ID',
    }
  );

  const infoWindow = new google.maps.InfoWindow({
    content: "",
    disableAutoPan: true,
  });

  // Create an array of alphabetical characters used to label the markers.
  const labels = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";

  // Add some markers to the map.
  const markers = locations.map((position, i) => {
    const label = labels[i % labels.length];
    const pinGlyph = new google.maps.marker.PinElement({
      glyph: label,
      glyphColor: "white",
    })
    const marker = new google.maps.marker.AdvancedMarkerElement({
      position,
      content: pinGlyph.element,
    });

    // markers can only be keyboard focusable when they have click listeners
    // open info window when marker is clicked
    marker.addListener("click", () => {
      infoWindow.setContent(position.lat + ", " + position.lng);
      infoWindow.open(map, marker);
    });
    return marker;
  });

  // Add a marker clusterer to manage the markers.
  new MarkerClusterer({ markers, map });
}

const locations = [
  { lat: -31.56391, lng: 147.154312 },
  { lat: -33.718234, lng: 150.363181 },
  { lat: -33.727111, lng: 150.371124 },
  { lat: -33.848588, lng: 151.209834 },
  { lat: -33.851702, lng: 151.216968 },
  { lat: -34.671264, lng: 150.863657 },
  { lat: -35.304724, lng: 148.662905 },
  { lat: -36.817685, lng: 175.699196 },
  { lat: -36.828611, lng: 175.790222 },
  { lat: -37.75, lng: 145.116667 },
  { lat: -37.759859, lng: 145.128708 },
  { lat: -37.765015, lng: 145.133858 },
  { lat: -37.770104, lng: 145.143299 },
  { lat: -37.7737, lng: 145.145187 },
  { lat: -37.774785, lng: 145.137978 },
  { lat: -37.819616, lng: 144.968119 },
  { lat: -38.330766, lng: 144.695692 },
  { lat: -39.927193, lng: 175.053218 },
  { lat: -41.330162, lng: 174.865694 },
  { lat: -42.734358, lng: 147.439506 },
  { lat: -42.734358, lng: 147.501315 },
  { lat: -42.735258, lng: 147.438 },
  { lat: -43.999792, lng: 170.463352 },
];

initMap();
index.ts

หมายเหตุ: อ่านคู่มือเกี่ยวกับการใช้ TypeScript และ Google Maps

JavaScript

import { MarkerClusterer } from "@googlemaps/markerclusterer";

async function initMap() {
  // Request needed libraries.
  const { Map, InfoWindow } = await google.maps.importLibrary("maps");
  const { AdvancedMarkerElement, PinElement } = await google.maps.importLibrary(
    "marker",
  );
  const map = new google.maps.Map(document.getElementById("map"), {
    zoom: 3,
    center: { lat: -28.024, lng: 140.887 },
    mapId: "DEMO_MAP_ID",
  });
  const infoWindow = new google.maps.InfoWindow({
    content: "",
    disableAutoPan: true,
  });
  // Create an array of alphabetical characters used to label the markers.
  const labels = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
  // Add some markers to the map.
  const markers = locations.map((position, i) => {
    const label = labels[i % labels.length];
    const pinGlyph = new google.maps.marker.PinElement({
      glyph: label,
      glyphColor: "white",
    });
    const marker = new google.maps.marker.AdvancedMarkerElement({
      position,
      content: pinGlyph.element,
    });

    // markers can only be keyboard focusable when they have click listeners
    // open info window when marker is clicked
    marker.addListener("click", () => {
      infoWindow.setContent(position.lat + ", " + position.lng);
      infoWindow.open(map, marker);
    });
    return marker;
  });

  // Add a marker clusterer to manage the markers.
  new MarkerClusterer({ markers, map });
}

const locations = [
  { lat: -31.56391, lng: 147.154312 },
  { lat: -33.718234, lng: 150.363181 },
  { lat: -33.727111, lng: 150.371124 },
  { lat: -33.848588, lng: 151.209834 },
  { lat: -33.851702, lng: 151.216968 },
  { lat: -34.671264, lng: 150.863657 },
  { lat: -35.304724, lng: 148.662905 },
  { lat: -36.817685, lng: 175.699196 },
  { lat: -36.828611, lng: 175.790222 },
  { lat: -37.75, lng: 145.116667 },
  { lat: -37.759859, lng: 145.128708 },
  { lat: -37.765015, lng: 145.133858 },
  { lat: -37.770104, lng: 145.143299 },
  { lat: -37.7737, lng: 145.145187 },
  { lat: -37.774785, lng: 145.137978 },
  { lat: -37.819616, lng: 144.968119 },
  { lat: -38.330766, lng: 144.695692 },
  { lat: -39.927193, lng: 175.053218 },
  { lat: -41.330162, lng: 174.865694 },
  { lat: -42.734358, lng: 147.439506 },
  { lat: -42.734358, lng: 147.501315 },
  { lat: -42.735258, lng: 147.438 },
  { lat: -43.999792, lng: 170.463352 },
];

initMap();
index.js

หมายเหตุ: ระบบจะคอมไพล์ JavaScript จากข้อมูลโค้ด TypeScript

CSS

/* 
 * Always set the map height explicitly to define the size of the div element
 * that contains the map. 
 */
#map {
  height: 100%;
}

/* 
 * Optional: Makes the sample page fill the window. 
 */
html,
body {
  height: 100%;
  margin: 0;
  padding: 0;
}
style.css

HTML

<html>
  <head>
    <title>Marker Clustering</title>

    <link rel="stylesheet" type="text/css" href="./style.css" />
    <script type="module" src="./index.js"></script>
  </head>
  <body>
    <div id="map"></div>

    <!-- prettier-ignore -->
    <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})
        ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "weekly"});</script>
  </body>
</html>
index.html

ลองใช้ตัวอย่าง

JSFiddle.net Google Cloud Shell

บทแนะนํานี้จะเพิ่มชุดเครื่องหมายลงในแผนที่โดยใช้อาร์เรย์ locations เพื่อเป็นภาพประกอบง่ายๆ คุณใช้แหล่งที่มาอื่นๆ เพื่อรับเครื่องหมายสำหรับแผนที่ได้ อ่านข้อมูลเพิ่มเติมได้ในคู่มือการสร้างเครื่องหมาย

เพิ่มเครื่องมือจัดกลุ่มเครื่องหมาย

ทําตามขั้นตอนด้านล่างเพื่อเพิ่มเครื่องมือจัดกลุ่มเครื่องหมาย

1. เพิ่มคลังการคลัสเตอร์เครื่องหมายลงในหน้าเว็บหรือแอปพลิเคชัน ไลบรารีมีให้บริการใน NPM ที่ @googlemaps/markerclusterer และในที่เก็บใน GitHub

   NPM

   ติดตั้งไลบรารี @googlemaps/markerclusterer เวอร์ชันล่าสุดโดยใช้ NPM

   npm install @googlemaps/markerclusterer

   CDN

   สคริปต์ด้านล่างจะโหลดไลบรารีเวอร์ชัน 1.x.x ล่าสุดจาก unpkg.com CDN

   <script src="https://unpkg.com/@googlemaps/markerclusterer/dist/index.min.js"></script>

2. เพิ่มเครื่องมือจัดกลุ่มเครื่องหมายในแอป
   

   โค้ดด้านล่างจะเพิ่มคลัสเตอร์เครื่องหมายลงในแผนที่

   NPM

   import { MarkerClusterer } from "@googlemaps/markerclusterer";
   
   const markerCluster = new MarkerClusterer({ markers, map });

   CDN

   เมื่อเข้าถึงด้วย CDN คลังจะอยู่ใน markerClusterer global

   const markerCluster = new markerClusterer.MarkerClusterer({ markers, map });

   ตัวอย่างนี้จะส่งอาร์เรย์ markers ไปยัง MarkerClusterer

3. ปรับแต่งเครื่องมือจัดกลุ่มเครื่องหมาย
   • ปรับแต่งไอคอนคลัสเตอร์ผ่านอินเทอร์เฟซโปรแกรมแสดงผล
   • แก้ไขอัลกอริทึมในการสร้างคลัสเตอร์

ดูข้อมูลเพิ่มเติม

คุณดูตัวอย่างการคลัสเตอร์เครื่องหมายที่ซับซ้อนมากขึ้นได้ในที่เก็บใน GitHub และอ่านเอกสารอ้างอิงสำหรับไลบรารี