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 回報適當的問題類型。例如,他們可以檢舉不雅用語、霸凌行為或內容相關法律問題。
顯示內容回報連結
flagContentUri
欄位可用於下列已納入 Places API (新版) 回應的物件:
Review
Photo
GenerativeSummary
NeighborhoodSummary
EvChargeAmenitySummary
ReviewSummary
ContextualContent
您必須在顯示這些物件時顯示內容檢舉連結,讓客戶能夠回報任何內容問題。
在回覆中存取內容檢舉連結
以下 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 圖示
。
您可以選擇展開「顯示標準參數」,然後將
fields
參數設為欄位遮罩。您可以選擇編輯要求主體。
選取「執行」按鈕。在對話方塊中,選擇要用來提出要求的帳戶。
在 API Explorer 面板中,選取展開圖示
來展開 API Explorer 視窗。