functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{center:{lat:0,lng:0},zoom:1,streetViewControl:false,mapTypeControlOptions:{mapTypeIds:["moon"],},});constmoonMapType=newgoogle.maps.ImageMapType({getTileUrl:function(coord,zoom):string{constnormalizedCoord=getNormalizedCoord(coord,zoom);if(!normalizedCoord){return"";}constbound=Math.pow(2,zoom);return("https://mw1.google.com/mw-planetary/lunar/lunarmaps_v1/clem_bw"+"/"+zoom+"/"+normalizedCoord.x+"/"+(bound-normalizedCoord.y-1)+".jpg");},tileSize:newgoogle.maps.Size(256,256),maxZoom:9,minZoom:0,// @ts-ignore TODO 'radius' does not exist in type 'ImageMapTypeOptions'radius:1738000,name:"Moon",});map.mapTypes.set("moon",moonMapType);map.setMapTypeId("moon");}// Normalizes the coords that tiles repeat across the x axis (horizontally)// like the standard Google map tiles.functiongetNormalizedCoord(coord,zoom){consty=coord.y;letx=coord.x;// tile range in one direction range is dependent on zoom level// 0 = 1 tile, 1 = 2 tiles, 2 = 4 tiles, 3 = 8 tiles, etcconsttileRange=1<<zoom;// don't repeat across y-axis (vertically)if(y<0||y>=tileRange){returnnull;}// repeat across x-axisif(x<0||x>=tileRange){x=((x%tileRange)+tileRange)%tileRange;}return{x:x,y:y};}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{center:{lat:0,lng:0},zoom:1,streetViewControl:false,mapTypeControlOptions:{mapTypeIds:["moon"],},});constmoonMapType=newgoogle.maps.ImageMapType({getTileUrl:function(coord,zoom){constnormalizedCoord=getNormalizedCoord(coord,zoom);if(!normalizedCoord){return"";}constbound=Math.pow(2,zoom);return("https://mw1.google.com/mw-planetary/lunar/lunarmaps_v1/clem_bw"+"/"+zoom+"/"+normalizedCoord.x+"/"+(bound-normalizedCoord.y-1)+".jpg");},tileSize:newgoogle.maps.Size(256,256),maxZoom:9,minZoom:0,// @ts-ignore TODO 'radius' does not exist in type 'ImageMapTypeOptions'radius:1738000,name:"Moon",});map.mapTypes.set("moon",moonMapType);map.setMapTypeId("moon");}// Normalizes the coords that tiles repeat across the x axis (horizontally)// like the standard Google map tiles.functiongetNormalizedCoord(coord,zoom){consty=coord.y;letx=coord.x;// tile range in one direction range is dependent on zoom level// 0 = 1 tile, 1 = 2 tiles, 2 = 4 tiles, 3 = 8 tiles, etcconsttileRange=1<<zoom;// don't repeat across y-axis (vertically)if(y<0||y>=tileRange){returnnull;}// repeat across x-axisif(x<0||x>=tileRange){x=((x%tileRange)+tileRange)%tileRange;}return{x:x,y:y};}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>Image 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 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 map type using images of the moon's surface.\u003c/p\u003e\n"],["\u003cp\u003eIt uses the \u003ccode\u003eImageMapType\u003c/code\u003e class to define the map type and \u003ccode\u003egetTileUrl\u003c/code\u003e function to fetch image tiles.\u003c/p\u003e\n"],["\u003cp\u003eThe example provides code in both JavaScript and TypeScript.\u003c/p\u003e\n"],["\u003cp\u003eThe map is initialized with a center point at latitude 0 and longitude 0, with an initial zoom level of 1.\u003c/p\u003e\n"]]],[],null,["This example uses image tiles of the moon's surface to create a map.\n\nRead the [documentation](/maps/documentation/javascript/maptypes#ImageMapTypes). \n\nTypeScript \n\n```typescript\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n center: { lat: 0, lng: 0 },\n zoom: 1,\n streetViewControl: false,\n mapTypeControlOptions: {\n mapTypeIds: [\"moon\"],\n },\n }\n );\n\n const moonMapType = new google.maps.ImageMapType({\n getTileUrl: function (coord, zoom): string {\n const normalizedCoord = getNormalizedCoord(coord, zoom);\n\n if (!normalizedCoord) {\n return \"\";\n }\n\n const bound = Math.pow(2, zoom);\n return (\n \"https://mw1.google.com/mw-planetary/lunar/lunarmaps_v1/clem_bw\" +\n \"/\" +\n zoom +\n \"/\" +\n normalizedCoord.x +\n \"/\" +\n (bound - normalizedCoord.y - 1) +\n \".jpg\"\n );\n },\n tileSize: new google.maps.Size(256, 256),\n maxZoom: 9,\n minZoom: 0,\n // @ts-ignore TODO 'radius' does not exist in type 'ImageMapTypeOptions'\n radius: 1738000,\n name: \"Moon\",\n });\n\n map.mapTypes.set(\"moon\", moonMapType);\n map.setMapTypeId(\"moon\");\n}\n\n// Normalizes the coords that tiles repeat across the x axis (horizontally)\n// like the standard Google map tiles.\nfunction getNormalizedCoord(coord, zoom) {\n const y = coord.y;\n let x = coord.x;\n\n // tile range in one direction range is dependent on zoom level\n // 0 = 1 tile, 1 = 2 tiles, 2 = 4 tiles, 3 = 8 tiles, etc\n const tileRange = 1 \u003c\u003c zoom;\n\n // don't repeat across y-axis (vertically)\n if (y \u003c 0 || y \u003e= tileRange) {\n return null;\n }\n\n // repeat across x-axis\n if (x \u003c 0 || x \u003e= tileRange) {\n x = ((x % tileRange) + tileRange) % tileRange;\n }\n\n return { x: x, y: y };\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-image/index.ts#L8-L81\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\nJavaScript \n\n```javascript\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n center: { lat: 0, lng: 0 },\n zoom: 1,\n streetViewControl: false,\n mapTypeControlOptions: {\n mapTypeIds: [\"moon\"],\n },\n });\n const moonMapType = new google.maps.ImageMapType({\n getTileUrl: function (coord, zoom) {\n const normalizedCoord = getNormalizedCoord(coord, zoom);\n\n if (!normalizedCoord) {\n return \"\";\n }\n\n const bound = Math.pow(2, zoom);\n return (\n \"https://mw1.google.com/mw-planetary/lunar/lunarmaps_v1/clem_bw\" +\n \"/\" +\n zoom +\n \"/\" +\n normalizedCoord.x +\n \"/\" +\n (bound - normalizedCoord.y - 1) +\n \".jpg\"\n );\n },\n tileSize: new google.maps.Size(256, 256),\n maxZoom: 9,\n minZoom: 0,\n // @ts-ignore TODO 'radius' does not exist in type 'ImageMapTypeOptions'\n radius: 1738000,\n name: \"Moon\",\n });\n\n map.mapTypes.set(\"moon\", moonMapType);\n map.setMapTypeId(\"moon\");\n}\n\n// Normalizes the coords that tiles repeat across the x axis (horizontally)\n// like the standard Google map tiles.\nfunction getNormalizedCoord(coord, zoom) {\n const y = coord.y;\n let x = coord.x;\n // tile range in one direction range is dependent on zoom level\n // 0 = 1 tile, 1 = 2 tiles, 2 = 4 tiles, 3 = 8 tiles, etc\n const tileRange = 1 \u003c\u003c zoom;\n\n // don't repeat across y-axis (vertically)\n if (y \u003c 0 || y \u003e= tileRange) {\n return null;\n }\n\n // repeat across x-axis\n if (x \u003c 0 || x \u003e= tileRange) {\n x = ((x % tileRange) + tileRange) % tileRange;\n }\n return { x: x, y: y };\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/maptype-image/docs/index.js#L7-L69\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-image/docs/style.css#L7-L24\n```\n\nHTML \n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eImage 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-image/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-image/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-image&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-image 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"]]
