AI 輔助區域摘要

系統會為地點周圍的區域產生 AI 技術輔助的區域摘要。區域摘要可提供地點的其他背景資訊，包括附近的興趣點，協助使用者做出更明智的決定，決定要前往哪裡，以及抵達目的地後要做些什麼。

舉例來說，當你造訪新城市時，可以查看飯店產生的街區摘要，進一步瞭解周遭環境：

  • 「這個位於舊金山的熱鬧區域，融合了北灘和唐人街的特色，位於金融區西北方，擁有文學地標、獨特的文化景點和多元餐飲選擇。值得一遊的景點包括知名的 City Lights Bookstore、迷人的纜車博物館，以及熱鬧的唐人街。

    這個區域融合了歷史與文化，雖然有部分丘陵地形和人潮，但步行友善的環境仍是探索的好去處。你可以到 City Lights Bookstore 沉浸於文學歷史，體驗唐人街的熱鬧文化，參觀寺廟和占卜餅工廠，或是到纜車博物館一窺時光荏苒。從道地中式料理到美味披薩，多種餐飲選擇等著你。

如果您考慮為電動車充電，可以查看系統產生的電動車充電站摘要，找出附近的咖啡廳或餐廳，在等待期間前往：

  • 「這個地區提供多種餐飲選擇，步行 9 分鐘內即可抵達，包括星巴克、Sushi Jin 和 Safeway。」

除了區域說明之外，回應還包含說明中參照的地點地點 ID 清單。

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

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

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

要求取得社區摘要

您可以為屬於 住宅和 住宿 類別的地點產生社區摘要。如要在回應中傳回鄰里摘要，請在要求的欄位遮罩中加入以下內容：

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

回應中地點的 neighborhoodSummary 欄位包含下列項目：

  • 兩個子欄位：overview 和 description。overview 子欄位包含該地點附近的特定景點，而 description 子欄位則提供周邊地區的一般資訊。每個子欄位都包含參照地點資源名稱的清單，格式為 place/PLACE_ID。
  • flagContentUri 連結，可讓使用者針對產生的摘要回報問題。
  • 本地化文字串列，其中包含「Summarized with 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 連結，可讓使用者針對產生的摘要回報問題。
  • 本地化文字串，其中包含「Summarized with Gemini」的揭露文字，必須納入歸屬資訊。

以下範例要求 Mountain View 電動車充電站的附加服務摘要：

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 政策」。