AI を活用した場所の概要

AI による場所の要約は、特定のプレイス ID に固有の 100 文字の簡潔な概要です。場所の概要は、さまざまな種類のデータを集約して、場所の概要を把握できるようにします。

たとえば、場所の概要では、その場所で購入できる人気の料理、サービス、商品がハイライト表示されることがあります。

  • 「フォーラム ショップスにあるイタリア料理店。カジュアルな店内で、ボリュームたっぷりの伝統的なイタリア料理を楽しめる。」
  • 「ヘアカット、カラーリング、ブローを提供するスタイリッシュなサロン。」
  • 「さまざまなヴィンテージの装飾品、家具、衣料品を扱う多くのベンダーが入る大型店。」

場所の概要は、Place Details（新版）、テキスト検索（新版）、Nearby Search（新版）でサポートされています。場所の概要は、文化、エンターテイメントとレクリエーション、飲食、ショッピング、サービス、スポーツのカテゴリのサポートされているタイプに表示される場所タイプで利用できます。

場所の概要は、次の言語と地域のスポットでサポートされています。

言語 リージョン
英語

オーストラリア

カナダ

インド

ニュージーランド

シンガポール

米国

生成された場所の概要をリクエストする

レスポンスで場所の概要を返すには、リクエストのフィールド マスクに次のフィールドを含めます。

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

generativeSummary フィールドには、次のフィールドが含まれています。

  • generativeSummary: 場所の概要。
  • overviewFlagContentUri: ユーザーが場所の概要に関する問題を報告できるリンク。
  • disclosureText: アトリビューションに組み込む必要がある、開示テキスト「Gemini で要約」を含むローカライズされたテキスト文字列。

Place Details（新版）リクエスト

次の Place Details（新版）リクエストは、イリノイ州シカゴの寿司レストランの overview の概要を返します。

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

レスポンスの形式は次のとおりです。

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

テキスト検索（新版）リクエスト

次のテキスト検索（新版）リクエストは、カリフォルニア州マウンテンビューにあるスパイシーなベジタリアン レストランの overview の概要を返します。

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'

レスポンスの形式は次のとおりです。

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Nearby Search（新版）リクエスト

次の Nearby Search（新版）リクエストは、オレゴン州ポートランドのレストランとカフェの overview の概要を返します。

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

レスポンスの形式は次のとおりです。

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

帰属表示

アプリに表示される AI を活用した要約にはすべて、Google のポリシーと基準に従って適切な帰属表示を付ける必要があります。詳細については、Places API のポリシーをご覧ください。