googlemaps-samples · ejhaselden · Dec 19, 2025
diff --git a/samples/places-placeid-finder/README.md b/samples/places-placeid-finder/README.md
@@ -0,0 +1,41 @@
+# Google Maps JavaScript Sample
+
+## places-placeid-finder
+
+Place ID Finder
+
+## Setup
+
+### Before starting run:
+
+`npm i`
+
+### Run an example on a local web server
+
+`cd samples/places-placeid-finder`
+`npm start`
+
+### Build an individual example
+
+`cd samples/places-placeid-finder`
+`npm run build`
+
+From 'samples':
+
+`npm run build --workspace=places-placeid-finder/`
+
+### Build all of the examples.
+
+From 'samples':
+
+`npm run build-all`
+
+### Run lint to check for problems
+
+`cd samples/places-placeid-finder`
+`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/places-placeid-finder/index.html b/samples/places-placeid-finder/index.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<!--
+ @license
+ Copyright 2019 Google LLC. All Rights Reserved.
+ SPDX-License-Identifier: Apache-2.0
+-->
+<!-- [START maps_places_placeid_finder] -->
+<html>
+    <head>
+        <title>Place ID Finder</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.8688, 151.2195" zoom="13" map-id="DEMO_MAP_ID">
+            <gmp-place-autocomplete slot="control-inline-start-block-start"></gmp-place-autocomplete>></gmp-place-autocomplete>
+        </gmp-map>
+        <div id="infowindow-content">
+            <span id="place-name" class="title"></span><br />
+            <strong>Place ID:</strong> <span id="place-id"></span><br />
+            <span id="place-address"></span>
+        </div>
+</html>
+<!-- [END maps_places_placeid_finder] -->
diff --git a/samples/places-placeid-finder/index.ts b/samples/places-placeid-finder/index.ts
@@ -0,0 +1,116 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// [START maps_places_placeid_finder]
+// This sample uses the Place Autocomplete widget to allow the user to search
+// for and select a place. The sample then displays an info window containing
+// the place ID and other information about the place that the user has
+// selected.
+
+// This example requires the Places library. Include the libraries=places
+// parameter when you first load the API. For example:
+// <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places">
+
+async function initMap(): Promise<void> {
+    // Request needed libraries.
+    const [{ InfoWindow }, { AdvancedMarkerElement }] = 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>,
+    ]);
+
+    const mapElement = document.querySelector(
+        'gmp-map'
+    ) as google.maps.MapElement;
+    const map = mapElement.innerMap as google.maps.Map;
+
+    const placeAutocomplete = document.querySelector(
+        'gmp-place-autocomplete'
+    ) as google.maps.places.PlaceAutocompleteElement;
+
+    // Set the map options.
+    map.setOptions({
+        clickableIcons: false,
+        mapTypeControl: false,
+        streetViewControl: false,
+    });
+
+    // Use the bounds_changed event to bias results to the current map bounds.
+    map.addListener('bounds_changed', () => {
+        const bounds = map.getBounds();
+        if (bounds) {
+            placeAutocomplete.locationBias = bounds;
+        }
+    });
+
+    const infowindow = new InfoWindow();
+    const infowindowContent = document.getElementById(
+        'infowindow-content'
+    ) as HTMLElement;
+
+    infowindow.setContent(infowindowContent);
+
+    const marker = new AdvancedMarkerElement({
+        map: map,
+        collisionBehavior:
+            google.maps.CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL,
+    });
+
+    marker.addListener('click', () => {
+        infowindow.open(map, marker);
+    });
+
+    placeAutocomplete.addEventListener(
+        'gmp-select',
+        async ({ placePrediction }: any) => {
+            infowindow.close();
+
+            const place = placePrediction.toPlace();
+
+            await place.fetchFields({
+                fields: ['displayName', 'formattedAddress', 'location', 'id'],
+            });
+
+            if (!place.location) {
+                return;
+            }
+
+            if (place.viewport) {
+                map.fitBounds(place.viewport);
+            } else {
+                map.setCenter(place.location);
+                map.setZoom(17);
+            }
+
+            // Set the position of the marker using the place ID and location.
+            marker.position = place.location;
+            // marker.setVisible(true); // AdvancedMarkerElement is visible by default when map and position are set.
+
+            (
+                infowindowContent.children.namedItem(
+                    'place-name'
+                ) as HTMLElement
+            ).textContent = place.displayName as string;
+            (
+                infowindowContent.children.namedItem('place-id') as HTMLElement
+            ).textContent = place.id as string;
+            (
+                infowindowContent.children.namedItem(
+                    'place-address'
+                ) as HTMLElement
+            ).textContent = place.formattedAddress as string;
+            infowindow.open(map, marker);
+        }
+    );
+}
+
+initMap();
+// [END maps_places_placeid_finder]
+export {};
diff --git a/samples/places-placeid-finder/package.json b/samples/places-placeid-finder/package.json
@@ -0,0 +1,14 @@
+{
+  "name": "@js-api-samples/places-placeid-finder",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "tsc && bash ../jsfiddle.sh places-placeid-finder && bash ../app.sh places-placeid-finder && bash ../docs.sh places-placeid-finder && npm run build:vite --workspace=. && bash ../dist.sh places-placeid-finder",
+    "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/places-placeid-finder/style.css b/samples/places-placeid-finder/style.css
@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2019 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* [START maps_places_placeid_finder] */
+/* 
+ * 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;
+    font-family: Arial, Helvetica, sans-serif;
+}
+
+#infowindow-content {
+    display: none;
+}
+
+gmp-map #infowindow-content {
+    display: inline;
+}
+
+gmp-place-autocomplete {
+    position: absolute;
+    height: 30px;
+    width: 500px;
+    top: 10px;
+    left: 10px;
+    box-shadow: 4px 4px 5px 0px rgba(0, 0, 0, 0.2);
+    color-scheme: light;
+    border-radius: 10px;
+}
+
+/* [END maps_places_placeid_finder] */
diff --git a/samples/places-placeid-finder/tsconfig.json b/samples/places-placeid-finder/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"
+  }
+}