AI 輔助區域摘要

系統會生成地點周邊區域的 AI 輔助區域摘要。區域摘要提供地點的額外背景資訊，包括附近的搜尋熱點，方便使用者更明智地決定目的地和抵達後的活動。

舉例來說，造訪新城市時，您可以查看飯店生成的鄰近地區摘要，進一步瞭解周遭環境：

  • 「這個充滿活力的舊金山地區融合了北灘和中國城，位於金融區西北方，擁有文學地標、獨特的文化景點和多元化的餐飲。知名景點包括指標性的城市之光書店、迷人的纜車博物館，以及熱鬧的唐人街街道。

    這個地區融合了獨特的歷史和文化，雖然有些山丘和人潮，但行人友善的環境仍吸引遊客前來探索。你可以沉浸在城市之光書店的文學歷史中，體驗中國城充滿活力的文化，參觀寺廟和幸運餅乾工廠，或在纜車博物館重溫過去時光。這裡有各式各樣的餐飲選擇，從道地中式料理到美味披薩應有盡有。」

如果你想為電動車充電，可以查看電動車充電站的生成摘要，尋找附近可消磨時間的咖啡廳或餐廳：

  • 「這個區域在步行 9 分鐘的範圍內提供多種餐飲選擇，包括星巴克、Sushi Jin 和 Safeway。」

除了區域說明外，回覆也包含說明中提及的地點 ID 清單。

Places API (新版) 提供兩種 AI 輔助區域摘要：

  • 鄰近地區摘要：提供附近景點的概略總覽，適用於類型為 premise、street_address 的地點，以及住宅和住宿類別中的所有類型。
  • 電動車充電站 (EVCS) 設施摘要：提供 electric_vehicle_charging_station 類型地點附近景點的概略總覽。

Place Details (新版)、Text Search (新版) 和 Nearby Search (新版) 支援 AI 輔助區域摘要。

區域摘要功能支援下列語言和地區的搜尋點：

語言 區域
英文 美國

要求生成鄰近地區摘要

可生成鄰近區域摘要的地點類型包括 premise、street_address，以及住宅和住宿類別中的所有類型。如要在回應中傳回鄰近地區摘要，請在要求的欄位遮罩中加入下列內容：

  • Place Details (新版)： neighborhoodSummary
  • Text Search (新版) 和 Nearby Search (新版)： places.neighborhoodSummary

回應中地點的 neighborhoodSummary 欄位包含下列內容：

  • 兩個子欄位：overview 和 description。overview 子欄位包含該地點附近的特定搜尋點，description 子欄位則提供周邊區域的一般資訊。每個子欄位都包含參照的地點資源名稱清單，格式為 place/PLACE_ID。
  • flagContentUri 連結，使用者可點選該連結，檢舉生成的摘要有問題。
  • 本地化文字字串，內含揭露文字「使用 Gemini 摘要」，必須納入出處。

以下範例要求紐約市某間飯店的周邊摘要：

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

回應格式如下：

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

要求提供 EVCS 設施摘要

系統可為類型為 electric_vehicle_charging_station 的地點，生成電動車充電站 (EVCS) 設施摘要。如要在回應中加入 EVCS 設施摘要，請在要求的欄位遮罩中加入下列內容：

  • Place Details (新版)： evChargeAmenitySummary
  • Text Search (新版) 和 Nearby Search (新版)： places.evChargeAmenitySummary

回應中地點的 evChargeAmenitySummary 欄位包含下列內容：

  • 四個子欄位：overview、coffee、restaurant 和 store。每個子欄位都包含附近搜尋點的簡短說明，以及參照的地點資源名稱清單，格式為 place/PLACE_ID。
  • flagContentUri 連結，使用者可點選該連結，標記生成摘要的問題。
  • 本地化文字字串，內含揭露文字「使用 Gemini 摘要」，必須納入出處。

以下範例要求提供山景城充電站的電動車充電站設施摘要：

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

回應格式如下：

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

歸因

應用程式顯示的所有 AI 輔助摘要，都必須依據 Google 政策和標準，附上適當的出處。詳情請參閱「Places API 政策」。