googlemaps-samples · willum070 · Feb 19, 2026 · ReeseJones · Feb 24, 2026 · ReeseJones
diff --git a/samples/event-poi/README.md b/samples/event-poi/README.md
@@ -0,0 +1,41 @@
+# Google Maps JavaScript Sample
+
+## event-poi
+
+This example demonstrates the use of click event listeners on POIs (points of interest).
+
+## Setup
+
+### Before starting run:
+
+`npm i`
+
+### Run an example on a local web server
+
+`cd samples/event-poi`
+`npm start`
+
+### Build an individual example
+
+`cd samples/event-poi`
+`npm run build`
+
+From 'samples':
+
+`npm run build --workspace=event-poi/`
+
+### Build all of the examples.
+
+From 'samples':
+
+`npm run build-all`
+
+### Run lint to check for problems
+
+`cd samples/event-poi`
+`npx eslint index.ts` 
+
+## Feedback
+
+For feedback related to this sample, please open a new issue on
+[GitHub](https://github.com/googlemaps-samples/js-api-samples/issues).
diff --git a/samples/event-poi/index.html b/samples/event-poi/index.html
@@ -0,0 +1,24 @@
+<!doctype html>
+<!--
+ @license
+ Copyright 2026 Google LLC. All Rights Reserved.
+ SPDX-License-Identifier: Apache-2.0
+-->
+<!-- [START maps_event_poi] -->
+<html>
+    <head>
+        <title>POI Click Events</title>
+
+        <link rel="stylesheet" type="text/css" href="./style.css" />
+        <script type="module" src="./index.js"></script>
+        <!-- prettier-ignore -->
+        <script>(g=>{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=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+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=()=>h=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)=>r.add(f)&&u().then(()=>d[l](f,...n))})
+        ({key: "AIzaSyA6myHzS10YXdcazAFalmXvDkrYCp5cLc8", v: "weekly"});</script>
+    </head>
+    <body>
+        <gmp-map center="-33.871, 151.197" zoom="18">
+            <div id="infowindow-content"></div>
+        </gmp-map>
+    </body>
+</html>
+<!-- [END maps_event_poi] -->
diff --git a/samples/event-poi/index.ts b/samples/event-poi/index.ts
@@ -0,0 +1,91 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// [START maps_event_poi]
+const mapElement = document.querySelector('gmp-map') as google.maps.MapElement;
+let innerMap;
+let infowindow: google.maps.InfoWindow;
+
+async function initMap() {
+    //  Request the needed libraries.
+    await google.maps.importLibrary('maps');
+
+    innerMap = await mapElement.innerMap;
+
+    // Create the initial InfoWindow.
+    infowindow = new google.maps.InfoWindow({});
+
+    innerMap.addListener('click', (event) => {
+        // Prevent the default POI info window from showing.
+        event.stop();
+
+        // If the event has a placeId, show the info window.
+        if (isIconMouseEvent(event) && event.placeId) {
+            showInfoWindow(event);
+        } else {
+            // Otherwise, close the info window.
+            infowindow.close();
+        }
+    });
+}
+
+// Helper function to show the info window.
+async function showInfoWindow(event: google.maps.IconMouseEvent) {
+    // Retrieve the place details for the selected POI.
+    const place = await getPlaceDetails(event.placeId);
+
+    // Assemble the info window content.
+    const content = document.createElement('div');
+    const address = document.createElement('div');
+    const placeId = document.createElement('div');
+    address.textContent = place.formattedAddress || '';
+    placeId.textContent = place.id || '';
+    content.append(address, placeId);
+
+    // Create an element to use the place name as header content.
+    const name = document.createElement('div');
+    name.style.fontWeight = 'bold';
+    name.style.fontSize = 'medium';
+    name.textContent = place.displayName || '';
+
+    // Update info window options.
+    infowindow.setOptions({
+        position: event.latLng,
+        pixelOffset: new google.maps.Size(0, -30),
+        headerContent: name,
+        content: content,
+    });
+
+    innerMap.panTo(event.latLng);
+    infowindow.open(innerMap);
+}
+
+// Helper function to get place details.
+async function getPlaceDetails(placeId) {
+    // Import the Places library.
+    const { Place } = (await google.maps.importLibrary(
+        'places'
+    )) as google.maps.PlacesLibrary;
+
+    // Create a Place instance with the place id and fetch the details.
+    const place = new Place({ id: placeId });
+    await place.fetchFields({
+        fields: ['displayName', 'formattedAddress'],
+    });
+
+    // Return the place details.
+    return place;
+}
+
+// Helper type guard to determine if the event is an IconMouseEvent.
+function isIconMouseEvent(
+    e: google.maps.MapMouseEvent | google.maps.IconMouseEvent
+): e is google.maps.IconMouseEvent {
+    return 'placeId' in e;
+}
+
+initMap();
+// [END maps_event_poi]
diff --git a/samples/event-poi/package.json b/samples/event-poi/package.json
@@ -0,0 +1,14 @@
+{
+  "name": "@js-api-samples/event-poi",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "tsc && bash ../jsfiddle.sh event-poi && bash ../app.sh event-poi && bash ../docs.sh event-poi && npm run build:vite --workspace=. && bash ../dist.sh event-poi",
+    "test": "tsc && npm run build:vite --workspace=.",
+    "start": "tsc && vite build --base './' && vite",
+    "build:vite": "vite build --base './'",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+
+  }
+}
diff --git a/samples/event-poi/style.css b/samples/event-poi/style.css
@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* [START maps_event_poi] */
+
+/* Optional: Makes the sample page fill the window. */
+html,
+body {
+    height: 100%;
+    margin: 0;
+    padding: 0;
+}
+
+.title {
+    font-weight: bold;
+}
+
+#infowindow-content {
+    display: none;
+}
+
+#map #infowindow-content {
+    display: inline;
+}
+
+/* [END maps_event_poi] */
diff --git a/samples/event-poi/tsconfig.json b/samples/event-poi/tsconfig.json
@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "module": "esnext",
+    "target": "esnext",
+    "strict": true,
+    "noImplicitAny": false,
+    "lib": [
+      "es2015",
+      "esnext",
+      "es6",
+      "dom",
+      "dom.iterable"
+    ],
+    "moduleResolution": "Node",
+    "jsx": "preserve"
+  }
+}