Bản tóm tắt bài đánh giá do AI tạo 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ề nhiều khía cạnh, từ đồ ăn và mua sắm đến cảnh quan và 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, đồng thời nhiều người khen ngợi cảnh quan vịnh và thành phố. Họ cũng làm nổi bật bầu không khí sôi động, khả năng tiếp cận thuận tiện đến các điểm đến khác bằng phà và cơ hội tận hưởng các doanh nghiệp địa phương."
Bản tóm tắt bài đánh giá được hỗ trợ trong Place Details (Mới), Tìm kiếm văn bản (Mới), và Nearby Search (Mới).
Bản tóm tắt bài đánh giá được hỗ trợ cho các địa điểm thu hút trong các ngôn ngữ và khu vực sau:
| Ngôn ngữ | Vùng |
|---|---|
| Tiếng Anh | Argentina, Bolivia, Brazil, Chile, Colombia, Costa Rica, Cộng hoà Dominica, Ecuador, Guatemala, Ấn Độ, Nhật Bản, Mexico, Paraguay, Peru, Vương quốc Anh, Hoa Kỳ, Uruguay, Venezuela |
| Tiếng Nhật | Nhật Bản |
| Tiếng Bồ Đào Nha | Brazil |
| Tiếng Tây Ban Nha | Argentina, Bolivia, Chile, Colombia, Costa Rica, Cộng hoà Dominica, Ecuador, Guatemala, Mexico, Paraguay, Peru, Hoa Kỳ, Uruguay, Venezuela |
Yêu cầu bản tóm tắt bài đánh giá
Để yêu cầu bản tóm tắt bài đánh giá, hãy đưa reviewSummary vào mặt nạ trường của yêu cầu:
- Chi tiết địa điểm (Mới):
reviewSummary - Tìm kiếm văn bản (Mới) và Nearby Search (Mới):
places.reviewSummary
Thông tin phân bổ cho bản tóm tắt bài đánh giá phải bao gồm đườ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 đưa
reviewSummary.reviewsUri
vào mặt nạ trường của yêu cầu.
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ờ cho nội dung không phù hợp để Google xoá.disclosureText: Chuỗi văn bản đã bản địa hoá có văn bản tiết lộ "Tóm tắt bằng Gemini" phải được đưa vào thông tin phân bổ.
Yêu cầu Chi tiết địa điểm (Mới)
Ví dụ sau đây yêu cầu bản tóm tắt bài đánh giá về 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 văn bản (Mới)
Ví dụ sau đây yêu cầu bản tóm tắt bài đánh giá về 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 tìm 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 do AI tạo được hiển thị trong ứng dụng của bạn phải đi kèm với thông tin phân bổ 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.