googlemaps-samples · willum070 · Feb 11, 2026 · Jan 27, 2026 · Jan 29, 2026 · Jan 27, 2026
diff --git a/samples/place-photos/README.md b/samples/place-photos/README.md
@@ -0,0 +1,41 @@
+# Google Maps JavaScript Sample
+
+## place-photos
+
+This sample demonstrates the use of the Places API to display photos of a place.
+
+## Setup
+
+### Before starting run:
+
+`npm i`
+
+### Run an example on a local web server
+
+`cd samples/place-photos`
+`npm start`
+
+### Build an individual example
+
+`cd samples/place-photos`
+`npm run build`
+
+From 'samples':
+
+`npm run build --workspace=place-photos/`
+
+### Build all of the examples.
+
+From 'samples':
+
+`npm run build-all`
+
+### Run lint to check for problems
+
+`cd samples/place-photos`
+`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/place-photos/index.html b/samples/place-photos/index.html
@@ -0,0 +1,31 @@
+<!doctype html>
+<!--
+ @license
+ Copyright 2026 Google LLC. All Rights Reserved.
+ SPDX-License-Identifier: Apache-2.0
+-->
+<!-- [START maps_place_photos] -->
+<html lang="en">
+    <head>
+        <title>Place Photos</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>
+        <div id="container">
+            <div class="place-overview">
+                <div id="info">
+                    <h1 id="heading"></h1>
+                    <div id="summary"></div>
+                </div>
+                <div id="gallery"></div>
+            </div>
+            <div id="expanded-image"></div>
+        </div>
+    </body>
+</html>
+<!-- [END maps_place_photos] -->
diff --git a/samples/place-photos/index.ts b/samples/place-photos/index.ts
@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// [START maps_place_photos]
+async function init() {
+    const { Place } = (await google.maps.importLibrary(
+        'places'
+    )) as google.maps.PlacesLibrary;
+
+    // Use a place ID to create a new Place instance.
+    const place = new Place({
+        id: 'ChIJydSuSkkUkFQRsqhB-cEtYnw', // Woodland Park Zoo, Seattle WA
+    });
+
+    // Call fetchFields, passing the desired data fields.
+    await place.fetchFields({
+        fields: ['displayName', 'photos', 'editorialSummary'],
+    });
+
+    // Get the various HTML elements.
+    const heading = document.getElementById('heading') as HTMLElement;
+    const summary = document.getElementById('summary') as HTMLElement;
+    const gallery = document.getElementById('gallery') as HTMLElement;
+    const expandedImageDiv = document.getElementById(
+        'expanded-image'
+    ) as HTMLElement;
+
+    // Show the display name and summary for the place.
+    heading.textContent = place.displayName as string;
+    summary.textContent = place.editorialSummary as string;
+
+    // Add photos to the gallery.
+    place.photos?.forEach((photo) => {
+        const altText = 'Photo of ' + place.displayName;
+        const img = document.createElement('img');
+        const imgButton = document.createElement('button');
+        const expandedImage = document.createElement('img');
+        img.src = photo?.getURI({ maxHeight: 380 });
+        img.alt = altText;
+        imgButton.addEventListener('click', (event) => {
+            centerSelectedThumbnail(imgButton);
+            event.preventDefault();
+            expandedImage.src = img.src;
+            expandedImage.alt = altText;
+            expandedImageDiv.innerHTML = '';
+            expandedImageDiv.appendChild(expandedImage);
+            const attributionLabel = createAttribution(
+                photo.authorAttributions[0]
+            )!;
+            expandedImageDiv.appendChild(attributionLabel);
+        });
+
+        imgButton.addEventListener('focus', () => {
+            centerSelectedThumbnail(imgButton);
+        });
+
+        imgButton.appendChild(img);
+        gallery.appendChild(imgButton);
+    });
+
+    // Display the first photo.
+    if (place.photos && place.photos.length > 0) {
+        const photo = place.photos[0];
+        const img = document.createElement('img');
+        img.alt = 'Photo of ' + place.displayName;
+        img.src = photo.getURI();
+        expandedImageDiv.appendChild(img);
+
+        if (photo.authorAttributions && photo.authorAttributions.length > 0) {
+            expandedImageDiv.appendChild(
+                createAttribution(photo.authorAttributions[0])
+            );
+        }
+    }
+
+    // Helper function to create attribution DIV.
+    function createAttribution(
+        attribution: google.maps.places.AuthorAttribution
+    ) {
+        const attributionLabel = document.createElement('a');
+        attributionLabel.classList.add('attribution-label');
+        attributionLabel.textContent = attribution.displayName;
+        attributionLabel.href = attribution.uri!;
+        attributionLabel.target = '_blank';
+        attributionLabel.rel = 'noopener noreferrer';
+        return attributionLabel;
+    }
+
+    // Helper function to center the selected thumbnail in the gallery.
+    function centerSelectedThumbnail(element: HTMLElement) {
+        element.scrollIntoView({
+            behavior: 'smooth',
+            block: 'center',
+            inline: 'center',
+        });
+    }
+}
+
+init();
+// [END maps_place_photos]
diff --git a/samples/place-photos/package.json b/samples/place-photos/package.json
@@ -0,0 +1,11 @@
+{
+  "name": "@js-api-samples/place-photos",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "tsc && bash ../jsfiddle.sh place-photos && bash ../app.sh place-photos && bash ../docs.sh place-photos && npm run build:vite --workspace=. && bash ../dist.sh place-photos",
+    "test": "tsc && npm run build:vite --workspace=.",
+    "start": "tsc && vite build --base './' && vite",
+    "build:vite": "vite build --base './'",
+    "preview": "vite preview"
+  }
+}
diff --git a/samples/place-photos/style.css b/samples/place-photos/style.css
@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* [START maps_place_photos] */
+/* 
+ * Optional: Makes the sample page fill the window. 
+ */
+html,
+body {
+    height: 100%;
+    margin: 0;
+    padding: 0;
+}
+
+#container {
+    display: flex;
+    border: 2px solid black;
+    border-radius: 10px;
+    padding: 10px;
+    max-width: 950px;
+    height: 100%;
+    max-height: 400px;
+    box-sizing: border-box;
+}
+
+.place-overview {
+    width: 400px;
+    height: 380px;
+    overflow-x: auto;
+    position: relative;
+    margin-right: 20px;
+}
+
+#info {
+    font-family: sans-serif;
+    position: sticky;
+    position: -webkit-sticky;
+    left: 0;
+    padding-bottom: 10px;
+}
+
+#heading {
+    width: 500px;
+    font-size: x-large;
+    margin-bottom: 20px;
+}
+
+#summary {
+    width: 100%;
+}
+
+#gallery {
+    display: flex;
+    padding-top: 10px;
+}
+
+#gallery img {
+    width: 200px;
+    height: 200px;
+    margin: 10px;
+    border-radius: 10px;
+    cursor: pointer;
+    object-fit: cover; /* fill the area without distorting the image */
+}
+
+#expanded-image {
+    display: flex;
+    height: 370px;
+    overflow: hidden;
+    background-color: #000;
+    border-radius: 10px;
+    margin: 0 auto;
+}
+
+.attribution-label {
+    background-color: rgba(255, 255, 255, 0.7);
+    font-size: 10px;
+    font-family: sans-serif;
+    margin: 2px;
+    position: absolute;
+}
+
+button {
+    display: flex;
+    outline: none;
+    border: none;
+    padding: 0;
+    background: none;
+    cursor: pointer;
+}
+
+button:focus {
+    border: 2px solid blue;
+    border-radius: 10px;
+}
+
+/* [END maps_place_photos] */
diff --git a/samples/place-photos/tsconfig.json b/samples/place-photos/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"
+  }
+}