Bản tóm tắt về khu vực dựa trên AI

Bản tóm tắt khu vực dựa trên AI được tạo cho khu vực xung quanh một địa điểm. Thông tin tóm tắt về khu vực cung cấp thêm bối cảnh cho một vị trí, bao gồm cả các địa điểm tham quan ở gần đó, để người dùng có thể đưa ra quyết định sáng suốt hơn về nơi đến và việc cần làm khi đến đó.

Ví dụ: khi ghé thăm một thành phố mới, bạn có thể xem bản tóm tắt khu vực lân cận được tạo cho một khách sạn để tìm hiểu thêm về khu vực xung quanh:

  • "Khu vực sôi động này ở San Francisco, nơi giao thoa giữa North Beach và Khu phố người Hoa, nằm ở phía tây bắc của Khu tài chính, có các địa điểm văn học nổi tiếng, điểm tham quan văn hoá độc đáo và ẩm thực đa dạng. Một số địa điểm nổi bật có thể kể đến như hiệu sách City Lights nổi tiếng, Bảo tàng Cáp treo thú vị và những con phố nhộn nhịp của Khu phố Tàu.

    Khu vực này có sự kết hợp độc đáo giữa lịch sử và văn hoá, nơi có môi trường thân thiện với người đi bộ, mời gọi khám phá mặc dù có một số ngọn đồi và đám đông. Đắm mình trong lịch sử văn học tại hiệu sách City Lights, trải nghiệm nền văn hoá sôi động của khu phố người Hoa với các đền thờ và nhà máy bánh quy may mắn, hoặc quay ngược thời gian tại Bảo tàng cáp treo. Nơi đây có nhiều lựa chọn ẩm thực, từ ẩm thực Trung Hoa chính hiệu đến pizza thơm ngon."

Nếu đang cân nhắc việc sạc xe điện, bạn có thể xem thông tin tóm tắt được tạo cho một trạm sạc xe điện để tìm các quán cà phê hoặc nhà hàng gần đó để ghé thăm trong lúc chờ đợi:

  • "Khu vực này có nhiều lựa chọn ăn uống trong vòng 9 phút đi bộ, bao gồm Starbucks, Sushi Jin và Safeway."

Ngoài nội dung mô tả về khu vực, phản hồi cũng chứa danh sách mã địa điểm cho những địa điểm được đề cập trong nội dung mô tả.

Places API (Mới) cung cấp 2 loại bản tóm tắt khu vực dựa trên AI:

  • Tóm tắt về khu vực lân cận, cung cấp thông tin tổng quan cấp cao về các điểm thu hút gần đó cho những địa điểm có loại premise, street_address và tất cả các loại trong danh mục Nhà ở và Chỗ ở.
  • Thông tin tóm tắt về tiện nghi của trạm sạc xe điện (EVCS), cung cấp thông tin tổng quan ở cấp cao về các điểm thu hút gần đó cho những địa điểm có loại electric_vehicle_charging_station.

Thông tin tóm tắt về khu vực dựa trên AI đượ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).

Yêu cầu cung cấp thông tin tóm tắt về khu vực lân cận

Bạn có thể tạo bản tóm tắt khu dân cư cho những địa điểm thuộc danh mục Nhà ở và Nơi lưu trú. Để trả về bản tóm tắt về khu vực lân cận trong phản hồi, hãy thêm nội dung sau 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): neighborhoodSummary
  • Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới): places.neighborhoodSummary

Trường neighborhoodSummary cho một địa điểm trong phản hồi chứa những thông tin sau:

  • Hai trường phụ: overview và description. Trường phụ overview bao gồm các địa điểm yêu thích ở gần, cụ thể cho địa điểm đó, trong khi trường phụ description cung cấp thông tin chung hơn về khu vực xung quanh. Mỗi trường phụ đều có một danh sách tên tài nguyên được tham chiếu ở dạng place/PLACE_ID.
  • flagContentUri Đường liên kết mà người dùng có thể gắn cờ vấn đề về bản tóm tắt được tạo.
  • 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.

Ví dụ sau đây yêu cầu cung cấp thông tin tóm tắt về khu vực lân cận cho một khách sạn ở Thành phố New York:

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

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

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Yêu cầu cung cấp thông tin tóm tắt về tiện nghi EVCS

Bạn có thể tạo thông tin tóm tắt về tiện nghi của trạm sạc xe điện (EVCS) cho những địa điểm có loại electric_vehicle_charging_station. Để đưa thông tin tóm tắt về tiện nghi EVCS vào phản hồi, hãy thêm thông tin sau 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): evChargeAmenitySummary
  • Tìm kiếm bằng văn bản (Mới) và Tìm kiếm lân cận (Mới): places.evChargeAmenitySummary

Trường evChargeAmenitySummary cho một địa điểm trong phản hồi chứa những thông tin sau:

  • Bốn trường con: overview, coffee, restaurant và store. Mỗi trường phụ đều có nội dung mô tả ngắn về các địa điểm yêu thích ở gần và danh sách tên tài nguyên được tham chiếu ở dạng place/PLACE_ID.
  • Đường liên kết flagContentUri để người dùng có thể gắn cờ vấn đề về bản tóm tắt được tạo.
  • 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.

Ví dụ sau đây yêu cầu thông tin tóm tắt về tiện nghi của trạm sạc xe điện cho một trạm sạc ở Mountain View:

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

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

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "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 quyề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 đối với Places API.