Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions samples/place-photos/README.md
Original file line number Diff line number Diff line change
@@ -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).
31 changes: 31 additions & 0 deletions samples/place-photos/index.html
Original file line number Diff line number Diff line change
@@ -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] -->
95 changes: 95 additions & 0 deletions samples/place-photos/index.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
/**
* @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.
let heading = document.getElementById('heading') as HTMLElement;
let summary = document.getElementById('summary') as HTMLElement;
let gallery = document.getElementById('gallery') as HTMLElement;
let expandedImageDiv = document.getElementById(
Comment on lines +24 to +27
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These can be chagned to const

Suggested change
let heading = document.getElementById('heading') as HTMLElement;
let summary = document.getElementById('summary') as HTMLElement;
let gallery = document.getElementById('gallery') as HTMLElement;
let expandedImageDiv = document.getElementById(
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;
let attributionLabel;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can be removed and declared inside each block that needs an attributionLabel


// 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.
if (place.photos) {
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);
attributionLabel = createAttribution(photo.authorAttributions);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
attributionLabel = createAttribution(photo.authorAttributions);
const attributionLabel = createAttribution(photo.authorAttributions);

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 img = document.createElement('img');
img.alt = 'Photo of ' + place.displayName;
img.src = place.photos![0].getURI();
expandedImageDiv.appendChild(img);
attributionLabel = createAttribution(place.photos![0].authorAttributions);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
attributionLabel = createAttribution(place.photos![0].authorAttributions);
const attributionLabel = createAttribution(place.photos![0].authorAttributions);

expandedImageDiv.appendChild(attributionLabel);
}

// Helper function to create attribution DIV.
function createAttribution(attribution) {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a type for attribution? Also suggest renaming the parameter to attributions since multiple are passed.

Suggested change
function createAttribution(attribution) {
function createAttribution(attributions: google.maps.places.AuthorAttribution[]) {

const attributionLabel = document.createElement('a');
attributionLabel.classList.add('attribution-label');
if (attribution && attribution[0]) {
attributionLabel.textContent = attribution[0].displayName;
attributionLabel.href = attribution[0].uri;
Comment on lines +79 to +81
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
if (attribution && attribution[0]) {
attributionLabel.textContent = attribution[0].displayName;
attributionLabel.href = attribution[0].uri;
if (attributions && attributions[0]) {
attributionLabel.textContent = attributions[0].displayName;
attributionLabel.href = attributions[0].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]
11 changes: 11 additions & 0 deletions samples/place-photos/package.json
Original file line number Diff line number Diff line change
@@ -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"
}
}
99 changes: 99 additions & 0 deletions samples/place-photos/style.css
Original file line number Diff line number Diff line change
@@ -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] */
17 changes: 17 additions & 0 deletions samples/place-photos/tsconfig.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"compilerOptions": {
"module": "esnext",
"target": "esnext",
"strict": true,
"noImplicitAny": false,
"lib": [
"es2015",
"esnext",
"es6",
"dom",
"dom.iterable"
],
"moduleResolution": "Node",
"jsx": "preserve"
}
}
Loading