/* * This demo demonstrates how to replace default map tiles with custom imagery. * In this case, the CoordMapType displays gray tiles annotated with the tile * coordinates. * * Try panning and zooming the map to see how the coordinates change. */classCoordMapType{tileSize:google.maps.Size;maxZoom=19;name="Tile #s";alt="Tile Coordinate Map Type";constructor(tileSize:google.maps.Size){this.tileSize=tileSize;}getTile(coord:google.maps.Point,zoom:number,ownerDocument:Document):HTMLElement{constdiv=ownerDocument.createElement("div");div.innerHTML=String(coord);div.style.width=this.tileSize.width+"px";div.style.height=this.tileSize.height+"px";div.style.fontSize="10";div.style.borderStyle="solid";div.style.borderWidth="1px";div.style.borderColor="#AAAAAA";div.style.backgroundColor="#E5E3DF";returndiv;}releaseTile(tile:HTMLElement):void{}}functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{zoom:10,center:{lat:41.85,lng:-87.65},streetViewControl:false,mapTypeId:"coordinate",mapTypeControlOptions:{mapTypeIds:["coordinate","roadmap"],style:google.maps.MapTypeControlStyle.DROPDOWN_MENU,},});map.addListener("maptypeid_changed",()=>{constshowStreetViewControl=(map.getMapTypeId()asstring)!=="coordinate";map.setOptions({streetViewControl:showStreetViewControl,});});// Now attach the coordinate map type to the map's registry.map.mapTypes.set("coordinate",newCoordMapType(newgoogle.maps.Size(256,256)));}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
/* * This demo demonstrates how to replace default map tiles with custom imagery. * In this case, the CoordMapType displays gray tiles annotated with the tile * coordinates. * * Try panning and zooming the map to see how the coordinates change. */classCoordMapType{tileSize;maxZoom=19;name="Tile #s";alt="Tile Coordinate Map Type";constructor(tileSize){this.tileSize=tileSize;}getTile(coord,zoom,ownerDocument){constdiv=ownerDocument.createElement("div");div.innerHTML=String(coord);div.style.width=this.tileSize.width+"px";div.style.height=this.tileSize.height+"px";div.style.fontSize="10";div.style.borderStyle="solid";div.style.borderWidth="1px";div.style.borderColor="#AAAAAA";div.style.backgroundColor="#E5E3DF";returndiv;}releaseTile(tile){}}functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{zoom:10,center:{lat:41.85,lng:-87.65},streetViewControl:false,mapTypeId:"coordinate",mapTypeControlOptions:{mapTypeIds:["coordinate","roadmap"],style:google.maps.MapTypeControlStyle.DROPDOWN_MENU,},});map.addListener("maptypeid_changed",()=>{constshowStreetViewControl=map.getMapTypeId()!=="coordinate";map.setOptions({streetViewControl:showStreetViewControl,});});// Now attach the coordinate map type to the map's registry.map.mapTypes.set("coordinate",newCoordMapType(newgoogle.maps.Size(256,256)),);}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>Basic Map Types</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 these instructions to 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-08-28 UTC."],[[["\u003cp\u003eThis example demonstrates replacing default map tiles with custom imagery displaying tile coordinates.\u003c/p\u003e\n"],["\u003cp\u003eThe custom map type uses gray tiles annotated with the tile coordinates for easy identification.\u003c/p\u003e\n"],["\u003cp\u003eUsers can pan and zoom the map to observe how tile coordinates change dynamically.\u003c/p\u003e\n"],["\u003cp\u003eThe sample provides code in TypeScript, JavaScript, CSS, and HTML for implementation.\u003c/p\u003e\n"],["\u003cp\u003eStreet View control is disabled when the custom "coordinate" map type is active.\u003c/p\u003e\n"]]],[],null,["This example replaces the default map tiles with custom imagery that displays\nthe map's tile coordinates on a series of gray tiles.\n\nRead the [documentation](/maps/documentation/javascript/maptypes#BasicMapTypes). \n\nTypeScript \n\n```typescript\n/*\n * This demo demonstrates how to replace default map tiles with custom imagery.\n * In this case, the CoordMapType displays gray tiles annotated with the tile\n * coordinates.\n *\n * Try panning and zooming the map to see how the coordinates change.\n */\n\nclass CoordMapType {\n tileSize: google.maps.Size;\n maxZoom = 19;\n name = \"Tile #s\";\n alt = \"Tile Coordinate Map Type\";\n\n constructor(tileSize: google.maps.Size) {\n this.tileSize = tileSize;\n }\n\n getTile(\n coord: google.maps.Point,\n zoom: number,\n ownerDocument: Document\n ): HTMLElement {\n const div = ownerDocument.createElement(\"div\");\n\n div.innerHTML = String(coord);\n div.style.width = this.tileSize.width + \"px\";\n div.style.height = this.tileSize.height + \"px\";\n div.style.fontSize = \"10\";\n div.style.borderStyle = \"solid\";\n div.style.borderWidth = \"1px\";\n div.style.borderColor = \"#AAAAAA\";\n div.style.backgroundColor = \"#E5E3DF\";\n return div;\n }\n\n releaseTile(tile: HTMLElement): void {}\n}\n\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n zoom: 10,\n center: { lat: 41.85, lng: -87.65 },\n streetViewControl: false,\n mapTypeId: \"coordinate\",\n mapTypeControlOptions: {\n mapTypeIds: [\"coordinate\", \"roadmap\"],\n style: google.maps.MapTypeControlStyle.DROPDOWN_MENU,\n },\n }\n );\n\n map.addListener(\"maptypeid_changed\", () =\u003e {\n const showStreetViewControl =\n (map.getMapTypeId() as string) !== \"coordinate\";\n\n map.setOptions({\n streetViewControl: showStreetViewControl,\n });\n });\n\n // Now attach the coordinate map type to the map's registry.\n map.mapTypes.set(\n \"coordinate\",\n new CoordMapType(new google.maps.Size(256, 256))\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/maptype-base/index.ts#L8-L83\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\n/*\n * This demo demonstrates how to replace default map tiles with custom imagery.\n * In this case, the CoordMapType displays gray tiles annotated with the tile\n * coordinates.\n *\n * Try panning and zooming the map to see how the coordinates change.\n */\nclass CoordMapType {\n tileSize;\n maxZoom = 19;\n name = \"Tile #s\";\n alt = \"Tile Coordinate Map Type\";\n constructor(tileSize) {\n this.tileSize = tileSize;\n }\n getTile(coord, zoom, ownerDocument) {\n const div = ownerDocument.createElement(\"div\");\n\n div.innerHTML = String(coord);\n div.style.width = this.tileSize.width + \"px\";\n div.style.height = this.tileSize.height + \"px\";\n div.style.fontSize = \"10\";\n div.style.borderStyle = \"solid\";\n div.style.borderWidth = \"1px\";\n div.style.borderColor = \"#AAAAAA\";\n div.style.backgroundColor = \"#E5E3DF\";\n return div;\n }\n releaseTile(tile) {}\n}\n\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n zoom: 10,\n center: { lat: 41.85, lng: -87.65 },\n streetViewControl: false,\n mapTypeId: \"coordinate\",\n mapTypeControlOptions: {\n mapTypeIds: [\"coordinate\", \"roadmap\"],\n style: google.maps.MapTypeControlStyle.DROPDOWN_MENU,\n },\n });\n\n map.addListener(\"maptypeid_changed\", () =\u003e {\n const showStreetViewControl = map.getMapTypeId() !== \"coordinate\";\n\n map.setOptions({\n streetViewControl: showStreetViewControl,\n });\n });\n // Now attach the coordinate map type to the map's registry.\n map.mapTypes.set(\n \"coordinate\",\n new CoordMapType(new google.maps.Size(256, 256)),\n );\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/maptype-base/docs/index.js#L7-L64\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/maptype-base/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eBasic Map Types\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/maptype-base/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/maptype-base/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-maptype-base&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-maptype-base 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"]]