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.