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