Новый Places API возвращает в ответе информацию о месте. Помимо фактических данных, таких как адрес и номер телефона, ответ может содержать контент, добавленный пользователями в Google Карты, например отзывы и фотографии. Кроме того, если вы используете возможности модели Gemini для Places API (New), ответ может включать сгенерированные данные, агрегированные и обобщенные с помощью LLM.
Хотя Google принимает ряд мер для выявления проблемного контента до того, как он будет возвращен Places API (New), мы также предоставляем пользователям возможность помечать неприемлемый контент, чтобы Google мог его удалить. В этом выпуске Places API (New) включает новое поле flagContentUri во всех отзывах, фотографиях и сводках, созданных генеративным ИИ, которые включены в ответ Places API (New). Это поле содержит ссылку, включающую уникальный идентификатор контента, которая позволяет пользователям уведомлять Google о неприемлемом контенте.
Например, вы делаете запрос, который возвращает пять отдельных отзывов о месте. Каждый отзыв содержит новое поле flagContentUri с уникальным идентификатором, чтобы пользователь мог сообщить о проблеме с любым из отзывов.
API Explorer позволяет отправлять запросы в реальном времени, чтобы вы могли ознакомиться с новыми возможностями:
Формат ссылки
URL, указанный в поле flagContentUri, содержит уникальный идентификатор контента. При переходе по этой ссылке открывается веб-страница, размещенная в Google, в следующем формате:
В этом диалоговом окне пользователи могут отправить в Google жалобу на проблему определенного типа. Например, они могут сообщить о непристойной лексике, буллинге или проблеме юридического характера с контентом.
Показывать ссылку для отправки жалоб на контент
Поле flagContentUri доступно в следующих объектах, которые уже входят в ответ Places API (New):
ReviewPhotoGenerativeSummaryNeighborhoodSummaryEvChargeAmenitySummaryReviewSummaryContextualContent
Вы должны показывать ссылку на форму отправки жалоб на контент вместе с этими объектами, чтобы ваши клиенты могли сообщать о проблемах с контентом.
Как перейти по ссылке для отправки жалобы на контент в ответе
В следующем запросе Place Details (New) в ответ включаются отзывы о месте:
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маску поля.При необходимости измените тело запроса.
Нажмите кнопку Execute (Выполнить). В диалоговом окне выберите аккаунт, который хотите использовать для отправки запроса.
На панели API Explorer нажмите на значок развертывания
, чтобы развернуть окно API Explorer.