AI 輔助評論摘要是指 AI 根據使用者評論所產生的地點摘要。評論摘要會綜合使用者評論的關鍵元素 (例如地點屬性和評論者情緒)，提供高層次的洞察資料，協助使用者做出明智的決定。
舉例來說，舊金山渡輪大廈的評論摘要包含從美食、購物到景色和氛圍等資訊：
「遊客表示，這個歷史地標提供多樣化的商店、餐廳和農夫市集，許多人也稱讚灣區和城市的景色。他們也強調充滿活力的氛圍、可搭乘渡輪前往其他目的地，以及享受當地商家的機會。」
Place Details (新版)、Text Search (新版) 和 Nearby Search (新版) 支援評論摘要。
要求提供審查摘要
如要要求審查摘要，請在要求的欄位遮罩中加入 reviewSummary：
- Place Details (新版)：
reviewSummary - Text Search (新版) 和 Nearby Search (新版)：
places.reviewSummary
評論摘要的出處註明必須包含 Google 地圖上該地點的評論連結。如要擷取該連結，請在要求的欄位遮罩中加入 googleMapsLinks.reviewsUri。
回應本文包含三個欄位：
text：AI 生成的評論摘要。flagContentUri：用於標記不當內容，以便 Google 移除。disclosureText：包含「Summarized with Gemini」的說明文字，必須納入歸屬資訊。
Place Details (New) 要求
以下範例會要求紐約市一家餃子餐廳的評論摘要：
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"
回應的格式如下：
{ "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 (新版) 要求
以下範例會要求取得紐約市某間咖啡廳的評論摘要：
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'
回應主體的格式如下：
{ "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 (新版) 要求
以下範例會要求西雅圖市中心附近的飯店：
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'
回應的格式如下：
{ "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" } } }, /.../ ] }
歸因
應用程式中顯示的所有 AI 技術摘要，都必須根據 Google 政策和標準附上適當的出處資訊。詳情請參閱「Places API 政策」。