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

Các chức năng của mô hình Gemini cho Places API

Các chức năng của mô hình Gemini cho Places API (Mới) hỗ trợ các LLM (mô hình ngôn ngữ lớn) Places API để bạn có thể trả về dữ liệu được liên kết với một địa điểm (giờ mở cửa, bài đánh giá, ảnh) cùng với dữ liệu do các LLM cung cấp. Chiến dịch này dữ liệu tạo sinh chứa dữ liệu tổng hợp và tóm tắt từ các mô hình ngôn ngữ lớn (LLM) để nâng cao dữ liệu đã được liên kết với một địa điểm.

Ví dụ: một tiêu chuẩn Tìm kiếm văn bản (Mới) cho "trạm sạc xe điện" sẽ trả về danh sách các địa điểm có cung cấp trạm sạc xe điện. Chiến dịch này loại phản hồi này cũng được nếu bạn chỉ đang tìm trạm sạc xe điện gần nhất hoặc thiết bị gần nhất tương thích với xe của bạn.

Nhưng có thể bạn cũng muốn hiểu rõ hơn về khu vực xung quanh trạm sạc, đặc biệt nếu bạn sẽ ở đó từ một giờ trở lên khi xe sạc. Khi sử dụng các chức năng của mô hình Gemini để làm việc đó cùng một nội dung tìm kiếm, thì câu trả lời có thể chứa nội dung mô tả linh động tạo sinh của từng cụm từ địa điểm trong câu trả lời, bao gồm cả thông tin về khu vực xung quanh trạm sạc trạm sạc:

"Trong vòng 2-4 phút đi bộ, có nhiều nhà hàng và khu mua sắm các lựa chọn, bao gồm Chef Chu's, Nhà nướng thịt kiểu Hàn Quốc, Amber India, Pacific Ghé thăm một số cửa hàng tạp hoá như Walmart, Whole Foods Market và Trader Joe's."
"Trong vòng 1-5 phút đi bộ, có nhiều nhà hàng và khu mua sắm các lựa chọn, bao gồm Khao Kang Thai Kitchen, Thao's Deli và Bánh vòng và La Trang phục. Đối với sushi, Joy Sushi là một lựa chọn tốt. Đối với cửa hàng tạp hoá, nhà hàng USD Tree cung cấp nhiều sản phẩm với giá chiết khấu."

Nội dung tạo sinh này của các LLM cải thiện câu trả lời và cung cấp thông tin bổ sung để giúp người dùng đưa ra quyết định sáng suốt.

Các tính năng mới dựa trên AI đã được thêm vào Places API (Mới)

Các chức năng này thêm dữ liệu sau đây vào phản hồi của Places API (Mới):

Bản tóm tắt về địa điểm tạo sinh liên quan đến một nội dung cụ thể place. Phần tóm tắt về địa điểm được hỗ trợ bởi Thông tin chi tiết về địa điểm (Mới), Tìm kiếm văn bản (Mới), và Tìm kiếm lân cận (Mới).
Bản tóm tắt về khu vực tạo sinh liên quan đến một khu vực cụ thể xung quanh một địa điểm. Các nền tảng hỗ trợ tính năng tóm tắt khu vực Thông tin chi tiết về địa điểm (Mới), Tìm kiếm văn bản (Mới), và Tìm kiếm lân cận (Mới).
Kết quả tìm kiếm theo ngữ cảnh được hỗ trợ bởi Tìm kiếm văn bản (Mới) và chứa dữ liệu dựa trên chuỗi tìm kiếm được chuyển trong yêu cầu, thay vì dữ liệu được liên kết trực tiếp với một địa điểm. Dữ liệu này giúp nắm được Tìm kiếm văn bản (Mới) xác định câu trả lời.

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

Bản tóm tắt địa điểm tạo sinh là nội dung dành riêng cho một mã địa điểm. Tóm tắt về địa điểm tổng hợp nhiều loại dữ liệu khác nhau vào một bản tóm tắt duy nhất cho địa điểm.

Places API (Mới) cung cấp 2 loại nội dung tóm tắt về địa điểm do AI tạo:

Tóm tắt tổng quan: Thông tin tổng quan ngắn gọn về một địa điểm, trung bình vào khoảng 100 ký tự, có thể giúp người dùng có được thông tin tổng quan nhanh về một địa điểm.
Tóm tắt mô tả: Tóm tắt dài hơn về một địa điểm, tính trung bình khoảng 400 ký tự, cung cấp thông tin tổng quan chi tiết bao gồm phần trên cùng khía cạnh của địa điểm.

Tóm tắt địa điểm hiện có sẵn cho các loại địa điểm được hiển thị trong Được hỗ trợ loại cho các danh mục Văn hoá, Hoạt động vui chơi và giải trí, Ẩm thực, Mua sắm, và Thể thao.

Bản tóm tắt về khu vực tạo sinh

Bản tóm tắt khu vực tạo sinh do LLM tạo cho khu vực lân cận xung quanh một địa điểm. Tóm tắt khu vực cho một địa điểm có thể chứa tất cả thông tin cần thiết để người dùng đưa ra quyết định mà không cần phải đưa ra yêu cầu khác để xem chi tiết thông tin khu vực.

Cùng với nội dung mô tả về khu vực, câu trả lời cũng chứa danh sách mã địa điểm của các địa điểm được nhắc đến trong phần mô tả và danh sách các địa điểm được sắp xếp theo loại nội dung khác nhau. Ví dụ: mỗi loại nội dung chứa một danh sách địa điểm liên quan đến các hoạt động trong khu vực và một địa điểm khác có chứa danh sách nhà hàng trong khu vực.

Hiện có bản tóm tắt về khu vực cho các loại địa điểm được hiển thị ở Các loại được hỗ trợ cho danh mục Nhà nghỉ, cũng như các loại địa điểm cụ thể electric_vehicle_charging_station, geocode và premise.

Tạo bản tóm tắt về địa điểm và khu vực

Cả bản tóm tắt về địa điểm do AI tạo và bản tóm tắt về khu vực tạo sinh đều là được Google tạo ngoại tuyến một cách thường xuyên. Khi bạn tạo các bản tóm tắt này ngoại tuyến, bạn có thể khai thác nội dung do Gemini cung cấp mà vẫn nhìn thấy hiệu suất tương tự từ Places API (Mới) mà bạn đã mong đợi.

Google thường xuyên tạo lại những bản tóm tắt này để đảm bảo rằng chúng luôn mới dựa trên thông tin mới nhất hiện có. Điều đó có nghĩa là bạn sẽ hiển thị dữ liệu mới nhất trong dịch vụ khi bạn gọi API.

Kết quả tìm kiếm theo ngữ cảnh

Tìm kiếm văn bản (Mới) trả về thông tin về một nhóm địa điểm dựa trên một chuỗi — ví dụ "pizza ở New York" hoặc "cửa hàng giày gần Ottawa". Tìm kiếm văn bản Câu trả lời (Mới) có chứa danh sách các địa điểm khớp với chuỗi văn bản và bất kỳ thiên vị vị trí được đặt trong yêu cầu.

Khi bạn thêm kết quả tìm kiếm theo ngữ cảnh vào câu trả lời, câu trả lời sẽ ngay bao gồm các bài đánh giá, hình ảnh và lý do giúp người dùng trả lời câu hỏi:

Tại sao tôi thấy địa điểm này trong kết quả?
Tại sao tôi nên chọn địa điểm này?

Ví dụ: bạn đưa ra yêu cầu về Chi tiết địa điểm (Mới), Tìm kiếm văn bản (Mới) hoặc Tính năng Tìm kiếm lân cận (Mới) hôm nay đưa ra một địa điểm cụ thể trong câu trả lời. Chiến lược phát hành đĩa đơn dữ liệu phản hồi cho địa điểm đó là giống nhau cho cả ba yêu cầu vì dữ liệu trả về được liên kết với địa điểm đó.

Tuy nhiên, đối với tính năng Tìm kiếm văn bản (Mới) sử dụng các tính năng mới, câu trả lời có thể bao gồm dữ liệu bắt nguồn từ chính chuỗi truy vấn đầu vào. Điều đó có nghĩa là kết quả tìm kiếm theo ngữ cảnh là duy nhất đối với chuỗi truy vấn. Ví dụ: bạn thực hiện yêu cầu Tìm kiếm văn bản (Mới) với chuỗi truy vấn sau:

"Nhà hàng chay cay ở Mountain View, CA"

Sau đó, bạn giữ nguyên mọi tham số đầu vào và chỉ thay đổi chuỗi truy vấn thành:

"Nhà hàng ăn chay ngon miệng ở Mountain View, CA"

Đối với một nhà hàng xuất hiện trong cả hai câu trả lời, dữ liệu phản hồi về địa điểm giống nhau bởi vì dữ liệu đó được liên kết với chính địa điểm đó. Tuy nhiên, các kết quả tìm kiếm theo ngữ cảnh là duy nhất cho truy vấn vì chúng bắt nguồn từ chuỗi truy vấn. Sau đó, bạn có thể hiển thị bài đánh giá, ảnh và giải thích từ các kết quả tìm kiếm theo ngữ cảnh cho người dùng của bạn để giúp họ quyết định vị trí trong câu trả lời phù hợp nhất với yêu cầu tìm kiếm của họ.

Bật các chức năng của mô hình Gemini cho Places API (Mới)

Bạn phải bật Places API (Mới) để sử dụng các tính năng của mô hình Gemini dành cho Places API (Mới). Để biết thêm thông tin, hãy xem Thiết lập dự án trên Google Cloud.

Hạn chế đối với bản phát hành thử nghiệm

Bản phát hành này chỉ hỗ trợ thông tin tóm tắt về địa điểm và khu vực cho các địa điểm tại Hoa Kỳ Tiểu bang chỉ có bằng tiếng Anh.

Gemini là gì?

Để tìm hiểu về mô hình Gemini, hãy xem bài viết Gemini Câu hỏi thường gặp.

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

Bản tóm tắt về địa điểm là bản tóm tắt tạo sinh do LLM tạo cho một nội dung cụ thể địa điểm. Places API (Mới) thêm hai loại nội dung tóm tắt vào phản hồi:

Tổng quan Bản tóm tắt tạo sinh tương tự với nội dung biên tập tĩnh tóm tắt liên quan đến một địa điểm. Trung bình, nội dung tóm tắt ngắn do AI tạo khoảng 100 ký tự, nhưng có một số ưu điểm:
- Nhiều địa điểm không có thông tin tóm tắt của biên tập viên nên sẽ có đủ thông tin cho một địa điểm.
- Các mô hình này được tạo từ LLM (mô hình ngôn ngữ lớn) nên không cần chủ sở hữu địa điểm để duy trì chúng.
Nội dung mô tả Bản tóm tắt tạo sinh được lấy từ nhiều nguồn, bao gồm cả bài đánh giá trên Google Maps. Phần mô tả, trung bình khoảng 400 bao gồm danh sách các bài đánh giá dùng để tạo mô tả.

Để tự mình tạo bản tóm tắt nội dung mô tả, bạn cần phải có người tổng hợp dữ liệu từ nhiều địa điểm rồi thủ công và duy trì nội dung. Các chức năng của mô hình Gemini dành cho Places API (Mới) tạo những bản tóm tắt này từ các LLM (mô hình ngôn ngữ lớn) nhằm duy trì phạm vi và độ mới của nội dung được tạo.

Phần tóm tắt về địa điểm được hỗ trợ bởi Thông tin chi tiết về địa điểm (Mới), Tìm kiếm văn bản (Mới), và Tìm kiếm lân cận (Mới). Để đưa thông tin tóm tắt về địa điểm vào câu trả lờ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: generativeSummary
Tìm kiếm văn bản và Tìm kiếm lân cận: places.generativeSummary

Chiến lược phát hành đĩa đơn generativeSummary chứa các trường sau:

generativeSummary.overview: Bản tóm tắt tổng quan về AI tạo sinh.
generativeSummary.description: Bản tóm tắt nội dung mô tả do AI tạo.
generativeSummary.references: Một mảng gồm tối đa 5 bài đánh giá từng cung cấp nội dung cho phần tóm tắt mô tả. Nếu không có nội dung mô tả thì mảng này trống.

Ví dụ về yêu cầu tóm tắt thông tin tổng quan

Ví dụ này, tính năng Tìm kiếm văn bản chỉ trả về nội dung tóm tắt overview về nội dung cay nhà hàng chay ở 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.overview" \
https://places.googleapis.com/v1/places:searchText

Phản hồi chứa trường generativeSummary.overview bao gồm overview.text và overview.languageCode:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

Ví dụ về yêu cầu nội dung tóm tắt nội dung và thông tin tổng quan

Ví dụ này tạo cùng một truy vấn như trong ví dụ trước nhưng sử dụng một mặt nạ trường của places.generativeSummary để trả về toàn bộ Đối tượng generativeSummary, bao gồm cả generativeSummary.overview, Các trường generativeSummary.description và generativeSummary.references:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Anam Qureshi",
                "uri": "https://www.google.com/maps/contrib/116859422317024657778/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1dl9FTSmec0x00000000-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
            },
            . . .
          ]
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

Yêu cầu bản tóm tắt về khu vực tạo sinh

Bản tóm tắt về khu vực là bản tóm tắt tạo sinh do LLM tạo cho khu vực lân cận của một địa điểm. Bản tóm tắt khu vực có thể đóng vai trò quan trọng đối với việc người dùng đưa ra quyết định về địa điểm.

Ví dụ: bạn đang muốn đặt phòng khách sạn ở một thành phố mới và trong khi bạn có thể tìm một khách sạn đáp ứng yêu cầu của mình, bạn cũng muốn tìm hiểu thêm về khu vực xung quanh khách sạn. Thay vì xem bản đồ xung quanh sau đó phải điều tra từng địa điểm trên bản đồ, thay vào đó, bạn có thể tạo bản tóm tắt về khu vực của khách sạn.

Các nền tảng hỗ trợ tính năng tóm tắt khu vực Thông tin chi tiết về địa điểm (Mới), Tìm kiếm văn bản (Mới), và Tìm kiếm lân cận (Mới).

Để đưa phần tóm tắt khu vực vào câu trả lời, hãy thêm vào mặt nạ trường của yêu cầu:

areaSummary (Chi tiết địa điểm)
places.areaSummary (Tìm kiếm văn bản và Tìm kiếm lân cận).

Chiến lược phát hành đĩa đơn areaSummary trường cho vị trí trong câu trả lời chứa một mảng tối đa bốn contentBlocks. Chủ đề của mỗi khối dựa trên loại địa điểm:

Đối với trạm sạc xe điện, được xác định là một loại địa điểm electric_vehicle_charging_station, các khối chủ đề bao gồm: "overview", "coffee", "restaurant" và "store".
Đối với một địa điểm thuộc loại được xác định bởi Nơi lưu trú danh mục và các loại địa điểm cụ thể geocode và premise, chủ đề các khối bao gồm: "overview", "activity", "restaurant" và "store".

Ví dụ về yêu cầu cho thông tin tóm tắt về khu vực của một trạm sạc xe điện

Ví dụ về yêu cầu Chi tiết địa điểm này trả về thông tin tóm tắt về khu vực của một xe điện cụ thể trạm sạc ở Mountain View, được xác định theo mã địa điểm ChIJC5b6QKiwj4ARgn2EwlnJnWU:

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

Phản hồi chứa trường areaSummary, bao gồm cả contentBlocks mảng:

Trường topic chỉ định loại khối nội dung. Bởi vì địa điểm ở Trong ví dụ này là một trạm sạc xe điện, bốn khối nội dung là "overview", "coffee", "restaurant" và "store".
Trường content bao gồm thông tin tóm tắt cho chủ đề đó, bao gồm cả mã ngôn ngữ.
Mảng references chỉ định tên tài nguyên địa điểm, trong biểu mẫu places/PLACE_ID, dùng để cung cấp nội dung cho khối nội dung.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ]
  }
}

Yêu cầu mẫu về tóm tắt khu vực của một khách sạn

Ví dụ về yêu cầu Tìm kiếm văn bản dưới đây yêu cầu các khách sạn ở Mountain View, CA:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "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.areaSummary" \
https://places.googleapis.com/v1/places:searchText

Phản hồi chứa trường areaSummary, bao gồm cả contentBlocks . Phản hồi cho địa điểm thuộc loại khách sạn có chứa khối nội dung cho thuộc tính chủ đề "overview", "activity", "restaurant" và "store":

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ]
      }
    },
    ...
  ]
}

Yêu cầu kết quả tìm kiếm theo ngữ cảnh

Phản hồi cho Tìm kiếm văn bản (Mới) yêu cầu chứa một mảng các địa điểm phù hợp với tiêu chí của nội dung tìm kiếm đầu vào . Giờ đây, bạn có thể yêu cầu dữ liệu tìm kiếm theo ngữ cảnh trong phản hồi dựa trên truy vấn đầu vào cho API.

Để hỗ trợ nội dung tóm tắt theo ngữ cảnh, phản hồi từ Tìm kiếm văn bản (Mới) chứa một mảng mới có tên contextualContents ở cùng cấp với Mảng places trong phản hồi:

{
  "places": [],
  "contextualContents":[]
}

Mỗi phần tử trong mảng contextualContents, thuộc loại ContextualContent, là vị trí mảng tương ứng với vị trí trong mảng places. Đó tức là phần tử tại contextualContents[0] tương ứng với địa điểm tại places[0].

Mỗi phần tử mảng chứa các trường mảng sau:

contextualContents.reviews: Một mảng gồm tối đa 3 bài đánh giá.
contextualContents.photos: Một mảng gồm tối đa năm ảnh.
contextualContents.justifications: Một mảng giải thích cho địa điểm, bao gồm:
- reviewJustification: Làm nổi bật của bài đánh giá của người dùng mà người dùng cuối có thể quan tâm.
- businessAvailabilityAttributesJustification: Bao gồm các thuộc tính của một doanh nghiệp có thể được quan tâm người dùng.

Để đưa kết quả tìm kiếm theo ngữ cảnh vào câu trả lời, hãy thêm contextualContents trong mặt nạ trường của yêu cầu Tìm kiếm văn bản (Mới):

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

Phản hồi chứa mảng contextualContents cho mỗi địa điểm trong trả lời:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Guillaume Riesen",
            "uri": "https://www.google.com/maps/contrib/1131462893/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwG_WXt1SjB1rJg=s128-c-c0x00000000-cc-rp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSUNKZzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Paul Sacks",
            "uri": "https://www.google.com/maps/contrib/1106671734435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9sVQ=s128-c-c0x00000000-cc-rp-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113209927655010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgycOLDgOqPRYhzJ0EJlBFyKo9OrmacOo3C5YvrtR4Q=s100-p-k-no-mo"
            }
          ]
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9YNzyjkjDMD15gyobIQtIYg1GFPy3BdQHAaA3iNwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ]
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Harpal Kochar",
                "uri": "https://www.google.com/maps/contrib/1166232959/reviews",
                "photoUri": "https://lh3.googleusercoEnzB1zdrNbR00000-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Hướng dẫn triển khai cho các trường hợp sử dụng trên ô tô

Để đảm bảo an toàn cho người lái xe, bạn nên hiển thị bản tóm tắt của AI tạo sinh theo chế độ đỗ xe dành cho trải nghiệm trên ô tô. Nếu hiển thị bản tóm tắt ở chế độ lái xe, thông tin trên màn hình phải đơn giản, rõ ràng và súc tích để đảm bảo rằng sự chú ý của người lái xe sẽ nhanh chóng trở lại đường đi.

Không quá 3 dòng
Tối đa 120 ký tự hoặc 24 từ
Kích thước mặt trước tối thiểu là 24 dp

Đặc biệt là trong bối cảnh ô tô, nhà phát triển có trách nhiệm hiển thị bản tóm tắt do AI tạo theo cách an toàn và tuân thủ luật và quy định của địa phương.

Phân bổ

Khi bạn hiện bài đánh giá, ảnh và bản tóm tắt do AI tạo sinh trong ứng dụng của mình, bao gồm cả tóm tắt về địa điểm và khu vực, bạn phải đảm bảo rằng bạn cũng hiển thị các thuộc tính bắt buộc.

Hiện thông tin ghi nhận sự đóng góp cho bản tóm tắt tạo sinh

Khi bạn hiện bản tóm tắt do AI tạo trong ứng dụng, bao gồm cả địa điểm và khu vực tóm tắt, bạn cũng phải hiển thị các thuộc tính cần thiết. Phần này mô tả cách hiện thông tin ghi nhận sự đóng góp dựa trên cách bạn trình bày thông tin AI tạo sinh trong ứng dụng của bạn.

Trong mọi trường hợp, hoạt động phân bổ phải sử dụng cách viết hoa đầu câu. Mô hình phân bổ và Biểu trưng của Google phải tuân theo tất cả các tiêu chuẩn về màu sắc, kiểu và kiểu chữ. Để biết thêm thông tin về các tiêu chuẩn này, xem Chính sách dành cho Places API (Mới).

Bản tóm tắt về AI tạo sinh xuất hiện trong bối cảnh của các dữ liệu khác trên Google

Trong trường hợp này, mô hình phân bổ AI tạo sinh có thể hiển thị một mình phía trên hoặc bên dưới bản tóm tắt, dựa vào thông tin ghi nhận tác giả của Google đối với nội dung đó ở những phần khác.

Đối với thông tin ghi nhận sự đóng góp, hãy sử dụng văn bản "Do AI tóm tắt" như trong hình sau:

Để ghi công, hãy sử dụng văn bản do AI tóm tắt.

Bản tóm tắt về AI tạo sinh được hiển thị riêng biệt

Khi một bản tóm tắt về AI tạo sinh xuất hiện tách biệt với mọi nội dung khác Google Maps, thì dữ liệu này phải bao gồm cả mô hình phân bổ và ghi nhận tác giả dựa trên AI tạo sinh cho Google được phân tách bằng dấu chấm giữa. Đối với thông tin ghi nhận sự đóng góp, hãy sử dụng văn bản "Tóm tắt của AI" và biểu trưng của Google như trong hình sau:

Đối với thông tin tóm tắt được trình bày riêng biệt, hãy cung cấp thông tin phân bổ giá trị đóng góp của AI tạo sinh và
Mô hình phân bổ của Google được phân tách bằng dấu chấm giữa.

Bản tóm tắt về AI tạo sinh lặp lại trong một danh sách

Khi nhắc lại thông tin dựa trên AI tạo sinh tổng quan về tóm tắt địa điểm trong một danh sách các địa điểm, trong đó tất cả:

Nội dung danh sách được ghi nhận cho Google
Bản tóm tắt bạn thấy là nội dung do AI tạo
Nội dung có trên Google

Thuộc tính phải hiển thị phía trên hoặc phía dưới danh sách trên một dòng. Mô hình phân bổ AI được căn trái và mô hình phân bổ của Google là căn phải:

Đối với danh sách, hãy hiển thị thuộc tính ở phía trên hoặc phía dưới danh sách trên một dòng.

Nếu AI tạo sinh dạng dài hơn, hãy tóm tắt nội dung mô tả được dùng trong danh sách, mỗi bản tóm tắt phải có AI (trí tuệ nhân tạo) phân bổ giá trị đóng góp ("Do AI tóm tắt" bằng biểu tượng/nút thông tin).

Hiện thông tin về bản tóm tắt về AI tạo sinh trong một hộp thoại

Cùng với bản tóm tắt về AI tạo sinh, bạn phải cung cấp một hộp thoại để kết thúc người dùng hiển thị thông tin về bản tóm tắt và một đường liên kết để báo cáo sự cố. Khi sử dụng AI tạo sinh tóm tắt mô tả, bạn phải bao gồm thông tin về các nguồn của bản tóm tắt, được gọi là tệp đối chiếu.

Cho phép truy cập vào hộp thoại này bằng cách thêm biểu tượng thông tin (ở dạng tương tác tương tác) cùng với mô hình phân bổ AI (như mô tả ở trên và làm cho vùng thuộc tính cũng như biểu tượng AI phản hồi nhấn/nhấp.

Để tạo bản tóm tắt về địa điểm do AI tạo, hãy hiển thị:

Giới thiệu	Bản tóm tắt địa điểm do AI tạo được tạo từ các bài đánh giá trên Google và .
Báo cáo sự cố	Để báo cáo vấn đề cho Google về nội dung của bản tóm tắt, truy cập vào đường liên kết này.
Tài liệu tham khảo	Bài đánh giá nguồn

Ví dụ:

Hiện thông tin về bản tóm tắt AI tạo sinh trong một hộp thoại.

Để xem bản tóm tắt khu vực tạo sinh, hãy cho thấy:

Giới thiệu	Bản tóm tắt khu vực bằng AI được tạo từ các bài đánh giá trên Google và dữ liệu địa phương.
Báo cáo sự cố	Để báo cáo vấn đề cho Google về nội dung của bản tóm tắt, truy cập vào đường liên kết này.

Thuộc tính tóm tắt khu vực hiển thị.