asyncfunctioninit(){// Make sure the Marker3DElement is included.const{Map3DElement,Marker3DElement}=awaitgoogle.maps.importLibrary("maps3d");constmap=newMap3DElement({center:{lat:37.4239163,lng:-122.0947209,altitude:0},tilt:67.5,range:1000,mode:'SATELLITE'});constmarker=newMarker3DElement({position:{lat:37.4239163,lng:-122.0947209,altitude:50},// (Required) Marker must have a lat / lng, but doesn't need an altitude.altitudeMode:"ABSOLUTE",// (Optional) Treated as CLAMP_TO_GROUND if omitted.extruded:true,// (Optional) Draws line from ground to the bottom of the marker.label:"Basic Marker"// (Optional) Add a label to the marker.});map.append(marker);// The marker must be appended to the map.document.body.append(map);}init();
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\u003eLearn how to add simple or customized markers, including labels, scaling, and color adjustments to Photorealistic 3D Maps.\u003c/p\u003e\n"],["\u003cp\u003eDiscover techniques to replace default icons with custom graphics using SVGs, PNGs, or Place icons, enhancing marker visualization.\u003c/p\u003e\n"],["\u003cp\u003eExplore creating interactive markers that respond to user clicks, providing an engaging user experience in the 3D map environment.\u003c/p\u003e\n"],["\u003cp\u003eUnderstand how to extrude markers to add a third dimension, allowing for more realistic and informative map representations.\u003c/p\u003e\n"],["\u003cp\u003eGain insights into controlling marker collision behavior, ensuring optimal marker visibility and preventing overlapping in crowded areas, and understand how to remove markers from the map when necessary.\u003c/p\u003e\n"]]],[],null,["The following example creates a marker over the Google office in Mountain View.\n\n\u003cbr /\u003e\n\nRead the [documentation](/maps/documentation/javascript/3d/marker-overview). \n\nJavaScript \n\n```javascript\nasync function init() {\n // Make sure the Marker3DElement is included.\n const { Map3DElement, Marker3DElement } = await google.maps.importLibrary(\"maps3d\");\n const map = new Map3DElement({\n center: { lat: 37.4239163, lng: -122.0947209, altitude: 0 },\n tilt: 67.5,\n range: 1000,\n mode: 'SATELLITE'\n });\n const marker = new Marker3DElement({\n position: { lat: 37.4239163, lng: -122.0947209, altitude: 50 }, // (Required) Marker must have a lat / lng, but doesn't need an altitude.\n altitudeMode: \"ABSOLUTE\", // (Optional) Treated as CLAMP_TO_GROUND if omitted.\n extruded: true, // (Optional) Draws line from ground to the bottom of the marker.\n label: \"Basic Marker\" // (Optional) Add a label to the marker.\n });\n map.append(marker); // The marker must be appended to the map.\n document.body.append(map);\n}\ninit();https://github.com/googlemaps-samples/js-api-samples/blob/5f4e6decfaf59cd69918bbf4e6338de03a63a5ba/dist/samples/3d-simple-marker/docs/index.js#L9-L27\n```\n| **Note:** The JavaScript is compiled from the TypeScript snippet.\n\nCSS \n\n```css\n/* * Always set the map height explicitly to define the size of the div element\n * that contains the map. \n */\nhtml,\nbody {\n height: 100%;\n margin: 0;\n padding: 0;\n}https://github.com/googlemaps-samples/js-api-samples/blob/5f4e6decfaf59cd69918bbf4e6338de03a63a5ba/dist/samples/3d-simple-marker/docs/style.css#L7-L15\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eMap\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!-- prettier-ignore --\u003e\n \u003cscript\u003e(g=\u003e{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=()=\u003eh||(h=new Promise(async(f,n)=\u003e{await (a=m.createElement(\"script\"));e.set(\"libraries\",[...r]+\"\");for(k in g)e.set(k.replace(/[A-Z]/g,t=\u003e\"_\"+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=()=\u003eh=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)=\u003er.add(f)&&u().then(()=\u003ed[l](f,...n))})\n ({key: \"AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8\", v: \"beta\",});\u003c/script\u003e\n \u003c/body\u003e\n\u003c/html\u003ehttps://github.com/googlemaps-samples/js-api-samples/blob/5f4e6decfaf59cd69918bbf4e6338de03a63a5ba/dist/samples/3d-simple-marker/docs/index.html#L8-L22\n```\n\nTry Sample \n[JSFiddle.net](https://jsfiddle.net/gh/get/library/pure/googlemaps-samples/js-api-samples/tree/main/dist/samples/3d-simple-marker/jsfiddle)\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 https://github.com/googlemaps-samples/js-api-samples.git\n cd samples/3d-simple-marker\n npm i\n npm start"]]
