API Places (New) возвращает информацию о месте в ответе. Наряду с фактическим контентом, таким как адрес и номер телефона, ответ может также содержать контент, который пользователи внесли в Google Maps, такой как отзывы и фотографии. Кроме того, когда вы используете возможности модели Gemini для API Places (New) , ответ может включать генеративные данные, агрегированные и обобщенные из LLM.
Хотя Google реализовал ряд мер по выявлению проблемного контента до того, как он будет возвращен API Places (New), мы также предоставляем пользователям возможность помечать неприемлемый контент, чтобы Google мог его удалить. С этим выпуском API Places (New) включает новое поле flagContentUri
во все обзоры, фотографии и генеративные резюме, включенные в ответ API Places (New). Это поле содержит ссылку, включая уникальный идентификатор контента, который позволяет пользователям уведомлять Google о неприемлемом контенте.
Например, вы делаете запрос, который возвращает пять отдельных отзывов о месте. Каждый отдельный отзыв включает новое поле flagContentUri
с уникальным идентификатором для этого отзыва, чтобы пользователь мог сообщить о проблеме с любым или всеми отзывами.
API Explorer позволяет вам делать запросы в реальном времени, чтобы вы могли ознакомиться со следующими новыми возможностями:
Формат ссылки
URL, содержащийся в поле flagContentUri
, включает уникальный идентификатор для контента. Переход по этой ссылке открывает веб-страницу, размещенную Google, в форме:
Из этого диалогового окна ваши пользователи могут отправить отчет в Google по соответствующему типу проблемы. Например, они могут сообщить о ненормативной лексике, издевательствах или юридической проблеме с контентом.
Отобразить ссылку для сообщения о контенте
Поле flagContentUri
доступно в следующих объектах, которые уже являются частью ответа API Places (новый):
-
Review
-
Photo
-
GenerativeSummary
-
NeighborhoodSummary
-
EvChargeAmenitySummary
-
ReviewSummary
-
ContextualContent
При отображении этих объектов необходимо отображать ссылку для сообщения о контенте, чтобы ваши клиенты могли сообщать о любых проблемах с контентом.
Перейдите по ссылке для сообщения о контенте в ответе.
Следующий запрос «Сведения о месте (новый)» включает в себя отзывы о месте в ответе:
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,
, на правой стороне страницы.
При желании можно развернуть Показать стандартные параметры и задать параметру
fields
маску поля .При желании отредактируйте текст запроса .
Нажмите кнопку «Выполнить» . В диалоговом окне выберите учетную запись, которую вы хотите использовать для выполнения запроса.
На панели API Explorer выберите значок развертывания,
, чтобы развернуть окно API Explorer.