Сводки отзывов, созданные ИИ, – это сгенерированные искусственным интеллектом описания мест на основе отзывов пользователей. Сводки отзывов содержат обобщенную информацию о ключевых элементах отзывов пользователей, таких как атрибуты места и настроение рецензента, и помогают пользователям принимать обоснованные решения.
Например, в сводке отзывов о здании паромной переправы в Сан-Франциско есть информация о еде, магазинах, видах и атмосфере:
"Посетители говорят, что в этом историческом месте есть много магазинов, ресторанов и фермерский рынок, а также хвалят вид на залив и город. Они также отмечают оживленную атмосферу, удобное паромное сообщение с другими местами и возможность пользоваться услугами местных компаний".
Сводки отзывов поддерживаются в информации о местах (новая версия), текстовом поиске (новая версия) и поиске поблизости (новая версия).
Сводки отзывов поддерживаются для достопримечательностей на следующих языках и в следующих регионах:
| Язык | Регион |
|---|---|
| Английский | Аргентина, Боливия, Бразилия, Венесуэла, Гватемала, Доминиканская Республика, Индия, Испания, Колумбия, Коста-Рика, Мексика, Парагвай, Перу, США, Уругвай, Чили, Эквадор и Япония |
| Японский | Япония |
| Португальский | Бразилия |
| Испанский | Аргентина, Боливия, Венесуэла, Гватемала, Доминиканская Республика, Колумбия, Коста-Рика, Мексика, Парагвай, Перу, США, Уругвай, Чили, Эквадор |
Как запросить сводку отзывов
Чтобы запросить сводку отзывов, включите reviewSummary в маску поля запроса:
- Информация о местах (новые):
reviewSummary - Новая версия текстового поиска и новый поиск поблизости
places.reviewSummary
В атрибуции для сводки отзывов должна быть ссылка на отзывы о месте в Google Картах. Чтобы получить эту ссылку, включите reviewSummary.reviewsUri в маску поля запроса.
Тело ответа содержит три поля:
text– сводка отзывов, созданная ИИ.flagContentUri: Используется, чтобы сообщить о неприемлемом контенте, который Google должен удалить.disclosureText– локализованная текстовая строка с текстом "Пересказано с помощью Gemini", которую необходимо включить в атрибуцию.
Запрос информации о местах (новая версия)
В примере ниже показан запрос на создание сводки отзывов о ресторане, в котором подают пельмени, в Нью-Йорке:
curl -X GET https://places.googleapis.com/v1/places/ChIJD2l2k7ZL0YkRC80d-3MV1lM \ -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,reviewSummary"
Ответ имеет следующий вид:
{ "displayName": { "text": "Dumpling House", "languageCode": "en" }, "reviewSummary": { "text": { "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1" } }
Запрос к новой версии текстового поиска
В следующем примере запрашивается сводка отзывов о кофейне в Нью-Йорке:
curl -X POST -d '{
"textQuery": "coffee shop",
"locationBias": {
"circle": {
"center": {
"latitude": 40.722630,
"longitude": -74.001397
}
}
},
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchText'
Тело ответа имеет следующий вид:
{ "places": [ { "id": "ChIJyfJXNphZwokRbo-oe0DjVT4", "reviewSummary": { "text": { "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1" } }, { "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ", "reviewSummary": { "text": { "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1" } }, ... ] }
Запрос "Поиск поблизости (новая версия)"
В приведенном ниже примере запрашиваются гостиницы рядом с центром Сиэтла:
curl -X POST -d '{
"maxResultCount": 5,
"locationRestriction": {
"circle": {
"center": {
"latitude": 47.609937,
"longitude": -122.340714
},
"radius": 1000
}
},
"includedTypes": ["hotel"],
"excludedTypes": [],
"rankPreference":"POPULARITY"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchNearby'
Ответ имеет следующий вид:
{ "places": [ { "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ", "reviewSummary": { "text": { "text": "People say this hotel offers clean, modern, and spacious rooms with comfortable beds and phenomenal city views. They highlight the convenient downtown location, with easy walking access to popular attractions, and the efficient self-parking option. They also like the friendly and helpful staff, and the smooth check-in and check-out process.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3c%7CCAIQACorChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3cSDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1" } }, { "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U", "reviewSummary": { "text": { "text": "People say this hotel offers spacious rooms, a convenient location near the convention center and Pike Place Market, and a tasty restaurant. They also highlight the friendly and attentive staff, the comfortable beds and pillows, and the convenient amenities such as a Starbucks in the lobby and a club lounge.\n\nSome reviews mention the rooms can be noisy.", "languageCode": "en-US" }, "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2Nnc%7CCAIQACorChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2NncSDAikt7HDBhDopLLxAg&d=17924085&t=8", "disclosureText": { "text": "Summarized with Gemini", "languageCode": "en-US" }, "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1" } }, ... ] }
Атрибуции
Все сводки, созданные искусственным интеллектом и показываемые в вашем приложении, должны сопровождаться соответствующей атрибуцией в соответствии с правилами и стандартами Google. Подробнее о правилах в отношении API Мест…