Stay organized with collectionsSave and categorize content based on your preferences.
This example creates five markers which are accessible. The first marker
receives focus when tab is pressed; you can then use the arrow keys to move
between markers. Press tab again to continue moving through the rest of the map
controls. If a marker has an info window, you can open it by clicking, or by
pressing the enter key or space bar. When the info window closes, focus will
return to the associated marker.
// The following example creates five accessible and// focusable markers.functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{zoom:12,center:{lat:34.84555,lng:-111.8035},});// Set LatLng and title text for the markers. The first marker (Boynton Pass)// receives the initial focus when tab is pressed. Use arrow keys to// move between markers; press tab again to cycle through the map controls.consttourStops:[google.maps.LatLngLiteral,string][]=[[{lat:34.8791806,lng:-111.8265049},"Boynton Pass"],[{lat:34.8559195,lng:-111.7988186},"Airport Mesa"],[{lat:34.832149,lng:-111.7695277},"Chapel of the Holy Cross"],[{lat:34.823736,lng:-111.8001857},"Red Rock Crossing"],[{lat:34.800326,lng:-111.7665047},"Bell Rock"],];// Create an info window to share between markers.constinfoWindow=newgoogle.maps.InfoWindow();// Create the markers.tourStops.forEach(([position,title],i)=>{constmarker=newgoogle.maps.Marker({position,map,title:`${i+1}.${title}`,label:`${i+1}`,optimized:false,});// Add a click listener for each marker, and set up the info window.marker.addListener("click",()=>{infoWindow.close();infoWindow.setContent(marker.getTitle());infoWindow.open(marker.getMap(),marker);});});}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
// The following example creates five accessible and// focusable markers.functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{zoom:12,center:{lat:34.84555,lng:-111.8035},});// Set LatLng and title text for the markers. The first marker (Boynton Pass)// receives the initial focus when tab is pressed. Use arrow keys to// move between markers; press tab again to cycle through the map controls.consttourStops=[[{lat:34.8791806,lng:-111.8265049},"Boynton Pass"],[{lat:34.8559195,lng:-111.7988186},"Airport Mesa"],[{lat:34.832149,lng:-111.7695277},"Chapel of the Holy Cross"],[{lat:34.823736,lng:-111.8001857},"Red Rock Crossing"],[{lat:34.800326,lng:-111.7665047},"Bell Rock"],];// Create an info window to share between markers.constinfoWindow=newgoogle.maps.InfoWindow();// Create the markers.tourStops.forEach(([position,title],i)=>{constmarker=newgoogle.maps.Marker({position,map,title:`${i+1}.${title}`,label:`${i+1}`,optimized:false,});// Add a click listener for each marker, and set up the info window.marker.addListener("click",()=>{infoWindow.close();infoWindow.setContent(marker.getTitle());infoWindow.open(marker.getMap(),marker);});});}window.initMap=initMap;
/** 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;}
<html>
<head>
<title>Marker Accessibility</title>
<link rel="stylesheet" type="text/css" href="./style.css" />
<script type="module" src="./index.js"></script>
</head>
<body>
<div id="map"></div>
<!--
The `defer` attribute causes the script to execute after the full HTML
document has been parsed. For non-blocking uses, avoiding race conditions,
and consistent behavior across browsers, consider loading using Promises. See
https://developers.google.com/maps/documentation/javascript/load-maps-js-api
for more information.
-->
<script
src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly"
defer
></script>
</body>
</html>
Git and Node.js are required to run this sample locally. Follow theseinstructionsto install Node.js and NPM. The following commands clone, install dependencies and start the sample application.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003e\u003ccode\u003egoogle.maps.Marker\u003c/code\u003e is deprecated, with \u003ccode\u003egoogle.maps.marker.AdvancedMarkerElement\u003c/code\u003e recommended as its replacement.\u003c/p\u003e\n"],["\u003cp\u003eThis example demonstrates how to create accessible and focusable markers on a Google Map using the Maps JavaScript API.\u003c/p\u003e\n"],["\u003cp\u003eUsers can navigate between markers using keyboard controls (tab, arrow keys, enter, spacebar) for improved accessibility.\u003c/p\u003e\n"],["\u003cp\u003eThe sample code showcases creating markers with info windows, setting their positions and titles, and handling click events for displaying information.\u003c/p\u003e\n"],["\u003cp\u003eThe example includes code snippets in TypeScript, JavaScript, CSS, and HTML, along with instructions for running the sample locally or trying it online.\u003c/p\u003e\n"]]],["Google's `google.maps.Marker` is deprecated as of February 21st, 2024 (v3.56); users are encouraged to transition to `google.maps.marker.AdvancedMarkerElement` (API v3.53.2+). The provided code creates five accessible markers on a map. Users can navigate between markers using tab and arrow keys and can open info windows by clicking or pressing enter/spacebar. The example uses `google.maps.Marker` and includes TypeScript, JavaScript, CSS, and HTML code samples, along with setup instructions.\n"],null,["| As of February 21st, 2024 (v3.56), google.maps.Marker is deprecated. We encourage you to\n| transition to the new `google.maps.marker.AdvancedMarkerElement` class. Advanced\n| markers provide substantial improvements over the legacy `google.maps.Marker` class.\n| The minimum version of the Maps JavaScript API with `google.maps.marker.AdvancedMarkerElement`\n| is 3.53.2. At this time, google.maps.Marker is not scheduled to be discontinued.\n|\n| [Learn more](/maps/documentation/javascript/advanced-markers/migration)\n\nThis example creates five markers which are accessible. The first marker\nreceives focus when tab is pressed; you can then use the arrow keys to move\nbetween markers. Press tab again to continue moving through the rest of the map\ncontrols. If a marker has an info window, you can open it by clicking, or by\npressing the enter key or space bar. When the info window closes, focus will\nreturn to the associated marker.\n\nRead the\n[documentation](/maps/documentation/javascript/markers#accessible). \n\nTypeScript \n\n```typescript\n// The following example creates five accessible and\n// focusable markers.\n\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n zoom: 12,\n center: { lat: 34.84555, lng: -111.8035 },\n }\n );\n\n // Set LatLng and title text for the markers. The first marker (Boynton Pass)\n // receives the initial focus when tab is pressed. Use arrow keys to\n // move between markers; press tab again to cycle through the map controls.\n const tourStops: [google.maps.LatLngLiteral, string][] = [\n [{ lat: 34.8791806, lng: -111.8265049 }, \"Boynton Pass\"],\n [{ lat: 34.8559195, lng: -111.7988186 }, \"Airport Mesa\"],\n [{ lat: 34.832149, lng: -111.7695277 }, \"Chapel of the Holy Cross\"],\n [{ lat: 34.823736, lng: -111.8001857 }, \"Red Rock Crossing\"],\n [{ lat: 34.800326, lng: -111.7665047 }, \"Bell Rock\"],\n ];\n\n // Create an info window to share between markers.\n const infoWindow = new google.maps.InfoWindow();\n\n // Create the markers.\n tourStops.forEach(([position, title], i) =\u003e {\n const marker = new google.maps.Marker({\n position,\n map,\n title: `${i + 1}. ${title}`,\n label: `${i + 1}`,\n optimized: false,\n });\n\n // Add a click listener for each marker, and set up the info window.\n marker.addListener(\"click\", () =\u003e {\n infoWindow.close();\n infoWindow.setContent(marker.getTitle());\n infoWindow.open(marker.getMap(), marker);\n });\n });\n}\n\ndeclare global {\n interface Window {\n initMap: () =\u003e void;\n }\n}\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/samples/marker-accessibility/index.ts#L8-L59\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\n// The following example creates five accessible and\n// focusable markers.\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n zoom: 12,\n center: { lat: 34.84555, lng: -111.8035 },\n });\n // Set LatLng and title text for the markers. The first marker (Boynton Pass)\n // receives the initial focus when tab is pressed. Use arrow keys to\n // move between markers; press tab again to cycle through the map controls.\n const tourStops = [\n [{ lat: 34.8791806, lng: -111.8265049 }, \"Boynton Pass\"],\n [{ lat: 34.8559195, lng: -111.7988186 }, \"Airport Mesa\"],\n [{ lat: 34.832149, lng: -111.7695277 }, \"Chapel of the Holy Cross\"],\n [{ lat: 34.823736, lng: -111.8001857 }, \"Red Rock Crossing\"],\n [{ lat: 34.800326, lng: -111.7665047 }, \"Bell Rock\"],\n ];\n // Create an info window to share between markers.\n const infoWindow = new google.maps.InfoWindow();\n\n // Create the markers.\n tourStops.forEach(([position, title], i) =\u003e {\n const marker = new google.maps.Marker({\n position,\n map,\n title: `${i + 1}. ${title}`,\n label: `${i + 1}`,\n optimized: false,\n });\n\n // Add a click listener for each marker, and set up the info window.\n marker.addListener(\"click\", () =\u003e {\n infoWindow.close();\n infoWindow.setContent(marker.getTitle());\n infoWindow.open(marker.getMap(), marker);\n });\n });\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/marker-accessibility/docs/index.js#L7-L46\n```\n| **Note:** The JavaScript is compiled from the TypeScript snippet.\n\nCSS \n\n```css\n/* \n * Always set the map height explicitly to define the size of the div element\n * that contains the map. \n */\n#map {\n height: 100%;\n}\n\n/* \n * Optional: Makes the sample page fill the window. \n */\nhtml,\nbody {\n height: 100%;\n margin: 0;\n padding: 0;\n}\nhttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/marker-accessibility/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eMarker Accessibility\u003c/title\u003e\n\n \u003clink rel=\"stylesheet\" type=\"text/css\" href=\"./style.css\" /\u003e\n \u003cscript type=\"module\" src=\"./index.js\"\u003e\u003c/script\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003cdiv id=\"map\"\u003e\u003c/div\u003e\n\n \u003c!-- \n The `defer` attribute causes the script to execute after the full HTML\n document has been parsed. For non-blocking uses, avoiding race conditions,\n and consistent behavior across browsers, consider loading using Promises. See\n https://developers.google.com/maps/documentation/javascript/load-maps-js-api\n for more information.\n --\u003e\n \u003cscript\n src=\"https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly\"\n defer\n \u003e\u003c/script\u003e\n \u003c/body\u003e\n\u003c/html\u003ehttps://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/marker-accessibility/docs/index.html#L8-L30\n```\n\nTry Sample \n[JSFiddle.net](https://jsfiddle.net/gh/get/library/pure/googlemaps/js-samples/tree/master/dist/samples/marker-accessibility/jsfiddle) [Google Cloud Shell](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fgooglemaps%2Fjs-samples&cloudshell_git_branch=sample-marker-accessibility&cloudshell_tutorial=cloud_shell_instructions.md&cloudshell_workspace=.)\n\nClone Sample\n\n\nGit and Node.js are required to run this sample locally. Follow these [instructions](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) to install Node.js and NPM. The following commands clone, install dependencies and start the sample application. \n\n git clone -b sample-marker-accessibility https://github.com/googlemaps/js-samples.git\n cd js-samples\n npm i\n npm start\n\n\nOther samples can be tried by switching to any branch beginning with `sample-`\u003cvar translate=\"no\"\u003eSAMPLE_NAME\u003c/var\u003e. \n\n git checkout sample-\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nx\"\u003eSAMPLE_NAME\u003c/span\u003e\u003c/var\u003e\n npm i\n npm start"]]
