// The following example creates complex markers to indicate beaches near// Sydney, NSW, Australia. Note that the anchor is set to (0,32) to correspond// to the base of the flagpole.functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{zoom:10,center:{lat:-33.9,lng:151.2},});setMarkers(map);}// Data for the markers consisting of a name, a LatLng and a zIndex for the// order in which these markers should display on top of each other.constbeaches:[string,number,number,number][]=[["Bondi Beach",-33.890542,151.274856,4],["Coogee Beach",-33.923036,151.259052,5],["Cronulla Beach",-34.028249,151.157507,3],["Manly Beach",-33.80010128657071,151.28747820854187,2],["Maroubra Beach",-33.950198,151.259302,1],];functionsetMarkers(map:google.maps.Map){// Adds markers to the map.// Marker sizes are expressed as a Size of X,Y where the origin of the image// (0,0) is located in the top left of the image.// Origins, anchor positions and coordinates of the marker increase in the X// direction to the right and in the Y direction down.constimage={url:"https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png",// This marker is 20 pixels wide by 32 pixels high.size:newgoogle.maps.Size(20,32),// The origin for this image is (0, 0).origin:newgoogle.maps.Point(0,0),// The anchor for this image is the base of the flagpole at (0, 32).anchor:newgoogle.maps.Point(0,32),};// Shapes define the clickable region of the icon. The type defines an HTML// <area> element 'poly' which traces out a polygon as a series of X,Y points.// The final coordinate closes the poly by connecting to the first coordinate.constshape={coords:[1,1,1,20,18,20,18,1],type:"poly",};for(leti=0;i<beaches.length;i++){constbeach=beaches[i];newgoogle.maps.Marker({position:{lat:beach[1],lng:beach[2]},map,icon:image,shape:shape,title:beach[0],zIndex:beach[3],});}}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
// The following example creates complex markers to indicate beaches near// Sydney, NSW, Australia. Note that the anchor is set to (0,32) to correspond// to the base of the flagpole.functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{zoom:10,center:{lat:-33.9,lng:151.2},});setMarkers(map);}// Data for the markers consisting of a name, a LatLng and a zIndex for the// order in which these markers should display on top of each other.constbeaches=[["Bondi Beach",-33.890542,151.274856,4],["Coogee Beach",-33.923036,151.259052,5],["Cronulla Beach",-34.028249,151.157507,3],["Manly Beach",-33.80010128657071,151.28747820854187,2],["Maroubra Beach",-33.950198,151.259302,1],];functionsetMarkers(map){// Adds markers to the map.// Marker sizes are expressed as a Size of X,Y where the origin of the image// (0,0) is located in the top left of the image.// Origins, anchor positions and coordinates of the marker increase in the X// direction to the right and in the Y direction down.constimage={url:"https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png",// This marker is 20 pixels wide by 32 pixels high.size:newgoogle.maps.Size(20,32),// The origin for this image is (0, 0).origin:newgoogle.maps.Point(0,0),// The anchor for this image is the base of the flagpole at (0, 32).anchor:newgoogle.maps.Point(0,32),};// Shapes define the clickable region of the icon. The type defines an HTML// <area> element 'poly' which traces out a polygon as a series of X,Y points.// The final coordinate closes the poly by connecting to the first coordinate.constshape={coords:[1,1,1,20,18,20,18,1],type:"poly",};for(leti=0;i<beaches.length;i++){constbeach=beaches[i];newgoogle.maps.Marker({position:{lat:beach[1],lng:beach[2]},map,icon:image,shape:shape,title:beach[0],zIndex:beach[3],});}}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>Complex Marker Icons</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\u003eThis example demonstrates how to create complex markers on a Google Map using the \u003ccode\u003egoogle.maps.Marker\u003c/code\u003e class.\u003c/p\u003e\n"],["\u003cp\u003eThe markers are customized with images, shapes, and specific coordinates to represent beaches near Sydney, Australia.\u003c/p\u003e\n"],["\u003cp\u003eThe code provides examples in both JavaScript and TypeScript, along with CSS and HTML for setting up the map display.\u003c/p\u003e\n"],["\u003cp\u003eAlthough \u003ccode\u003egoogle.maps.Marker\u003c/code\u003e is deprecated in favor of \u003ccode\u003egoogle.maps.marker.AdvancedMarkerElement\u003c/code\u003e, it's still functional and used in this example.\u003c/p\u003e\n"]]],["`google.maps.Marker` is deprecated as of February 21st, 2024 (v3.56); users should transition to `google.maps.marker.AdvancedMarkerElement`, available in API version 3.53.2 or later. The provided code example demonstrates creating complex markers for beaches near Sydney using `google.maps.Marker`. This code initializes a map, defines beach data, and sets custom markers with properties like size, origin, anchor, and clickable shape. It sets the `initMap` function to the window to enable the callback in the maps API.\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 complex markers to indicate beaches near Sydney, New South\nWales, Australia.\n\nRead the [documentation](/maps/documentation/javascript/markers#complex_icons). \n\nTypeScript \n\n```typescript\n// The following example creates complex markers to indicate beaches near\n// Sydney, NSW, Australia. Note that the anchor is set to (0,32) to correspond\n// to the base of the flagpole.\n\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n zoom: 10,\n center: { lat: -33.9, lng: 151.2 },\n }\n );\n\n setMarkers(map);\n}\n\n// Data for the markers consisting of a name, a LatLng and a zIndex for the\n// order in which these markers should display on top of each other.\nconst beaches: [string, number, number, number][] = [\n [\"Bondi Beach\", -33.890542, 151.274856, 4],\n [\"Coogee Beach\", -33.923036, 151.259052, 5],\n [\"Cronulla Beach\", -34.028249, 151.157507, 3],\n [\"Manly Beach\", -33.80010128657071, 151.28747820854187, 2],\n [\"Maroubra Beach\", -33.950198, 151.259302, 1],\n];\n\nfunction setMarkers(map: google.maps.Map) {\n // Adds markers to the map.\n\n // Marker sizes are expressed as a Size of X,Y where the origin of the image\n // (0,0) is located in the top left of the image.\n\n // Origins, anchor positions and coordinates of the marker increase in the X\n // direction to the right and in the Y direction down.\n const image = {\n url: \"https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png\",\n // This marker is 20 pixels wide by 32 pixels high.\n size: new google.maps.Size(20, 32),\n // The origin for this image is (0, 0).\n origin: new google.maps.Point(0, 0),\n // The anchor for this image is the base of the flagpole at (0, 32).\n anchor: new google.maps.Point(0, 32),\n };\n // Shapes define the clickable region of the icon. The type defines an HTML\n // \u003carea\u003e element 'poly' which traces out a polygon as a series of X,Y points.\n // The final coordinate closes the poly by connecting to the first coordinate.\n const shape = {\n coords: [1, 1, 1, 20, 18, 20, 18, 1],\n type: \"poly\",\n };\n\n for (let i = 0; i \u003c beaches.length; i++) {\n const beach = beaches[i];\n\n new google.maps.Marker({\n position: { lat: beach[1], lng: beach[2] },\n map,\n icon: image,\n shape: shape,\n title: beach[0],\n zIndex: beach[3],\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/icon-complex/index.ts#L8-L78\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 complex markers to indicate beaches near\n// Sydney, NSW, Australia. Note that the anchor is set to (0,32) to correspond\n// to the base of the flagpole.\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n zoom: 10,\n center: { lat: -33.9, lng: 151.2 },\n });\n\n setMarkers(map);\n}\n\n// Data for the markers consisting of a name, a LatLng and a zIndex for the\n// order in which these markers should display on top of each other.\nconst beaches = [\n [\"Bondi Beach\", -33.890542, 151.274856, 4],\n [\"Coogee Beach\", -33.923036, 151.259052, 5],\n [\"Cronulla Beach\", -34.028249, 151.157507, 3],\n [\"Manly Beach\", -33.80010128657071, 151.28747820854187, 2],\n [\"Maroubra Beach\", -33.950198, 151.259302, 1],\n];\n\nfunction setMarkers(map) {\n // Adds markers to the map.\n // Marker sizes are expressed as a Size of X,Y where the origin of the image\n // (0,0) is located in the top left of the image.\n // Origins, anchor positions and coordinates of the marker increase in the X\n // direction to the right and in the Y direction down.\n const image = {\n url: \"https://developers.google.com/maps/documentation/javascript/examples/full/images/beachflag.png\",\n // This marker is 20 pixels wide by 32 pixels high.\n size: new google.maps.Size(20, 32),\n // The origin for this image is (0, 0).\n origin: new google.maps.Point(0, 0),\n // The anchor for this image is the base of the flagpole at (0, 32).\n anchor: new google.maps.Point(0, 32),\n };\n // Shapes define the clickable region of the icon. The type defines an HTML\n // \u003carea\u003e element 'poly' which traces out a polygon as a series of X,Y points.\n // The final coordinate closes the poly by connecting to the first coordinate.\n const shape = {\n coords: [1, 1, 1, 20, 18, 20, 18, 1],\n type: \"poly\",\n };\n\n for (let i = 0; i \u003c beaches.length; i++) {\n const beach = beaches[i];\n\n new google.maps.Marker({\n position: { lat: beach[1], lng: beach[2] },\n map,\n icon: image,\n shape: shape,\n title: beach[0],\n zIndex: beach[3],\n });\n }\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/icon-complex/docs/index.js#L7-L66\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/icon-complex/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eComplex Marker Icons\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/icon-complex/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/icon-complex/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-icon-complex&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-icon-complex 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"]]
