Places API（新版）は、レスポンスで場所に関する情報を返します。レスポンスには、住所や電話番号などの事実に基づくコンテンツに加えて、クチコミや写真など、ユーザーが Google マップに投稿したコンテンツも含まれる場合があります。また、Places API（新版）の Gemini モデル機能を使用すると、LLM から集計および要約された生成データがレスポンスに含まれる場合があります。
Google では、Places API（新規）から返される前に問題のあるコンテンツを特定するための一連の対策を講じていますが、ユーザーが不適切なコンテンツにフラグを立てて Google が削除できるようにする方法も提供しています。このリリースでは、Places API（New）のレスポンスに含まれるすべてのクチコミ、写真、生成要約に、新しい flagContentUri フィールドが含まれるようになりました。このフィールドには、ユーザーが不適切なコンテンツを Google に通知できるように、一意のコンテンツ識別子を含むリンクが含まれています。
たとえば、ある場所について 5 件の個別のクチコミを返すリクエストを行うとします。個々のレビューには、そのレビューの固有識別子を含む新しい flagContentUri フィールドが含まれます。これにより、ユーザーはレビューの一部またはすべてに関する問題を報告できます。
API Explorer を使用すると、ライブ リクエストを実行して、これらの新しいオプションを理解できます。
リンク形式
flagContentUri フィールドに含まれる URL には、コンテンツの固有識別子が含まれています。このリンクにアクセスすると、次の形式の Google がホストするウェブページが開きます。
![[問題を報告] ウェブページ。](https://developers.google.cn/static/maps/documentation/places/images/report-issue.png?hl=ja)
このダイアログから、ユーザーは適切な問題タイプについて Google に報告できます。たとえば、冒とく的な表現、いじめ、コンテンツに関する法的な問題などを報告できます。
コンテンツの報告リンクを表示する
flagContentUri フィールドは、Places API（新版）のレスポンスにすでに含まれている次のオブジェクトで使用できます。
ReviewPhotoGenerativeSummaryNeighborhoodSummaryEvChargeAmenitySummaryReviewSummaryContextualContent
これらのオブジェクトを表示するときは、コンテンツの報告のリンクを表示して、ユーザーがコンテンツの問題を報告できるようにする必要があります。
回答内のコンテンツの報告リンクにアクセスする
次の 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
レスポンスには photos 配列も含まれます。各要素には flagContentUri フィールドが含まれます。
...
"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 ウィンドウを展開します。