Trang này được dịch bởi Cloud Translation API.

Bản tóm tắt bài đánh giá dựa trên AI

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ụ: nội dung 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).

Thử bản minh hoạ tóm tắt bằng AI

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 googleMapsLinks.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,googleMapsLinks.reviewsUri"

Phản hồi có dạng:

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "googleMapsLinks": {
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1",
  },
  "reviewSummary": {
    "text": {
      "text": "Diners say this lunch restaurant serves up delicious dumplings, including pork and chive, soup dumplings, and fried dumplings, alongside other Chinese dishes like fried rice, pork belly buns, and general tso's chicken. They also highlight the generous portions, reasonable prices, and efficient service.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWc%7CCAIQACorChtyc19oOkE4blltMzB1eXpWblVKUjFBQXFGbWcSDAis0fW-BhCIp7blAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

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,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchText'

Nội dung phản hồi có dạng:

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves delicious oat milk lattes, iced lattes, and cappuccinos, and they praise the friendly staff and cozy atmosphere. They also highlight the great outdoor seating area and the unique latte flavors.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkE%7CCAIQACorChtyc19oOkFONEpuYU1UMzZWbTduX1lBQVRBRkESDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJl5qG27RZwokRzoy63vyI4Gk",
      "googleMapsLinks": {
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259b4db869a97:0x69e088fcdeba8cce!9m1!1b1",
      },
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves delicious matcha, including the Blueberry Matcha Latte and Cherry Cold Brew Latte, and offers a variety of pastries. They also highlight the friendly and efficient staff, and the cute and aesthetic space.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXc%7CCAIQACorChtyc19oOkE4bmRodTgya2MxbkJNMXhBQU1MNXcSDAj9iuK_BhD4ouCwAw&d=17924085&t=8",
        "disclaimerText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

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,places.googleMapsLinks.reviewsUri" \
'https://places.googleapis.com/v1/places:searchNearby'