このページは Cloud Translation API によって翻訳されました。

AI によるクチコミの要約

AI によるクチコミの要約は、ユーザーのクチコミのみに基づいて AI が生成した場所の要約です。レビューの要約では、場所の属性やレビュー投稿者の感情など、ユーザーレビューの重要な要素を統合することで、概要レベルの分析情報を提供し、ユーザーが情報に基づいて判断できるようにします。

たとえば、サンフランシスコのフェリービルディングのレビューの概要には、食べ物やショッピングから景色や雰囲気まで、さまざまな情報が含まれています。

「この歴史的なランドマークには、さまざまなショップ、レストラン、農産物販売店があり、湾と街の景色を称賛する声が多く寄せられています。また、活気のある雰囲気、他の目的地へのフェリーの利便性、地元のお店を楽しめる機会も強調しています。」

レビューの概要は、Place Details（新版）、テキスト検索（新版）、Nearby Search（新版）でサポートされています。

レビューの要約は、次の言語と地域でスポットに対してサポートされています。

言語	地域
英語	インド日本英国米国
日本語	日本

言語

地域

英語

インド

日本

英国

米国

日本語

日本

AI を活用した概要のデモを試す

レビューの要約をリクエストする

レビューの概要をリクエストするには、リクエストのフィールドマスクに reviewSummary を含めます。

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

クチコミの要約の帰属表示には、Google マップ上の場所のクチコミへのリンクを含める必要があります。そのリンクを取得するには、リクエストのフィールドマスクに reviewSummary.reviewsUri を含めます。

レスポンスの本文には、次の 3 つのフィールドが含まれます。

text: AI 生成のレビューの概要。
flagContentUri: Google による削除のために不適切なコンテンツを報告するために使用されます。
disclosureText: 帰属表示に組み込む必要がある「Gemini で要約」という開示テキストを含むローカライズされたテキスト文字列。

Place Details (New) リクエスト

次の例では、ニューヨークにある餃子店のレビューの概要をリクエストしています。

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

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

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "reviewSummary": {
    "text": {
      "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    },
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1"
  }
}

Text Search（新版）リクエスト

次の例では、ニューヨークのコーヒーショップのレビューの概要をリクエストしています。

curl -X POST -d '{
  "textQuery": "coffee shop",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 40.722630,
        "longitude": -74.001397
      }
    }
  },
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1"
      }
    },
    {
      "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ",
      "reviewSummary": {
        "text": {
          "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1"
      }
    },
    ...
  ]
}

Nearby Search（新規）リクエスト

次の例では、シアトルダウンタウン近くのホテルをリクエストしています。

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