Stay organized with collections Save and categorize content based on your preferences.
This example uses the Data layer to create a polygon with two internal holes. If you don't use the data layer to create an inner hole, you must define a path wound in the opposite direction to the outer path as shown in this alternative.
// This example uses the Google Maps JavaScript API's Data layer// to create a rectangular polygon with 2 holes in it.functioninitMap():void{constmap=newgoogle.maps.Map(document.getElementById("map")asHTMLElement,{zoom:6,center:{lat:-33.872,lng:151.252},});// Define the LatLng coordinates for the outer path.constouterCoords=[{lat:-32.364,lng:153.207},// north west{lat:-35.364,lng:153.207},// south west{lat:-35.364,lng:158.207},// south east{lat:-32.364,lng:158.207},// north east];// Define the LatLng coordinates for an inner path.constinnerCoords1=[{lat:-33.364,lng:154.207},{lat:-34.364,lng:154.207},{lat:-34.364,lng:155.207},{lat:-33.364,lng:155.207},];// Define the LatLng coordinates for another inner path.constinnerCoords2=[{lat:-33.364,lng:156.207},{lat:-34.364,lng:156.207},{lat:-34.364,lng:157.207},{lat:-33.364,lng:157.207},];map.data.add({geometry:newgoogle.maps.Data.Polygon([outerCoords,innerCoords1,innerCoords2,]),});}declareglobal{interfaceWindow{initMap:()=>void;}}window.initMap=initMap;
// This example uses the Google Maps JavaScript API's Data layer// to create a rectangular polygon with 2 holes in it.functioninitMap(){constmap=newgoogle.maps.Map(document.getElementById("map"),{zoom:6,center:{lat:-33.872,lng:151.252},});// Define the LatLng coordinates for the outer path.constouterCoords=[{lat:-32.364,lng:153.207},// north west{lat:-35.364,lng:153.207},// south west{lat:-35.364,lng:158.207},// south east{lat:-32.364,lng:158.207},// north east];// Define the LatLng coordinates for an inner path.constinnerCoords1=[{lat:-33.364,lng:154.207},{lat:-34.364,lng:154.207},{lat:-34.364,lng:155.207},{lat:-33.364,lng:155.207},];// Define the LatLng coordinates for another inner path.constinnerCoords2=[{lat:-33.364,lng:156.207},{lat:-34.364,lng:156.207},{lat:-34.364,lng:157.207},{lat:-33.364,lng:157.207},];map.data.add({geometry:newgoogle.maps.Data.Polygon([outerCoords,innerCoords1,innerCoords2,]),});}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>Data Layer: Polygon</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-20 UTC."],[[["\u003cp\u003eThis example demonstrates how to create a polygon with two inner holes using the Google Maps JavaScript API's Data layer.\u003c/p\u003e\n"],["\u003cp\u003eThe Data.Polygon object is used, accepting arrays of LatLng coordinates for the outer and inner paths.\u003c/p\u003e\n"],["\u003cp\u003eAn alternative approach for creating inner holes without the Data layer involves defining a path wound in the opposite direction to the outer path.\u003c/p\u003e\n"],["\u003cp\u003eThe sample code showcases creating a rectangular polygon with two inner holes, providing coordinates for each path.\u003c/p\u003e\n"],["\u003cp\u003eTo run this sample locally, you need Git and Node.js installed, then follow the instructions to clone the repository, install dependencies, and start the application.\u003c/p\u003e\n"]]],["This example utilizes the Google Maps JavaScript API's Data layer to construct a polygon with two inner holes. It defines `outerCoords` for the external polygon path and `innerCoords1` and `innerCoords2` for the two inner holes. The `map.data.add` function integrates these coordinates, creating a polygon with specified internal voids. The provided code includes TypeScript, JavaScript, CSS, and HTML for implementation, along with instructions for local testing.\n"],null,["# Data Layer: Polygon\n\nThis example uses the\n[Data layer](/maps/documentation/javascript/3.exp/reference#Data.Polygon) to\ncreate a polygon with two internal holes. If you don't use the data layer to\ncreate an inner hole, you must define a path wound in the opposite direction to\nthe outer path as shown in\n[this alternative](/maps/documentation/javascript/examples/polygon-hole).\n\nRead the [documentation](/maps/documentation/javascript/datalayer). \n\n### TypeScript\n\n```typescript\n// This example uses the Google Maps JavaScript API's Data layer\n// to create a rectangular polygon with 2 holes in it.\n\nfunction initMap(): void {\n const map = new google.maps.Map(\n document.getElementById(\"map\") as HTMLElement,\n {\n zoom: 6,\n center: { lat: -33.872, lng: 151.252 },\n }\n );\n\n // Define the LatLng coordinates for the outer path.\n const outerCoords = [\n { lat: -32.364, lng: 153.207 }, // north west\n { lat: -35.364, lng: 153.207 }, // south west\n { lat: -35.364, lng: 158.207 }, // south east\n { lat: -32.364, lng: 158.207 }, // north east\n ];\n\n // Define the LatLng coordinates for an inner path.\n const innerCoords1 = [\n { lat: -33.364, lng: 154.207 },\n { lat: -34.364, lng: 154.207 },\n { lat: -34.364, lng: 155.207 },\n { lat: -33.364, lng: 155.207 },\n ];\n\n // Define the LatLng coordinates for another inner path.\n const innerCoords2 = [\n { lat: -33.364, lng: 156.207 },\n { lat: -34.364, lng: 156.207 },\n { lat: -34.364, lng: 157.207 },\n { lat: -33.364, lng: 157.207 },\n ];\n\n map.data.add({\n geometry: new google.maps.Data.Polygon([\n outerCoords,\n innerCoords1,\n innerCoords2,\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/layer-data-polygon/index.ts#L8-L58\n```\n| **Note:** Read the [guide](/maps/documentation/javascript/using-typescript) on using TypeScript and Google Maps.\n\n### JavaScript\n\n```javascript\n// This example uses the Google Maps JavaScript API's Data layer\n// to create a rectangular polygon with 2 holes in it.\nfunction initMap() {\n const map = new google.maps.Map(document.getElementById(\"map\"), {\n zoom: 6,\n center: { lat: -33.872, lng: 151.252 },\n });\n // Define the LatLng coordinates for the outer path.\n const outerCoords = [\n { lat: -32.364, lng: 153.207 }, // north west\n { lat: -35.364, lng: 153.207 }, // south west\n { lat: -35.364, lng: 158.207 }, // south east\n { lat: -32.364, lng: 158.207 }, // north east\n ];\n // Define the LatLng coordinates for an inner path.\n const innerCoords1 = [\n { lat: -33.364, lng: 154.207 },\n { lat: -34.364, lng: 154.207 },\n { lat: -34.364, lng: 155.207 },\n { lat: -33.364, lng: 155.207 },\n ];\n // Define the LatLng coordinates for another inner path.\n const innerCoords2 = [\n { lat: -33.364, lng: 156.207 },\n { lat: -34.364, lng: 156.207 },\n { lat: -34.364, lng: 157.207 },\n { lat: -33.364, lng: 157.207 },\n ];\n\n map.data.add({\n geometry: new google.maps.Data.Polygon([\n outerCoords,\n innerCoords1,\n innerCoords2,\n ]),\n });\n}\n\nwindow.initMap = initMap;https://github.com/googlemaps/js-samples/blob/2683f7366fb27829401945d2a7e27d77ed2df8e5/dist/samples/layer-data-polygon/docs/index.js#L7-L45\n```\n| **Note:** The JavaScript is compiled from the TypeScript snippet.\n\n### CSS\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/layer-data-polygon/docs/style.css#L7-L24\n```\n\n### HTML\n\n```html\n\u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eData Layer: Polygon\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/layer-data-polygon/docs/index.html#L8-L30\n```\n\n### Try Sample\n\n[JSFiddle.net](https://jsfiddle.net/gh/get/library/pure/googlemaps/js-samples/tree/master/dist/samples/layer-data-polygon/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-layer-data-polygon&cloudshell_tutorial=cloud_shell_instructions.md&cloudshell_workspace=.)\n\n### Clone 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-layer-data-polygon 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"]]
