Places API 會在回應中傳回地點資訊。除了地址和電話號碼等事實內容,回應內容也可能包含使用者在 Google 地圖上提供的內容,例如評論和相片。此外,如果您使用 Places API 的 Gemini 模型功能,回應可能會包含從 LLM 匯總和匯入的生成式資料。
雖然 Google 已實施一系列措施,在 Places API 傳回問題內容前加以識別,但我們也提供一種方法,讓使用者標記不當內容,以便 Google 移除這些內容。這個版本推出後,Places API 會在 Places API 回應包含所有評論、相片和生成式摘要中加入新的 flagContentUri
欄位。這個欄位包含連結,其中包含專屬內容 ID,可讓使用者向 Google 回報不當內容。
舉例來說,您提出的要求會傳回某個地點的五則個別評論。每則評論都包含新的 flagContentUri
欄位,其中包含該評論的專屬 ID,方便使用者針對任何或所有評論回報問題。
API Explorer 可讓您發出即時要求,以便熟悉這些新選項:
連結格式
flagContentUri
欄位中的網址包含內容專屬的 ID。點選這個連結會開啟 Google 代管的網頁,格式如下:
使用者可以透過這個對話方塊向 Google 回報適當的問題類型。例如,他們可以檢舉不雅用語、霸凌行為或內容中的法律問題。
定價
這項功能目前處於正式發布前預覽階段,因此在預覽期間使用時不會產生費用,也就是帳單金額為 $0。如要進一步瞭解建議的定價,請參閱「Places API 用量與計費」一文。
顯示內容回報連結
這個預先發布版會將新的 flagContentUri
欄位新增至下列已納入 Places API 回應的物件:
Review
Photo
GenerativeSummary
僅適用於GenerativeSummary
,有兩個新欄位: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
欄位,包括該評論的專屬 ID。點選該連結後,客戶就能針對該評論檢舉不當內容。
如果您在欄位遮罩中加入 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 圖示 。
視需要展開「Show Standard parameters」,然後將
fields
參數設為欄位遮罩。視需要編輯「要求主體」。
選取「執行」按鈕。在對話方塊中,選擇要用來提出要求的帳戶。
在 API Explorer 面板中,選取展開圖示 來展開 API Explorer 視窗。