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