Сводные обзоры, созданные с помощью ИИ, представляют собой краткие описания мест, сгенерированные искусственным интеллектом исключительно на основе отзывов пользователей. Обобщая ключевые элементы отзывов пользователей, такие как характеристики места и тональность отзывов, сводные обзоры предоставляют общую информацию и помогают пользователям принимать обоснованные решения.
Например, в обзоре здания паромного терминала в Сан-Франциско содержится информация, начиная от ресторанов и магазинов и заканчивая видами и атмосферой:
«Посетители отмечают, что эта историческая достопримечательность предлагает разнообразный выбор магазинов, ресторанов и фермерского рынка, а многие хвалят виды на залив и город. Они также подчеркивают оживленную атмосферу, удобное паромное сообщение с другими пунктами назначения и возможность посетить местные магазины».
Сводные данные об отзывах поддерживаются в разделах «Подробная информация о месте» (Новая функция) , «Текстовый поиск» (Новая функция) и «Поиск поблизости» (Новая функция) .
Поддерживается создание кратких обзоров по интересующим вас моментам на следующих языках и в следующих регионах:
| Язык | Область |
|---|---|
| Английский | Аргентина, Боливия, Бразилия, Чили, Колумбия, Коста-Рика, Доминиканская Республика, Эквадор, Гватемала, Индия, Япония, Мексика, Парагвай, Перу, Соединенное Королевство, Соединенные Штаты, Уругвай, Венесуэла |
| японский | Япония |
| португальский | Бразилия |
| испанский | Аргентина, Боливия, Чили, Колумбия, Коста-Рика, Доминиканская Республика, Эквадор, Гватемала, Мексика, Парагвай, Перу, США, Уругвай, Венесуэла |
Запросить краткий обзор
Чтобы запросить сводку по результатам проверки, укажите reviewSummary в поле запроса:
- Подробная информация о месте (новое):
reviewSummary - Текстовый поиск (новый) и поиск поблизости (новый):
places.reviewSummary
Для получения краткого описания отзыва необходимо указать ссылку на отзывы о данном месте на Google Maps. Чтобы получить эту ссылку, добавьте reviewSummary.reviewsUri в поле mask запроса.
Ответный текст содержит три поля:
-
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. Для получения дополнительной информации см. раздел «Политика в отношении Places API» .