AI-powered review summaries are AI-generated summaries of places based solely on user reviews. By synthesizing key elements of user reviews, such as place attributes and reviewer sentiment, review summaries provide high-level insights and help users make informed decisions.
For example, a review summary of the Ferry Building in San Francisco includes information ranging from food and shopping to views and atmosphere:
"Visitors say this historical landmark offers a diverse selection of shops, restaurants, and a farmers market, with many praising the views of the bay and the city. They also highlight the vibrant atmosphere, convenient ferry access to other destinations, and the opportunity to enjoy local businesses."
Review summaries are supported in Place Details (New), Text Search (New), and Nearby Search (New).
Request a review summary
To request a review summary, include reviewSummary in the field mask of the
request:
- Place Details (New):
reviewSummary - Text Search (New) and Nearby Search (New):
places.reviewSummary
Attributions for a review summary must include a link to the place's reviews on
Google Maps. To retrieve that link, include
googleMapsLinks.reviewsUri
in the field mask of the request.
The response body includes three fields:
text: The AI-generated review summary.flagContentUri: Used to flag inappropriate content for removal by Google.disclosureText: A localized text string with the disclosure text "Summarized with Gemini" that must be incorporated in attributions.
Place Details (New) request
The following example requests a review summary for a dumpling restaurant in New York:
curl -X GET https://places.googleapis.com/v1/places/ChIJD2l2k7ZL0YkRC80d-3MV1lM \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,reviewSummary,googleMapsLinks.reviewsUri"
The response is in the form:
{ "displayName": { "text": "Dumpling House", "languageCode": "en" }, "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1", }, "reviewSummary": { "text": { "text": "Diners say this lunch restaurant serves up delicious dumplings, including pork and chive, soup dumplings, and fried dumplings, alongside other Chinese dishes like fried rice, pork belly buns, and general tso's chicken. They also highlight the generous portions, reasonable prices, and efficient service.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWc%7CCAIQACorChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWcSDAis0fW-BhCIp7blAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }
Text Search (New) request
The following example requests a review summary for a coffee shop in New York City:
curl -X POST -d '{
"textQuery": "coffee shop",
"locationBias": {
"circle": {
"center": {
"latitude": 40.722630,
"longitude": -74.001397
}
}
},
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchText'
The response body is in the form:
{ "places": [ { "id": "ChIJyfJXNphZwokRbo-oe0DjVT4", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1", }, "reviewSummary": { "text": { "text": "People say this coffee shop serves delicious oat milk lattes, iced lattes, and cappuccinos, and they praise the friendly staff and cozy atmosphere. They also highlight the great outdoor seating area and the unique latte flavors.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkE%7CCAIQACorChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkESDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJl5qG27RZwokRzoy63vyI4Gk", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259b4db869a97:0x69e088fcdeba8cce!9m1!1b1", }, "reviewSummary": { "text": { "text": "People say this coffee shop serves delicious matcha, including the Blueberry Matcha Latte and Cherry Cold Brew Latte, and offers a variety of pastries. They also highlight the friendly and efficient staff, and the cute and aesthetic space.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXc%7CCAIQACorChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
Nearby Search (New) request
The following example requests hotels near downtown Seattle:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 47.609937,
"longitude": -122.340714
},
"radius": 1000
}
},
"includedTypes": ["hotel"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchNearby'
The response is in the form:
{ "places": [ { "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1", }, "reviewSummary": { "text": { "text": "Guests say this hotel has comfortable beds, spacious rooms, and a central location within walking distance of Pike Place Market, the waterfront, and the convention center. They also highlight the friendly and helpful staff, the modern and clean facilities, and the efficient elevators.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkJtODg0RUFFSndKbnhkTXZBQVpuV2c%7CCAIQACorChtyc19oOkJtODg0RUFFSndKbnhkTXZBQVpuV2cSDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U", "googleMapsLinks": { "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1", }, "reviewSummary": { "text": { "text": "Guests say this hotel offers comfortable beds, spacious rooms with great views, and a well-equipped gym and pool. They also highlight the friendly and helpful staff, convenient location for walking to attractions and restaurants, and the well-stocked club lounge.\n\nSome reviews mention the elevators can be slow.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blJFWWtBUFo5bjNYWndBQVYxZWc%7CCAIQACorChtyc19oOkE4blJFWWtBUFo5bjNYWndBQVYxZWcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
Attributions
All AI-powered summaries displayed in your app must be accompanied by the appropriate attribution in accordance with Google's policies and standards. For more information, see Policies for Places API.