Bản tóm tắt bài đánh giá dựa trên AI là bản tóm tắt do AI tạo về các địa điểm, chỉ dựa trên bài đánh giá của người dùng. Bằng cách tổng hợp các yếu tố chính trong bài đánh giá của người dùng, chẳng hạn như thuộc tính của địa điểm và cảm xúc của người đánh giá, bản tóm tắt bài đánh giá cung cấp thông tin chi tiết cấp cao và giúp người dùng đưa ra quyết định sáng suốt.
Ví dụ: bản tóm tắt bài đánh giá về Ferry Building ở San Francisco bao gồm thông tin về đồ ăn và mua sắm cho đến khung cảnh và bầu không khí:
"Du khách cho biết địa danh lịch sử này có nhiều cửa hàng, nhà hàng và chợ nông sản, trong đó nhiều người khen ngợi cảnh quan vịnh và thành phố. Họ cũng nhấn mạnh bầu không khí sôi động, thuận tiện khi đi phà đến các điểm đến khác và cơ hội tận hưởng các dịch vụ của doanh nghiệp địa phương".
Tóm tắt bài đánh giá được hỗ trợ trong Thông tin chi tiết về địa điểm (Mới), Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới).
Tóm tắt bài đánh giá được hỗ trợ cho các địa điểm yêu thích bằng các ngôn ngữ và khu vực sau:
| Ngôn ngữ | Khu vực |
|---|---|
| Tiếng Anh |
Ấn Độ Nhật Bản Vương quốc Anh Hoa Kỳ |
| Tiếng Nhật | Nhật Bản |
Yêu cầu xem xét tóm tắt
Để yêu cầu xem xét bản tóm tắt, hãy thêm reviewSummary vào mặt nạ trường của yêu cầu:
- Thông tin chi tiết về địa điểm (Mới):
reviewSummary - Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới):
places.reviewSummary
Thông tin ghi nhận quyền tác giả cho bản tóm tắt bài đánh giá phải có đường liên kết đến các bài đánh giá về địa điểm đó trên Google Maps. Để truy xuất đường liên kết đó, hãy thêm reviewSummary.reviewsUri vào mặt nạ trường của yêu cầu.
Phần nội dung phản hồi bao gồm 3 trường:
text: Bản tóm tắt bài đánh giá do AI tạo.flagContentUri: Dùng để gắn cờ nội dung không phù hợp để Google xoá.disclosureText: Một chuỗi văn bản đã bản địa hoá có văn bản công bố "Tóm tắt bằng Gemini" mà bạn phải đưa vào thông tin ghi công.
Yêu cầu Place Details (Mới)
Ví dụ sau đây yêu cầu một bản tóm tắt bài đánh giá cho một nhà hàng bán bánh bao ở New York:
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"
Phản hồi có dạng:
{ "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" } }
Yêu cầu Tìm kiếm bằng văn bản (Mới)
Ví dụ sau đây yêu cầu cung cấp bản tóm tắt bài đánh giá cho một quán cà phê ở Thành phố New York:
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'
Nội dung phản hồi có dạng:
{ "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" } }, ... ] }
Yêu cầu Nearby Search (Mới)
Ví dụ sau đây yêu cầu cung cấp thông tin về các khách sạn gần trung tâm thành phố Seattle:
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'
Phản hồi có dạng:
{ "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" } }, ... ] }
Phân bổ
Tất cả bản tóm tắt dựa trên AI xuất hiện trong ứng dụng của bạn đều phải có thông tin ghi nhận quyền tác giả thích hợp theo chính sách và tiêu chuẩn của Google. Để biết thêm thông tin, hãy xem Chính sách đối với Places API.