letmap:google.maps.Map;constchicago={lat:41.85,lng:-87.65};/*** Creates a control that recenters the map on Chicago.*/functioncreateCenterControl(map){constcontrolButton=document.createElement('button');// Set CSS for the control.controlButton.style.backgroundColor='#fff';controlButton.style.border='2px solid #fff';controlButton.style.borderRadius='3px';controlButton.style.boxShadow='0 2px 6px rgba(0,0,0,.3)';controlButton.style.color='rgb(25,25,25)';controlButton.style.cursor='pointer';controlButton.style.fontFamily='Roboto,Arial,sans-serif';controlButton.style.fontSize='16px';controlButton.style.lineHeight='38px';controlButton.style.margin='8px 0 22px';controlButton.style.padding='0 5px';controlButton.style.textAlign='center';controlButton.textContent='Center Map';controlButton.title='Click to recenter the map';controlButton.type='button';// Setup the click event listeners: simply set the map to Chicago.controlButton.addEventListener('click',()=>{map.setCenter(chicago);});returncontrolButton;}functioninitMap(){map=newgoogle.maps.Map(document.getElementById('map')asHTMLElement,{zoom:12,center:chicago,});// Create the DIV to hold the control.constcenterControlDiv=document.createElement('div');// Create the control.constcenterControl=createCenterControl(map);// Append the control to the DIV.centerControlDiv.appendChild(centerControl);map.controls[google.maps.ControlPosition.TOP_CENTER].push(centerControlDiv);}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
letmap;constchicago={lat:41.85,lng:-87.65};/*** Creates a control that recenters the map on Chicago.*/functioncreateCenterControl(map){constcontrolButton=document.createElement("button");// Set CSS for the control.controlButton.style.backgroundColor="#fff";controlButton.style.border="2px solid #fff";controlButton.style.borderRadius="3px";controlButton.style.boxShadow="0 2px 6px rgba(0,0,0,.3)";controlButton.style.color="rgb(25,25,25)";controlButton.style.cursor="pointer";controlButton.style.fontFamily="Roboto,Arial,sans-serif";controlButton.style.fontSize="16px";controlButton.style.lineHeight="38px";controlButton.style.margin="8px 0 22px";controlButton.style.padding="0 5px";controlButton.style.textAlign="center";controlButton.textContent="Center Map";controlButton.title="Click to recenter the map";controlButton.type="button";// Setup the click event listeners: simply set the map to Chicago.controlButton.addEventListener("click",()=>{map.setCenter(chicago);});returncontrolButton;}functioninitMap(){map=newgoogle.maps.Map(document.getElementById("map"),{zoom:12,center:chicago,});// Create the DIV to hold the control.constcenterControlDiv=document.createElement("div");// Create the control.constcenterControl=createCenterControl(map);// Append the control to the DIV.centerControlDiv.appendChild(centerControl);map.controls[google.maps.ControlPosition.TOP_CENTER].push(centerControlDiv);}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>Custom Controls</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 a custom control on a Google Map that recenters the map to Chicago.\u003c/p\u003e\n"],["\u003cp\u003eThe control is a button labeled "Center Map" and is positioned at the top center of the map.\u003c/p\u003e\n"],["\u003cp\u003eWhen clicked, the button triggers a function to set the map's center to the coordinates of Chicago.\u003c/p\u003e\n"],["\u003cp\u003eThis example uses TypeScript and JavaScript to create the custom control and integrate it with the Google Maps API.\u003c/p\u003e\n"]]],[],null,["This example creates a map with a \"Center Map\" button, which will pan the map to\nbe centered on Chicago.\n\nRead the\n[documentation](/maps/documentation/javascript/controls#CustomControls). \n\nTypeScript \n\n```typescript\nlet map: google.maps.Map;\n\nconst chicago = { lat: 41.85, lng: -87.65 };\n\n/**\n * Creates a control that recenters the map on Chicago.\n */\n function createCenterControl(map) {\n const controlButton = document.createElement('button');\n\n // Set CSS for the control.\n controlButton.style.backgroundColor = '#fff';\n controlButton.style.border = '2px solid #fff';\n controlButton.style.borderRadius = '3px';\n controlButton.style.boxShadow = '0 2px 6px rgba(0,0,0,.3)';\n controlButton.style.color = 'rgb(25,25,25)';\n controlButton.style.cursor = 'pointer';\n controlButton.style.fontFamily = 'Roboto,Arial,sans-serif';\n controlButton.style.fontSize = '16px';\n controlButton.style.lineHeight = '38px';\n controlButton.style.margin = '8px 0 22px';\n controlButton.style.padding = '0 5px';\n controlButton.style.textAlign = 'center';\n\n controlButton.textContent = 'Center Map';\n controlButton.title = 'Click to recenter the map';\n controlButton.type = 'button';\n\n // Setup the click event listeners: simply set the map to Chicago.\n controlButton.addEventListener('click', () =\u003e {\n map.setCenter(chicago);\n });\n\n return controlButton;\n}\n\nfunction initMap() {\n map = new google.maps.Map(document.getElementById('map') as HTMLElement, {\n zoom: 12,\n center: chicago,\n });\n\n // Create the DIV to hold the control.\n const centerControlDiv = document.createElement('div');\n // Create the control.\n const centerControl = createCenterControl(map);\n // Append the control to the DIV.\n centerControlDiv.appendChild(centerControl);\n\n map.controls[google.maps.ControlPosition.TOP_CENTER].push(centerControlDiv);\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/control-custom/index.ts#L8-L65\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\nlet map;\nconst chicago = { lat: 41.85, lng: -87.65 };\n\n/**\n * Creates a control that recenters the map on Chicago.\n */\nfunction createCenterControl(map) {\n const controlButton = document.createElement(\"button\");\n\n // Set CSS for the control.\n controlButton.style.backgroundColor = \"#fff\";\n controlButton.style.border = \"2px solid #fff\";\n controlButton.style.borderRadius = \"3px\";\n controlButton.style.boxShadow = \"0 2px 6px rgba(0,0,0,.3)\";\n controlButton.style.color = \"rgb(25,25,25)\";\n controlButton.style.cursor = \"pointer\";\n controlButton.style.fontFamily = \"Roboto,Arial,sans-serif\";\n controlButton.style.fontSize = \"16px\";\n controlButton.style.lineHeight = \"38px\";\n controlButton.style.margin = \"8px 0 22px\";\n controlButton.style.padding = \"0 5px\";\n controlButton.style.textAlign = \"center\";\n controlButton.textContent = \"Center Map\";\n controlButton.title = \"Click to recenter the map\";\n controlButton.type = \"button\";\n // Setup the click event listeners: simply set the map to Chicago.\n controlButton.addEventListener(\"click\", () =\u003e {\n map.setCenter(chicago);\n });\n return controlButton;\n}\n\nfunction initMap() {\n map = new google.maps.Map(document.getElementById(\"map\"), {\n zoom: 12,\n center: chicago,\n });\n\n // Create the DIV to hold the control.\n const centerControlDiv = document.createElement(\"div\");\n // Create the control.\n const centerControl = createCenterControl(map);\n\n // Append the control to the DIV.\n centerControlDiv.appendChild(centerControl);\n map.controls[google.maps.ControlPosition.TOP_CENTER].push(centerControlDiv);\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/control-custom/docs/index.js#L7-L55\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/control-custom/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eCustom Controls\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/control-custom/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/control-custom/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-control-custom&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-control-custom 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"]]
