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 提供多種折扣價商品。」

大型語言模型產生的內容可強化回覆內容,並提供額外資訊,協助使用者做出明智的決定。

Places API 新增 AI 技術輔助功能 (新功能)

這些功能會在 Places API (新版) 回應中加入下列資料:

生成式地點摘要

生成式地點摘要是特定地點 ID 的摘要。地點摘要會將多種不同類型的資料匯總為單一地點摘要。

Places API (新版) 提供兩種生成式地點摘要:

  • 總覽摘要:地點的簡短總覽,平均約 100 個半形字元,可協助使用者掌握地點的概況。

  • 說明摘要:提供地點的詳細摘要,平均長度約為 400 個半形字元,涵蓋地點的主要面向。

目前,地點摘要適用於「文化」、「娛樂與休閒」、「餐飲」、「購物」和「運動」類別的「支援的地點類型」中顯示的地點類型。

生成式區域摘要

大型語言模型會為地點附近的區域建立生成式區域摘要。地點的區域摘要可能包含使用者做出決定所需的所有資訊,使用者不必再提出其他要求,即可深入瞭解區域詳細資料。

除了區域說明之外,回應還包含說明中參照的地點 ID 清單,以及依不同內容類型排序的地點清單。舉例來說,一個內容類型包含與該地區活動相關聯的地點清單,另一個則包含該地區的餐廳清單。

目前,區域摘要僅適用於「住宿」類別的支援類型中顯示的地點類型,以及特定地點類型 electric_vehicle_charging_stationgeocodepremise

產生地點和區域摘要

Google 經常離線產生生成式地點摘要和生成式區域摘要。您可以離線產生這些摘要,充分利用 Gemini 提供的內容,同時維持 Places API (新版) 的預期成效。

Google 會經常重新產生這些摘要,確保摘要內容根據最新可用資訊保持新鮮。也就是說,您在呼叫 API 時,服務會顯示最新的資料。

內容比對搜尋結果

Text Search (新版) 可根據字串 (例如「台南魯肉飯」或「西門町附近的鞋店」),傳回一組地點的相關資訊。Text Search (新版) 回應包含與文字字串相符的地點清單,以及要求中設定的任何位置偏誤。

將內容搜尋結果加入回覆後,回覆內容現在會加入評論、相片和說明,協助使用者回答問題:

  • 為什麼搜尋結果中會顯示這個地點?
  • 為什麼我應該選擇這個地點?

舉例來說,您今天向 Place Details (新版)、Text Search (新版) 或 Nearby Search (新版) 提出要求,要求的回應中包含特定地點。由於傳回的資料與該地點相關,因此所有三個要求的地點回應資料都相同。

不過,如果是使用新功能的文字搜尋 (新版),回應可能會包含來自輸入查詢字串本身的資料。也就是說,關聯搜尋結果是查詢字串專屬的。舉例來說,您可以使用下列查詢字串提出 Text Search (New) 要求:

「位於加州山景城的 素食餐廳,提供辛辣料理」

接著,請保留所有輸入參數,只將查詢字串變更為:

「位於加州山景的純素餐廳」

如果兩個回應中都顯示餐廳,則該地點的回應資料會相同,因為這些資料與地點本身相關。不過,比對內容搜尋結果是獨一無二的,因為它們是從查詢字串衍生而來。接著,您可以向使用者顯示相關內容搜尋結果中的評論、相片和說明,協助他們決定回覆中哪個地點最符合他們的搜尋要求。

啟用 Places API 的 Gemini 模型功能 (新功能)

您必須啟用 Places API (新版),才能使用 Gemini 模型功能。詳情請參閱「設定 Google Cloud 專案」。

實驗性版本的限制

這個版本僅支援美國境內地點的英文地點和區域摘要。

Gemini 是什麼?

如要瞭解 Gemini 模型,請參閱 Gemini 常見問題

要求生成式地點摘要

地點摘要是大型語言模型為特定地點產生的摘要。Places API (新版) 會在回應中加入兩種摘要:

  • 總覽產生摘要,類似與地點相關的靜態編輯摘要。生成式簡短摘要的字元數平均約為 100 個,具有以下幾項優點:

    • 許多地點都沒有編輯摘要,因此摘要可填補地點資訊的空白。

    • 這些資訊是由 LLM 產生,因此地點擁有者不需要維護這些資訊。

  • 說明生成摘要的來源眾多,包括 Google 地圖的評論。說明的字元數平均約為 400 個,其中包含用於產生長說明的評論清單。

    如要手動產生說明摘要,就必須由人手動匯總來自多個位置的資料,然後手動編寫並維護內容。Places API (新版) 的 Gemini 模型功能會從 LLM 建立這些摘要,以維持產生內容的範圍和新鮮度。

Place Details (新版)Text Search (新版)Nearby Search (新版) 都支援地點摘要。如要在回應中加入地點摘要,請在要求的欄位遮罩中加入下列欄位:

  • 地點詳細資料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"
        }
      }
    },
  . . .
}

要求產生區域摘要

區域摘要是大型語言模型為某處附近地區產生的摘要。區域摘要對於使用者決定是否前往某個地點來說,可能相當重要。

舉例來說,假設您想預訂新城市的飯店,雖然您可以找到符合需求的飯店,但也想進一步瞭解飯店周邊地區。您可以為飯店產生區域摘要,而非查看周邊地區的地圖,然後調查地圖上的每個地點。

Place Details (新版)Text Search (新版)Nearby Search (新版) 支援地區摘要。

如要在回應中加入區域摘要,請在要求的欄位遮罩中加入以下內容:

  • areaSummary (Place Details)
  • places.areaSummary (文字搜尋和附近搜尋)。

回應中地點的 areaSummary 欄位包含 flagContentUri 欄位,您可以使用該欄位檢舉不當內容,讓 Google 移除這些內容。也包含最多四個 contentBlocks 的陣列。每個區塊的主題取決於地點類型:

  • 電動車充電站定義為 electric_vehicle_charging_station 類型的地點,因此主題區塊包括 "overview""coffee""restaurant""store"

  • 如果地點類型是由住宿類別定義,以及特定地點類型 geocodepremise,主題區塊包括:"overview""activity""restaurant""store"

電動車充電站區域摘要要求範例

這個 Place Details 要求範例會傳回 Mountain View 中特定電動車充電站 (以地點 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"
  }
}

飯店區域摘要要求範例

以下範例 Text Search 要求會搜尋加州山景市的飯店:

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"
      }
    },
    ...
  ]
}

要求內容比對搜尋結果

Text Search (新版) 要求的回應包含符合輸入搜尋字串條件的地點陣列。您現在可以根據對 API 輸入的查詢,在回應中要求相關內容搜尋資料。

為了支援內容摘要,Text Search (New) 的回應會包含名為 contextualContents 的新陣列,其層級與回應中的 places 陣列相同:

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

contextualContents 陣列中每個元素的類型為 ContextualContent,位於 places 陣列中的對應陣列位置。也就是說,contextualContents[0] 中的元素對應至 places[0] 中的地點。

每個陣列元素都包含下列陣列欄位:

  • contextualContents.reviews:最多包含三則評論的陣列。
  • contextualContents.photos:最多五張相片的陣列。
  • contextualContents.justifications:地點的正當性陣列,包括:

    • reviewJustification:醒目顯示使用者評論中可能引起使用者興趣的部分。
    • businessAvailabilityAttributesJustification:包含可能符合使用者需求的業務屬性。

如要在回應中加入情境搜尋結果,請在「Text Search (New)」要求的欄位遮罩中加入 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 欄位所含專屬 ID 回報問題的連結。使用生成式 AI 說明摘要時,必須加入摘要來源的相關資訊,稱為參考資料

如要啟用對話方塊的存取權,請加入資訊圖示 (做為互動式操作提示) 並搭配 AI 歸因功能 (如上方範例所示),並讓 AI 歸因區域和圖示回應按下/點選動作。

針對生成式地點摘要,請顯示:

關於 AI 地點摘要是根據 Google 評論和其他資料產生。
回報問題 如要向 Google 回報摘要內容相關問題,請使用 flagContentUri 欄位中的連結。
參考資料 來源評論

例如:

在對話方塊中顯示生成式 AI 摘要的相關資訊。

針對生成式區域摘要,請顯示:

關於 AI 區域摘要是根據 Google 評論和當地資料產生。
回報問題 如要向 Google 回報摘要內容相關問題,請使用 flagContentUri 欄位中的連結。

顯示區域摘要歸屬資訊。