googlemaps-samples · willum070 · Dec 15, 2025 · Dec 9, 2025 · Dec 12, 2025 · Dec 12, 2025
diff --git a/samples/place-reviews/README.md b/samples/place-reviews/README.md
@@ -0,0 +1,41 @@
+# Google Maps JavaScript Sample
+
+## place-reviews
+
+Demonstrates retrieving place reviews.
+
+## Setup
+
+### Before starting run:
+
+`npm i`
+
+### Run an example on a local web server
+
+`cd samples/place-reviews`
+`npm start`
+
+### Build an individual example
+
+`cd samples/place-reviews`
+`npm run build`
+
+From 'samples':
+
+`npm run build --workspace=place-reviews/`
+
+### Build all of the examples.
+
+From 'samples':
+
+`npm run build-all`
+
+### Run lint to check for problems
+
+`cd samples/place-reviews`
+`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-reviews/index.html b/samples/place-reviews/index.html
@@ -0,0 +1,26 @@
+<!doctype html>
+<!--
+ @license
+ Copyright 2025 Google LLC. All Rights Reserved.
+ SPDX-License-Identifier: Apache-2.0
+-->
+<!-- [START maps_place_reviews] -->
+<html>
+    <head>
+        <title>Place Reviews</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="42.349134, -71.083184"
+            zoom="14"
+            map-id="4504f8b37365c3d0">
+        </gmp-map>
+    </body>
+</html>
+<!-- [END maps_place_reviews] -->
diff --git a/samples/place-reviews/index.ts b/samples/place-reviews/index.ts
@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// [START maps_place_reviews]
+let innerMap;
+let infoWindow;
+const mapElement = document.querySelector('gmp-map') as google.maps.MapElement;
+
+async function initMap() {
+    // Import the needed libraries.
+    const [{ InfoWindow }, { AdvancedMarkerElement }, { Place }] =
+        await Promise.all([
+            google.maps.importLibrary(
+                'maps'
+            ) as Promise<google.maps.MapsLibrary>,
+            google.maps.importLibrary(
+                'marker'
+            ) as Promise<google.maps.MarkerLibrary>,
+            google.maps.importLibrary(
+                'places'
+            ) as Promise<google.maps.PlacesLibrary>,
+        ]);
+
+    innerMap = mapElement.innerMap;
+
+    // [START maps_place_reviews_get_first]
+    // Create a new Place instance.
+    const place = new Place({
+        id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
+    });
+
+    // Call fetchFields, passing 'reviews' and other needed fields.
+    await place.fetchFields({
+        fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
+    });
+
+    // Create an HTML container.
+    const content = document.createElement('div');
+    const title = document.createElement('div');
+    const rating = document.createElement('div');
+    const address = document.createElement('div');
+    const review = document.createElement('div');
+    const authorLink = document.createElement('a');
+
+    // If there are any reviews display the first one.
+    if (place.reviews && place.reviews.length > 0) {
+        // Get info for the first review.
+        const reviewRating = place.reviews[0].rating;
+        const reviewText = place.reviews[0].text;
+        const authorName = place.reviews[0].authorAttribution!.displayName;
+        const authorUri = place.reviews[0].authorAttribution!.uri;
+
+        // Safely populate the HTML.
+        title.textContent = place.displayName || '';
+        address.textContent = place.formattedAddress || '';
+        rating.textContent = `Rating: ${reviewRating} stars`;
+        review.textContent = reviewText || '';
+        authorLink.textContent = authorName;
+        authorLink.href = authorUri || '';
+        authorLink.target = '_blank';
+
+        content.appendChild(title);
+        content.appendChild(address);
+        content.appendChild(rating);
+        content.appendChild(review);
+        content.appendChild(authorLink);
+    } else {
+        content.textContent =
+            `No reviews were found for ${place.displayName}.`;
+    }
+
+    // Create an infowindow to display the review.
+    infoWindow = new InfoWindow({
+        content,
+        ariaLabel: place.displayName,
+    });
+    // [END maps_place_reviews_get_first]
+
+    // Add a marker.
+    const marker = new AdvancedMarkerElement({
+        map: innerMap,
+        position: place.location,
+        title: place.displayName,
+    });
+
+    innerMap.setCenter(place.location);
+
+    // Show the info window.
+    infoWindow.open({
+        anchor: marker,
+        map: innerMap,
+    });
+}
+
+initMap();
+// [END maps_place_reviews]
diff --git a/samples/place-reviews/package.json b/samples/place-reviews/package.json
@@ -0,0 +1,12 @@
+{
+    "name": "@js-api-samples/place-reviews",
+    "version": "1.0.0",
+    "scripts": {
+        "build": "tsc && bash ../jsfiddle.sh place-reviews && bash ../app.sh place-reviews && bash ../docs.sh place-reviews && npm run build:vite --workspace=. && bash ../dist.sh place-reviews",
+        "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/place-reviews/style.css b/samples/place-reviews/style.css
@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* [START maps_place_reviews] */
+/* 
+ * Always set the map height explicitly to define the size of the div element
+ * that contains the map. 
+ */
+gmp-map {
+    height: 100%;
+}
+
+/* 
+ * Optional: Makes the sample page fill the window. 
+ */
+html,
+body {
+    height: 100%;
+    margin: 0;
+    padding: 0;
+}
+
+/* [END maps_place_reviews] */
diff --git a/samples/place-reviews/tsconfig.json b/samples/place-reviews/tsconfig.json
@@ -0,0 +1,11 @@
+{
+    "compilerOptions": {
+        "module": "esnext",
+        "target": "esnext",
+        "strict": true,
+        "noImplicitAny": false,
+        "lib": ["es2015", "esnext", "es6", "dom", "dom.iterable"],
+        "moduleResolution": "Node",
+        "jsx": "preserve"
+    }
+}