适用于 Places API 的 Gemini 模型功能

适用于 Places API 的 Gemini 模型功能(新)为 Places API 引入了对 LLM 的支持,以便您返回与地点相关联的数据(营业时间、评价、照片)以及 LLM 提供的数据。这些生成式数据包含来自 LLM 的汇总数据,用于增强与地点相关联的数据。

例如,使用标准文本搜索(新)功能搜索“电动车辆充电站”会返回提供电动车辆充电服务的地点列表。如果您只是搜索最近的电动车辆充电器或与您的车辆兼容的最近的充电器,则此类响应就足够了。

不过,您可能还需要更好地了解充电站周围的区域,尤其是在车辆充电时,您需要在充电站停留一小时或更长时间时。针对同一搜索使用 Gemini 模型功能时,回答中可以包含对回答中每个地点的动态生成式描述,包括充电站周围区域的相关信息:

  • “步行 2-4 分钟即可到达多家餐厅和购物场所,包括 Chef Chu's、Gen Korean BBQ House、Amber India、Pacific Catch,以及 Walmart、Whole Foods Market 和 Trader Joe's 等多家杂货店。”

  • “步行 1-5 分钟即可到达多家餐厅和购物场所,包括 Khao Kang Thai Kitchen、Roger's Deli & Donuts 和 La Costeña。如需品尝寿司,Joy Sushi 是不错的选择。至于杂货,Dollar Tree 以折扣价提供各种商品。”

LLM 生成的内容可以增强回答,并提供额外信息,帮助用户做出明智的决策。

向 Places API 添加了依托 AI 技术的新功能(新)

这些功能会向 Places API(新版)响应中添加以下数据:

生成式地点摘要

生成式地点摘要因地点 ID 而异。地点摘要会将多种不同类型的数据汇总到一个地点摘要中。

Places API(新版)提供两种生成式地点摘要:

  • 概览摘要:地点的简短概览,平均约 100 个字符,可帮助用户快速了解地点。

  • 说明摘要:地点的较长摘要,平均约 400 个字符,提供详细概览,涵盖地点的主要方面。

目前,文化娱乐和休闲餐饮购物体育类别中受支持的类型中显示的地点类型均支持地点摘要。

生成式区域摘要

LLM 会为地点周围的附近区域创建生成式区域摘要。地点的区域摘要可能包含用户做出决策所需的所有信息,而无需用户发出进一步请求来深入了解区域详情。

除了相应区域的说明之外,响应还包含说明中提及的地点的地点 ID 列表,以及按不同内容类型排序的地点列表。例如,一种内容类型包含与该区域内的活动相关联的地点列表,另一种内容类型包含该区域内的餐厅列表。

目前,区域摘要适用于住宿类别的支持的地点类型中显示的地点类型,以及特定地点类型 electric_vehicle_charging_stationgeocodepremise

生成地点和区域摘要

生成式地点摘要和生成式区域摘要都是 Google 经常在线下生成的。通过离线生成这些摘要,您可以利用由 Gemini 提供支持的内容,同时仍能获得您预期的 Places API(新版)效果。

Google 会经常重新生成这些摘要,以确保它们基于最新可用信息。这意味着,您在调用 API 时会在服务中显示最新的数据。

内容相关搜索结果

文本搜索(新)可以根据一个字符串(例如,“北京烤鸭”“南京附近的鞋店”)返回一组地点的相关信息。文本搜索(新版)响应包含与文本字符串和请求中设置的任何位置偏向相匹配的地点列表。

当您向回答中添加上下文搜索结果时,回答现在会包含评价、照片和理由,帮助用户解答问题:

  • 为什么我会在结果中看到此地点?
  • 为什么我应该选择此地?

例如,您今天向“地点详情(新)”“文本搜索(新)”或“附近搜索(新)”发出请求,其中响应中包含特定地点。这三项请求对同一地点的响应数据相同,因为返回的数据与该地点相关联。

不过,对于使用新功能的新版文本搜索,响应可以包含从输入查询字符串本身派生的数据。这意味着,内容相关搜索结果是特定于查询字符串的。例如,您可以使用以下查询字符串发出“文本搜索(新)”请求:

“加利福尼亚州山景城提供辛辣素食的餐厅”

然后,将所有输入参数保持不变,只将查询字符串更改为:

“加利福尼亚州山景市提供辛辣纯素餐的餐厅”

对于同时出现在这两种响应中的餐厅,相应地点的响应数据相同,因为这些数据与地点本身相关联。但是,情境搜索结果因查询而异,因为它们是从查询字符串派生出来的。然后,您可以向用户显示上下文搜索结果中的评价、照片和理由,帮助他们确定响应中哪个地点最适合他们的搜索请求。

为 Places API 启用 Gemini 模型功能(新)

您必须启用 Places API(新版),才能使用适用于 Places API(新版)的 Gemini 模型功能。如需了解详情,请参阅设置您的 Google Cloud 项目

实验性版本的限制

此版本仅支持以英语显示美国境内地点和区域的摘要。

Gemini 是什么?

如需了解 Gemini 模型,请参阅 Gemini 常见问题解答

请求生成地点摘要

地点摘要是 LLM 为特定地点生成的摘要。Places API(新)会向响应中添加两种类型的摘要:

  • 概览生成式摘要,类似于与地点关联的静态编辑摘要。生成的短摘要(平均约 100 个字符)具有以下优势:

    • 许多地点都没有编辑摘要,因此编辑摘要可以填补地点信息缺口。

    • 这些地图项由 LLM 生成,因此地点所有者无需对其进行维护。

  • 说明生成式摘要源自多个来源,包括 Google 地图上的评价。说明平均约为 400 个字符,其中包含用于生成长篇幅说明的评价列表。

    若要手动生成说明摘要,需要有人汇总来自多个位置的数据,然后手动制作和维护内容。Places API 的 Gemini 模型功能(新)可根据 LLM 生成这些摘要,以保持生成内容的范围和新鲜度。

地点详情(新)文本搜索(新)附近搜索(新)支持地点摘要。如需在响应中包含地点摘要,请在请求的字段掩码中添加以下字段:

  • 地点详情generativeSummary

  • 文字搜索和附近搜索places.generativeSummary

generativeSummary 字段包含以下字段:

  • generativeSummary.overview:生成式概览摘要。
  • generativeSummary.description:生成式描述摘要。
  • generativeSummary.references:一个最多包含五条评价的数组,用于为说明摘要提供内容。如果没有说明摘要,此数组为空。
  • overviewFlagContentUri:用户可以通过此链接举报概览摘要中存在的问题。
  • descriptionFlagContentUri:用户可以通过此链接举报说明摘要存在的问题。

概览和说明摘要请求示例

以下示例使用 places.generativeSummary 字段掩码返回整个 generativeSummary 对象,包括 generativeSummary.overviewgenerativeSummary.descriptiongenerativeSummary.references 字段:

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": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "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.overview" \
https://places.googleapis.com/v1/places:searchText

响应包含 generativeSummary.overview 字段,其中包含 overview.textoverview.languageCode

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

请求生成区域摘要

区域摘要是 LLM 为地点附近区域创建的生成式摘要。区域摘要对于用户做出有关地点的决定至关重要。

例如,您想在新城市预订酒店,虽然可以找到符合您要求的酒店,但还想详细了解酒店周边的区域。您可以为酒店生成区域摘要,而不必查看周边区域的地图,然后调查地图上的每个地点。

地点详情(新)文本搜索(新)附近搜索(新)支持区域摘要。

如需在响应中包含区域摘要,请在请求的字段掩码中添加以下内容:

  • areaSummary(地点详情)
  • places.areaSummary(文本搜索和附近搜索)。

响应中地点的 areaSummary 字段包含 flagContentUri 字段,您可以使用该字段举报不当内容,以便 Google 将其移除。它还包含一个最多包含四个 contentBlocks 的数组。每个街区的主题取决于相应地点的类型:

  • 对于电动车辆充电站(定义为类型为 electric_vehicle_charging_station 的地点),主题块包括:"overview""coffee""restaurant""store"

  • 对于由住宿类别定义的类型以及特定地点类型 geocodepremise 的地点,主题块包括:"overview""activity""restaurant""store"

电动车辆充电站区域摘要的请求示例

以下“地点详情”请求示例会返回位于山景城的特定电动汽车充电站(地点 ID 为 ChIJC5b6QKiwj4ARgn2EwlnJnWU)的区域摘要:

curl -X GET -H 'Content-Type: application/json' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: id,displayName,areaSummary" \
  https://places.googleapis.com/v1/places/ChIJC5b6QKiwj4ARgn2EwlnJnWU

响应包含 areaSummary 字段,包括 contentBlocks 数组:

  • topic 字段用于指定内容块的类型。由于此示例中的地点是电动车辆充电站,因此四个内容块分别为 "overview""coffee""restaurant""store"

  • content 字段包含该主题的摘要,包括语言代码。

  • references 数组指定地点资源名称(采用 places/PLACE_ID 格式),用于为内容块提供内容。

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

酒店区域摘要请求示例

以下文本搜索请求示例会请求加利福尼亚州山景城的酒店:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "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.areaSummary" \
https://places.googleapis.com/v1/places:searchText

响应包含 areaSummary 字段,包括 contentBlocks 数组。针对类型为酒店的地点的响应包含主题 "overview""activity""restaurant""store" 的内容块:

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

请求内容相关搜索结果

文本搜索(新)请求的响应包含与输入搜索字符串的条件匹配的地点数组。现在,您可以根据向 API 输入的查询,在响应中请求内容相关搜索数据。

为了支持内容摘要,文本搜索(新)的响应包含一个名为 contextualContents 的新数组,该数组与响应中的 places 数组位于同一级别:

{
  "places": [],
  "contextualContents":[]
}

contextualContents 数组中的每个元素(类型为 ContextualContent)都位于 places 数组中相应位置。也就是说,contextualContents[0] 中的元素对应于 places[0] 中的相应位置。

每个数组元素都包含以下数组字段:

  • contextualContents.reviews:一个最多包含三条评价的数组。
  • contextualContents.photos:最多包含 5 张照片的数组。
  • contextualContents.justifications:相应地点的理由数组,包括:

    • reviewJustification:突出显示用户评价中可能对最终用户感兴趣的部分。
    • businessAvailabilityAttributesJustification:包含可能对最终用户感兴趣的商家属性。

如需在响应中包含内容相关搜索结果,请在“文本搜索(新)”请求的字段掩码中添加 contextualContents

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

响应包含响应中每个地点的 contextualContents 数组:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

汽车用例的实现指南

为了确保驾驶员安全,Google 建议在停车模式下渲染生成式 AI 摘要,以提供汽车体验。如果在驾车模式下呈现摘要,屏幕上的信息应简单、清晰且简洁,以确保驾驶员能够快速将注意力重新集中到道路上。

  • 不超过 3 行
  • 不得超过 120 个字符或 24 个字词
  • 正面最小尺寸为 24dp

尤其是在汽车环境中,开发者有责任以安全且符合所有当地法律法规的方式呈现生成式 AI 摘要。

归因

在应用中显示评价、照片和生成式 AI 摘要(包括地点和区域摘要)时,您必须确保同时显示必要的提供方说明。

显示生成式摘要的提供方信息

在应用中显示生成式 AI 摘要(包括地点和区域摘要)时,您还必须显示必要的提供方说明。本部分介绍了如何根据您在应用中显示生成式 AI 摘要的方式显示提供方说明。

在所有情况下,归因都必须采用句首字母大写的形式。提供方说明和 Google 徽标必须符合所有颜色、样式和字体标准。如需详细了解这些标准,请参阅 Places API(新版)政策

在其他 Google 数据背景下显示的生成式 AI 摘要

在这种情况下,生成式 AI 提供方信息可以单独显示在摘要上方或下方,并在其他位置依赖 Google 提供方信息。

提供方说明应使用“由 AI 总结”字样,如图所示:

作为提供方说明,请使用“由 AI 总结”字样。

单独显示的生成式 AI 摘要

当生成式 AI 摘要单独显示,而没有任何其他 Google 地图内容时,必须同时提供生成式 AI 提供方信息和 Google 提供方信息,并以英文英文句号分隔。如需提供提供方信息,请使用“由 AI 总结”文字和 Google 徽标,如图所示:

对于单独显示的摘要,请添加生成式 AI 归因和 Google 归因,并以英文句号分隔。

生成式 AI 摘要在列表中重复

在地点列表中重复生成式 AI 地点摘要概览,前提是:

  • 列表内容归 Google 所有
  • 系统显示的摘要由 AI 生成
  • 内容由 Google 提供

提供方说明应显示在列表上方或下方,且应为一行。 AI 提供方出处注明采用左对齐,Google 提供方出处注明采用右对齐:

对于列表,请在列表上方或下方单行显示提供方信息。

如果在列表中使用较长的生成式 AI 说明摘要,则每个摘要都必须带有 AI 提供方注明(带有信息图标/按钮的“由 AI 总结”)。

在对话框中显示生成式 AI 摘要的相关信息

除了生成式 AI 摘要之外,您还必须向最终用户提供一个用于显示摘要相关信息的对话框,以及一个链接,以便用户使用 flagContentUri 字段中包含的摘要唯一标识符来报告问题。使用生成式 AI 说明摘要时,您必须添加有关摘要来源的信息,称为参考文献

通过将信息图标(作为互动性功能)与 AI 提供方信息(如上例所示)结合使用,并使 AI 提供方信息区域和图标响应按压/点击,即可启用对此对话框的访问权限。

对于生成式地点摘要,请显示:

简介 AI 地点摘要是根据 Google 评价和其他数据生成的。
报告问题 如需向 Google 报告摘要内容方面的问题,请使用 flagContentUri 字段中包含的链接。
参考 来源评价

例如:

在对话框中显示生成式 AI 摘要的相关信息。

对于生成式区域摘要,请显示:

简介 AI 生成的区域摘要基于 Google 评价和本地数据。
报告问题 如需向 Google 报告摘要内容方面的问题,请使用 flagContentUri 字段中包含的链接。

显示地区摘要提供方信息。