AI 赋能的地点摘要是简短的 100 个字符的概览,专门针对给定的地点 ID。地点摘要将许多不同类型的数据汇总到高级概览中,帮助用户快速了解某个地点。
例如,地点摘要可能会突出显示某个地点提供的热门食品、服务或商品:
- “Forum Shops 餐厅,在 休闲空间中供应大量传统意大利美食。”
- “时尚沙龙,提供剪发、染发和吹发服务。”
- “大型商店,有许多供应商提供各种复古装饰品、家具和服装。”
地点摘要受 地点详情(新)、 文本搜索(新)、 和 附近搜索(新)支持。 地点摘要适用于Supported types中显示的地点的类型,适用于以下类别: 文化、娱乐和休闲、食品和饮品、购物、 服务和体育。
地点摘要支持以下语言和区域中的兴趣点:
| 语言 | 区域 |
|---|---|
| 英语 |
印度 美国 |
请求生成地点摘要
如需在响应中返回地点摘要,请在请求的 字段掩码中添加以下字段:
- 地点详情(新) :
generativeSummary - 文本搜索(新) 和附近搜索(新) :
places.generativeSummary
generativeSummary generativeSummary:
generativeSummary:地点摘要。overviewFlagContentUri:用户可以标记地点摘要问题的链接。disclosureText:本地化文本字符串,其中包含必须纳入归因的披露文本“Summarized with Gemini”。
地点详情(新)请求
以下地点详情(新)请求会返回伊利诺伊州芝加哥一家寿司餐厅的 overview 摘要:
curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,generativeSummary"
响应采用以下格式:
{ "displayName": { "text": "Sushi Nova - Lincoln Park", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.", "languageCode": "en-US" }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12", "disclaimerText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }
文本搜索(新)请求
以下文本搜索(新)请求会返回加利福尼亚州山景城一家素食餐厅的 overview 摘要:
curl -X POST -d '{
"textQuery": "Spicy Vegetarian Food",
"location_bias": {
"rectangle": {
"low": {
"latitude": 37.415,
"longitude": -122.091
},
"high": {
"latitude": 37.429,
"longitude": -122.065
}
}
},
"maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'
响应采用以下格式:
{ "places": [ { "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI", "displayName": { "text": "Plant-Based Vegan Vietnamese", "languageCode": "en" } }, { "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI", "displayName": { "text": "sweetgreen", "languageCode": "en" }, "generativeSummary": { "overview": { "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.", "languageCode": "en-US" }, "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
附近搜索(新)请求
以下附近搜索(新)请求会返回俄勒冈州波特兰的餐厅和咖啡馆的 overview 摘要:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 45.553360,
"longitude": -122.674934
},
"radius": 1000
}
},
"includedTypes": ["restaurant", "cafe"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'
响应采用以下格式:
{ "places": [ { "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY", "generativeSummary": { "overview": { "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.", "languageCode": "en-US" }, "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, { "id": "ChIJU4OzoWynlVQRxlQMpGenSvA", "generativeSummary": { "overview": { "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.", "languageCode": "en-US" }, "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" } } }, /.../ ] }
归因
根据 Google 的政策和标准,应用中显示的所有 AI 驱动的摘要都必须附有适当的归因。如需了解 详情,请参阅 Places API 政策。