Bản tóm tắt về địa điểm do AI tạo

Thông tin tóm tắt về địa điểm do AI tạo là thông tin tổng quan ngắn gọn, dài 100 ký tự, dành riêng cho một mã địa điểm nhất định. Bản tóm tắt địa điểm tổng hợp nhiều loại dữ liệu khác nhau thành một thông tin tổng quan cấp cao để giúp người dùng nắm được thông tin tổng quan về một địa điểm.

Ví dụ: thông tin tóm tắt về địa điểm có thể làm nổi bật các món ăn, dịch vụ hoặc hàng hoá phổ biến có thể mua tại một địa điểm:

  • "Nhà hàng trong trung tâm mua sắm Forum Shops, phục vụ các món ăn truyền thống của Ý với khẩu phần lớn trong không gian bình dân."
  • "Salon sành điệu cung cấp dịch vụ cắt tóc, nhuộm tóc và sấy tóc."
  • "Cửa hàng lớn có nhiều nhà cung cấp bán nhiều loại đồ trang trí, đồ nội thất và quần áo cổ điển."

Thông tin tóm tắt về địa điểm được hỗ trợ bởi Place Details (Mới), Tìm kiếm văn bản (Mới), và Nearby Search (Mới). Thông tin tóm tắt về địa điểm được cung cấp cho các loại địa điểm xuất hiện trong phần Loại địa điểm được hỗ trợ cho các danh mục Văn hoá, Giải trí và giải trí, Đồ ăn và đồ uống, Mua sắm, Dịch vụ và Thể thao.

Thông tin tóm tắt về địa điểm được hỗ trợ cho các địa điểm yêu thích bằng những ngôn ngữ và khu vực sau:

Ngôn ngữ Khu vực
Tiếng Anh

Úc

Canada

Ấn Độ

New Zealand

Singapore

Hoa Kỳ

Yêu cầu bản tóm tắt về địa điểm do AI tạo

Để trả về thông tin tóm tắt về địa điểm trong phản hồi, hãy thêm trường sau vào mặt nạ trường của yêu cầu:

  • Chi tiết địa điểm (Mới): generativeSummary
  • Tìm kiếm văn bản (Mới) và Nearby Search (Mới): places.generativeSummary

Trường generativeSummary chứa các trường sau:

  • generativeSummary: Thông tin tóm tắt về địa điểm.
  • overviewFlagContentUri: Đường liên kết để người dùng có thể gắn cờ báo cáo vấn đề về thông tin tóm tắt về địa điểm.
  • disclosureText: Một chuỗi văn bản được bản địa hoá có văn bản công bố "Được tóm tắt bằng Gemini" phải được đưa vào thông tin ghi nhận tác giả.

Yêu cầu về Chi tiết địa điểm (Mới)

Yêu cầu Place Details (Mới) sau đây sẽ trả về một bản tóm tắt overview cho một nhà hàng sushi ở Chicago, Illinois:

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

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

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Yêu cầu Tìm kiếm văn bản (Mới)

Yêu cầu Tìm kiếm văn bản (Mới) sau đây trả về một bản tóm tắt overview cho các nhà hàng chay cay ở Mountain View, CA:

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'

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

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Yêu cầu Nearby Search (Mới)

Yêu cầu Nearby Search (Mới) sau đây sẽ trả về một bản tóm tắt overview cho các nhà hàng và quán cà phê ở Portland, OR:

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

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

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

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 tác giả phù 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 cho Places API.