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

AI によるエリアの概要は、場所の周辺エリアに対して生成されます。エリアの概要には、近くのスポットなど、場所に関する追加のコンテキスト情報が表示されるため、ユーザーはどこに行くか、到着後に何をするかについて、より多くの情報に基づいて決定を下すことができます。

たとえば、初めて訪れる都市で、ホテルの周辺地域について詳しく知るために、生成された周辺地域の概要を表示できます。

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

    このエリアは歴史と文化が独自に融合した場所で、坂道や混雑はあるものの、歩行者に優しい環境が探索を誘います。シティ ライツ ブックストアで文学の歴史に浸ったり、寺院やフォーチュン クッキー工場があるチャイナタウンの活気ある文化を体験したり、ケーブルカー博物館でタイムスリップしたりできます。本格的な中華料理から美味しいピザまで、さまざまな飲食店が揃っています。」

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

  • 「このエリアには、スターバックス、Sushi Jin、Safeway など、徒歩 9 分圏内にさまざまな飲食店があります。」

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

Places API（新規）は、AI を活用した 2 種類のエリア概要を提供します。

  • 近隣の概要。タイプが premise、street_address、および住宅カテゴリと宿泊施設カテゴリのすべてのタイプの場所について、近隣の観光スポットの概要を提供します。
  • 電気自動車充電スタンド（EVCS）の設備概要。タイプ electric_vehicle_charging_station の場所の近くにある観光スポットの概要を提供します。

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 フィールドには、次の情報が含まれます。

  • 4 つのサブフィールド: overview、coffee、restaurant、store。各サブフィールドには、近くのスポットの簡単な説明と、参照される場所のリソース名のリスト（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 のポリシーをご覧ください。