AI を活用したエリアの概要

AI を活用したエリアの要約は、ある場所の周辺エリアについて生成されます。エリアの要約では、付近のスポットなど、場所に関する追加のコンテキスト情報が提供されるため、ユーザーは目的地や到着後の行動について、より多くの情報に基づいて判断できます。

たとえば、新しい都市を訪れる際に、ホテルの生成された周辺地域の要約を表示して、周辺エリアについて詳しく知ることができます。

  • 「サンフランシスコの活気あふれるこのエリアは、ノースビーチとチャイナタウンが融合した場所で、 金融街の北西に位置しています。文学的なランドマーク、 ユニークな文化施設、多様なレストランが特徴です。有名なスポットには、象徴的なシティライツ書店、魅力的なケーブルカー博物館、賑やかなチャイナタウンの街並みなどがあります。」

    「このエリアは、歴史と文化が独特の形で融合しています。丘や人混みはありますが、歩行者に優しい環境なので散策を楽しめます。シティライツ書店で文学史に浸ったり、寺院やフォーチュン クッキー工場があるチャイナタウンの活気ある文化を体験したり、ケーブルカー博物館で過去にタイムスリップしたりできます。本格的な中華料理からおいしいピザまで、さまざまな 料理を楽しめます。」"

電気自動車の充電を検討している場合は、電気自動車充電スタンドの生成された要約を表示して、充電中に立ち寄れる近くのコーヒー ショップやレストランを見つけることができます。

  • 「このエリアには、徒歩 9 分圏内に スターバックス、寿司人、セーフウェイなど、さまざまなレストランがあります。」

レスポンスには、エリアの説明とともに、説明で参照されている場所の場所 ID のリストも含まれます。

Places API（新版）では、次の 2 種類の AI を活用したエリアの要約が提供されます。

AI を活用したエリアの要約は、 Place Details（新版）、 テキスト検索（新版）、 および Nearby Search（新版）でサポートされています。

エリアの要約は、次の言語と地域のスポットでサポートされています。

言語 リージョン
英語 米国

周辺地域の要約をリクエストする

周辺地域の要約は、タイプが premise, street_address の場所、および [**住宅**] カテゴリと [**宿泊施設**] カテゴリのすべてのタイプの場所について生成できます。レスポンスで周辺地域の要約を返すには、リクエストのフィールド マスクに次のものを含めます。

  • Place Details（新版）: neighborhoodSummary
  • テキスト検索（新版） と Nearby Search（新版）: places.neighborhoodSummary

レスポンス内の場所の neighborhoodSummary フィールドには、次のものが含まれます。

  • overview と description の 2 つのサブフィールド。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 アメニティの要約をリクエストする

電気自動車充電スタンド（EVCS）のアメニティの要約は、タイプが electric_vehicle_charging_station の場所について生成できます。レスポンスに EVCS アメニティの要約を含めるには、リクエストのフィールド マスクに次のものを含めます。

  • Place Details（新版）: evChargeAmenitySummary
  • テキスト検索（新版） と Nearby Search（新版）: places.evChargeAmenitySummary

レスポンス内の場所の evChargeAmenitySummary フィールドには、次のものが含まれます。

  • overview、coffee、restaurant、store の 4 つのサブフィールド。各サブフィールドには、付近のスポットの簡単な説明と、参照されている場所のリソース名のリストが place/PLACE_ID の形式で含まれます。
  • flagContentUri リンク。ユーザーは、生成された要約の問題を報告できます。
  • 「Gemini で要約」という開示テキストを含むローカライズされたテキスト文字列。帰属表示に組み込む必要があります。

次の例では、マウンテンビューの充電スタンドの EV 充電スタンドのアメニティの要約をリクエストします。

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のポリシーをご覧ください。