Places API は、レスポンスでプレイスに関する情報を返します。レスポンスには、住所や電話番号などの事実に基づくコンテンツだけでなく、ユーザーが Google マップに投稿したコンテンツ(レビューや写真など)も含めることができます。また、Places API の Gemini モデル機能を使用すると、LLM から集約および要約された生成データがレスポンスに含まれる場合があります。
Google は、問題のあるコンテンツが Places API から返される前に識別するための一連の対策を実装していますが、不適切なコンテンツをユーザーが報告して Google が削除できるようにする方法も用意しています。このリリースでは、Places API レスポンスに含まれるすべてのレビュー、写真、生成された要約に、新しい flagContentUri
フィールドが追加されました。このフィールドには、ユーザーが不適切なコンテンツを Google に報告するためのリンク(一意のコンテンツ ID を含む)が含まれます。
たとえば、ある場所について 5 件の個別のクチコミを返すリクエストを作成するとします。個々のレビューには、そのレビューの一意の ID を含む新しい flagContentUri
フィールドが含まれるため、ユーザーはレビューの一部またはすべてに関する問題を報告できます。
API Explorer では、ライブリクエストを実行して、次の新しいオプションをご確認ください。
リンク形式
flagContentUri
フィールドに含まれる URL には、コンテンツの一意の識別子が含まれています。このリンクにアクセスすると、Google がホストする次の形式のウェブページが開きます。
このダイアログから、ユーザーは適切な問題の種類について Google に報告できます。たとえば、冒とく的な表現、いじめ、コンテンツに関する法律上の問題を報告できます。
料金
この機能は一般提供前のプレビュー段階にあり、プレビュー期間中の使用料金は発生しません(請求額は 0 ドル)。提案されている料金の詳細については、Places API の使用量と請求額をご覧ください。
コンテンツの報告リンクを表示する
このプレビュー リリースでは、すでに Places API レスポンスに含まれている次のオブジェクトに新しい flagContentUri
フィールドが追加されています。
Review
Photo
GenerativeSummary
GenerativeSummary
の場合のみ、次の 2 つの新しいフィールドがあります。overviewFlagContentUri
: 概要で不適切なコンテンツを Google に報告するためのリンク。descriptionFlagContentUri
: 説明内の不適切なコンテンツを Google に通知するリンク。
プレビュー期間中は、これらのオブジェクトをお客様に表示する際にコンテンツ レポート リンクを表示する必要はありません。
ただし、この機能が一般提供(GA)になると、お客様がコンテンツの問題を報告できるように、これらのオブジェクトを表示するときにコンテンツ レポート リンクを表示する必要があります。
レスポンス内のコンテンツ レポート リンクにアクセスする
次の Place Details リクエストでは、レスポンスにプレイスのクチコミが含まれます。
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
レスポンスの形式は次のとおりです。
{ "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw", "displayName": { "text": "Googleplex", "languageCode": "en" }, "reviews": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/reviews/ChdDjNnRRAB", "relativePublishTimeDescription": "7 months ago", "rating": 3, "text": { "text": "Came here for a tour and honestly,...", "languageCode": "en" }, "originalText": { "text": "Came here for a tour and honestly,...", "languageCode": "en" }, "authorAttribution": { "displayName": "John Smith", "uri": "https://www.google.com/maps/contrib/10198693/reviews", "photoUri": "https://lh3.googleusercontent.com/a-/A-c00-cc-rp-mo-ba6" }, "publishTime": "2024-02-24T19:26:18.091264Z", "flagContentUri": "https://www.google.com/local/review/rap/report?postId=CJ2&t=1", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5" }, … ] }
reviews
配列の各エントリには、特定のレビューの一意の識別子を含む flagContentUri
フィールドが含まれます。このリンクにアクセスすると、お客様はその特定のレビューの不適切なコンテンツを報告できます。
フィールドマスクに photos
を含める場合:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: id,displayName,reviews,photos" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
レスポンスには、各要素に flagContentUri
フィールドを含む photos
配列も含まれます。
... "photos": [ { "name": "places/ChIJj61dQgK6j4AR4GeTYWZsKWw/photos/AdCG2DNmA4zTnu24VKCwSW7ulKkgDA8cTe5sz74Q4Doo", "widthPx": 4032, "heightPx": 3024, "authorAttributions": [ { "displayName": "Jane Smith", "uri": "https://maps.google.com/maps/contrib/107007354", "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjXvHp8Kg932h80MpoDSJ_Sl4F-no-mo" } ], "flagContentUri": "https://www.google.com/local/imagery/report/?cb_client=maps_api_places&image_key=!1e10!2XtMU_GKr", "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5" }, ... ]
リンクの有効期限
コンテンツ リンクは、バックエンド コンテンツが削除されるまで有効です。リンクをクリックすると、削除されたコンテンツのダイアログは引き続き開きますが、すでに削除されたコンテンツについて報告しても効果はありません。
試してみよう:
API Explorer では、サンプル リクエストを実行して、API と API オプションを把握できます。
ページの右側にある API アイコン を選択します。
必要に応じて、[標準パラメータを表示] を開き、
fields
パラメータをフィールド マスクに設定します。必要に応じて、リクエスト本文を編集します。
[Execute] ボタンを選択します。ダイアログで、リクエストに使用するアカウントを選択します。
API Explorer パネルで展開アイコン を選択して、API Explorer ウィンドウを開きます。