feat: Migrates streetview-custom-simple, updates to latest standards (#1789)

* feat: Migrates streetview-custom-simple to js-api-samples

Change-Id: I20db709f9aaaf08a716fc5ca066e395c2b20e1bc

* fix: Moves function so that panorama.registerPanoProvider is next to instantiation

Change-Id: I6c73cbc5b1e73c9decb26020eb43fc882f57bad1

Author: willum070

package-lock.json

@@ -0,0 +1,41 @@
+# Google Maps JavaScript Sample
+
+## streetview-custom-simple
+
+Custom Street View Panoramas
+
+## Setup
+
+### Before starting run:
+
+`npm i`
+
+### Run an example on a local web server
+
+`cd samples/streetview-custom-simple`
+`npm start`
+
+### Build an individual example
+
+`cd samples/streetview-custom-simple`
+`npm run build`
+
+From 'samples':
+
+`npm run build --workspace=streetview-custom-simple/`
+
+### Build all of the examples.
+
+From 'samples':
+
+`npm run build-all`
+
+### Run lint to check for problems
+
+`cd samples/streetview-custom-simple`
+`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).

samples/streetview-custom-simple/README.md

@@ -0,0 +1,25 @@
+<!doctype html>
+<!--
+ @license
+ Copyright 2026 Google LLC. All Rights Reserved.
+ SPDX-License-Identifier: Apache-2.0
+-->
+<!-- [START maps_streetview_custom_simple] -->
+<html>
+    <head>
+        <title>Custom Street View Panoramas</title>
+
+        <link rel="stylesheet" type="text/css" href="./style.css" />
+        <script type="module" src="./index.js"></script>
+        <script>
+            // prettier-ignore
+            (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: "GOOGLE_MAPS_API_KEY"
+            });
+        </script>
+    </head>
+    <body>
+        <div id="map"></div>
+    </body>
+</html>
+<!-- [END maps_streetview_custom_simple] -->

samples/streetview-custom-simple/index.html

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// [START maps_streetview_custom_simple]
+async function init(): Promise<void> {
+    // Request needed libraries.
+    const [{ StreetViewPanorama }, { Size }] = await Promise.all([
+        google.maps.importLibrary('streetView'),
+        google.maps.importLibrary('core'),
+    ]);
+
+    // Construct the appropriate StreetViewPanoramaData given
+    // the passed pano IDs.
+    function getCustomPanorama(
+        pano: string
+    ): google.maps.StreetViewPanoramaData | null {
+        if (pano === 'reception') {
+            return {
+                location: {
+                    pano: 'reception',
+                    description: 'Google Sydney - Reception',
+                },
+                links: [],
+                // The text for the copyright control.
+                copyright: 'Imagery (c) 2010 Google',
+                // The definition of the tiles for this panorama.
+                tiles: {
+                    tileSize: new Size(1024, 512),
+                    worldSize: new Size(2048, 1024),
+                    // The heading in degrees at the origin of the panorama
+                    // tile set.
+                    centerHeading: 105,
+                    getTileUrl: getCustomPanoramaTileUrl,
+                },
+            };
+        }
+        return null;
+    }
+
+    // Set up Street View and initially set it visible. Register the
+    // custom panorama provider function. Set the StreetView to display
+    // the custom panorama 'reception' which we check for below.
+    const panorama = new StreetViewPanorama(document.getElementById('map')!, {
+        pano: 'reception',
+        visible: true,
+    });
+
+    panorama.registerPanoProvider(getCustomPanorama);
+}
+
+// Return a pano image given the panoID.
+function getCustomPanoramaTileUrl(
+    pano: string,
+    zoom: number,
+    tileX: number,
+    tileY: number
+): string {
+    return `https://developers.google.com/maps/documentation/javascript/examples/full/images/panoReception1024-${String(zoom)}-${String(tileX)}-${String(tileY)}.jpg`;
+}
+
+void init();
+// [END maps_streetview_custom_simple]

samples/streetview-custom-simple/index.ts

@@ -0,0 +1,12 @@
+{
+  "name": "@js-api-samples/streetview-custom-simple",
+  "version": "1.0.0",
+  "scripts": {
+    "build": "bash ../build-single.sh",
+    "test": "tsc && npm run build:vite --workspace=.",
+    "start": "tsc && vite build --config ../../vite.config.js --base './' && vite --config ../../vite.config.js",
+    "build:vite": "vite build --config ../../vite.config.js --base './'",
+    "preview": "vite preview --config ../../vite.config.js"
+  },
+  "author": "Google LLC"
+}

samples/streetview-custom-simple/package.json

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/* [START maps_streetview_custom_simple] */
+/* 
+ * 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;
+}
+
+/* [END maps_streetview_custom_simple] */

samples/streetview-custom-simple/style.css

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["./*.ts"]
+}