AI-generated Key Takeaways
-
This example demonstrates how to control the visibility of markers based on the map's zoom level.
-
By dynamically setting the
marker.mapproperty to either the map instance ornull, markers can be shown or hidden as the user zooms in or out. -
The sample code utilizes the
AdvancedMarkerElementclass and listens to thezoom_changedevent 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
const mapElement = document . querySelector ( 'gmp-map' ) as google . maps . MapElement ; 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 markerOptions = [ { position : { lat : 37.4239163 , lng : - 122.094 }, title : 'This marker is visible at zoom level 15 and higher.' , minZoom : 14 , }, { position : { lat : 37.4245 , lng : - 122.096 }, title : 'This marker is visible at zoom level 16 and higher.' , minZoom : 15 , }, { position : { lat : 37.4249 , lng : - 122.095 }, title : 'This marker is visible at zoom level 17 and higher.' , minZoom : 16 , }, { position : { lat : 37.425 , lng : - 122.0955 }, title : 'This marker is visible at zoom level 18 and higher.' , minZoom : 17 , }, ]; const markers : google.maps.marker.AdvancedMarkerElement [] = []; for ( const { position , title } of markerOptions ) { const marker = new AdvancedMarkerElement ({ position , title }); mapElement . append ( marker ); markers . push ( marker ); } mapElement . innerMap . addListener ( 'zoom_changed' , () = > { let zoom = mapElement . innerMap . getZoom (); for ( let i = 0 ; i < markers . length ; i ++ ) { const { position , minZoom } = markerOptions [ i ]; markers [ i ]. position = zoom ! > minZoom ? position : null ; } }); } initMap ();
JavaScript
const mapElement = document . querySelector ( 'gmp-map' ); async function initMap () { // Request needed libraries. const { Map } = ( await google . maps . importLibrary ( 'maps' )); const { AdvancedMarkerElement } = ( await google . maps . importLibrary ( 'marker' )); const markerOptions = [ { position : { lat : 37.4239163 , lng : - 122.094 }, title : 'This marker is visible at zoom level 15 and higher.' , minZoom : 14 , }, { position : { lat : 37.4245 , lng : - 122.096 }, title : 'This marker is visible at zoom level 16 and higher.' , minZoom : 15 , }, { position : { lat : 37.4249 , lng : - 122.095 }, title : 'This marker is visible at zoom level 17 and higher.' , minZoom : 16 , }, { position : { lat : 37.425 , lng : - 122.0955 }, title : 'This marker is visible at zoom level 18 and higher.' , minZoom : 17 , }, ]; const markers = []; for ( const { position , title } of markerOptions ) { const marker = new AdvancedMarkerElement ({ position , title }); mapElement . append ( marker ); markers . push ( marker ); } mapElement . innerMap . addListener ( 'zoom_changed' , () = > { let zoom = mapElement . innerMap . getZoom (); for ( let i = 0 ; i < markers . length ; i ++ ) { const { position , minZoom } = markerOptions [ i ]; markers [ i ]. position = zoom > minZoom ? position : null ; } }); } initMap ();
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ gmp-map { height : 100 % ; } /* * Optional: Makes the sample page fill the window. */ html , body { height : 100 % ; margin : 0 ; padding : 0 ; }
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> <!-- 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> </head> <body> <gmp-map center="37.424563902650114,-122.09512859577026" zoom="18" map-id="4504f8b37365c3d0" ></gmp-map> </body> </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.gitcd samples / advanced - markers - zoomnpm inpm start
