Control marker visibility by zoom level

  • This example demonstrates how to control the visibility of markers based on the map's zoom level.

  • By dynamically setting the marker.map property to either the map instance or null, markers can be shown or hidden as the user zooms in or out.

  • The sample code utilizes the AdvancedMarkerElement class and listens to the zoom_changed event to adjust marker visibility accordingly.

  • You can view the marker visibility change by zooming in or out on the map provided in the sample.

This example shows controlling marker visibility by zoom level. See the markers' visibility change (begin by zooming out):

Read the documentation.

TypeScript

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

    const map = new Map(document.getElementById('map') as HTMLElement, {
        center: {lat: 37.424563902650114, lng: -122.09512859577026},
        zoom: 17,
        mapId: '4504f8b37365c3d0',
    });

    const marker01 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.4239163, lng: -122.094 },
        title: 'This marker is visible at zoom level 15 and higher.'
    });

    const marker02 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.4245, lng: -122.096 },
        title: 'This marker is visible at zoom level 16 and higher.'
    });

    const marker03 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.4249, lng: -122.095 },
        title: 'This marker is visible at zoom level 17 and higher.'
    });

    const marker04 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.425, lng: -122.0955 },
        title: 'This marker is visible at zoom level 18 and higher.'
    });
    map.addListener('zoom_changed', () => {
        const zoom = map.getZoom();
        if (zoom) {
            // Only show each marker above a certain zoom level.
            marker01.map = zoom > 14 ? map : null;
            marker02.map = zoom > 15 ? map : null;
            marker03.map = zoom > 16 ? map : null;
            marker04.map = zoom > 17 ? map : null;
        }
    });
}

initMap();
index.ts

JavaScript

async function initMap() {
    // Request needed libraries.
    const { Map } = await google.maps.importLibrary("maps");
    const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");
    const map = new Map(document.getElementById('map'), {
        center: { lat: 37.424563902650114, lng: -122.09512859577026 },
        zoom: 17,
        mapId: '4504f8b37365c3d0',
    });
    const marker01 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.4239163, lng: -122.094 },
        title: 'This marker is visible at zoom level 15 and higher.'
    });
    const marker02 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.4245, lng: -122.096 },
        title: 'This marker is visible at zoom level 16 and higher.'
    });
    const marker03 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.4249, lng: -122.095 },
        title: 'This marker is visible at zoom level 17 and higher.'
    });
    const marker04 = new AdvancedMarkerElement({
        map,
        position: { lat: 37.425, lng: -122.0955 },
        title: 'This marker is visible at zoom level 18 and higher.'
    });
    map.addListener('zoom_changed', () => {
        const zoom = map.getZoom();
        if (zoom) {
            // Only show each marker above a certain zoom level.
            marker01.map = zoom > 14 ? map : null;
            marker02.map = zoom > 15 ? map : null;
            marker03.map = zoom > 16 ? map : null;
            marker04.map = zoom > 17 ? map : null;
        }
    });
}
initMap();
index.js

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>Advanced Marker Zoom Visibility</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: "AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8", v: "weekly"});</script>
  </body>
</html>
index.html

Try Sample

Clone Sample

Git and Node.js are required to run this sample locally. Follow these instructions to install Node.js and NPM. The following commands clone, install dependencies and start the sample application. 

  git clone https://github.com/googlemaps-samples/js-api-samples.git
  cd samples/advanced-markers-zoom
  npm i
  npm start