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

AI を活用したエリアの概要は、場所の周辺エリアについて生成されます。エリアの概要には、周辺のスポットなど、場所に関する追加情報が表示されるため、ユーザーは目的地やアクティビティについて、より多くの情報に基づいて決定を下すことができます。

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

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

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

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

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

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

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

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

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

近隣の概要をリクエストする

近隣地域の概要は、住宅カテゴリと宿泊施設カテゴリのタイプを持つ場所に対して生成できます。レスポンスで近隣地域の概要を返すには、リクエストのフィールド マスクに次の内容を含めます。

  • Place Details（新規）: neighborhoodSummary
  • テキスト検索（新版）と周辺検索（新版）: places.neighborhoodSummary

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

  • 2 つのサブフィールド: 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
  • テキスト検索（新版）と周辺検索（新版）: places.evChargeAmenitySummary

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

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

次の例では、Mountain View の充電スタンドの 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 のポリシーをご覧ください。