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

Các tính năng của mô hình Gemini cho API Địa điểm (Mới) hỗ trợ các LLM cho API Địa điểm để bạn có thể trả về dữ liệu 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 LLM cung cấp. Dữ liệu tạo sinh này chứa dữ liệu tổng hợp và tóm tắt từ các LLM để nâng cao dữ liệu đã liên kết với một địa điểm.

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

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

  • "Cách đó 2-4 phút đi bộ là một số địa điểm ăn uống và mua sắm, bao gồm Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch và một số cửa hàng tạp hoá như Walmart, Whole Foods Market và Trader Joe's."

  • "Cách đó từ 1 đến 5 phút đi bộ, bạn có thể tìm thấy một số địa điểm ăn uống và mua sắm, bao gồm Khao Kang Thai Kitchen, Roger's Deli & Donuts và La Costeña. Nếu bạn muốn ăn sushi, Joy Sushi là một lựa chọn phù hợp. Đối với hàng tạp hoá, Dollar 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 từ LLM giúp nâng cao phản hồi và cung cấp thêm thông tin để giúp người dùng đưa ra quyết định sáng suốt.

Thêm các tính năng mới dựa trên AI vào API Địa điểm (Mới)

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

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

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

Places API (Mới) cung cấp hai loại bản tóm tắt về địa điểm tạo sinh:

  • 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 khoảng 100 ký tự, có thể giúp người dùng nắm được thông tin cơ bản về một địa điểm.

  • Tóm tắt nội dung mô tả: Tóm tắt dài hơn về một địa điểm, trung bình khoảng 400 ký tự, cung cấp thông tin tổng quan chi tiết về các khía cạnh hàng đầu của địa điểm đó.

Tóm tắt địa điểm hiện có cho các loại địa điểm được nêu trong phần Các loại được hỗ trợ cho các danh mục Văn hoá, Giải trí và thư giãn, Đồ ăn và đồ uống, Mua sắmThể thao.

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

LLM tạo bản tóm tắt khu vực tạo sinh cho khu vực lân cận xung quanh một địa điểm. Bản tóm tắt về khu vực của 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 người dùng phải đưa ra thêm yêu cầu để xem chi tiết về khu vực.

Cùng vớ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 của những địa điểm được tham chiếu trong nội dung mô tả và danh sách địa điểm được sắp xếp theo nhiều loại nội dung. Ví dụ: một loại nội dung chứa danh sách các địa điểm liên kết với các hoạt động trong khu vực và một loại nội dung khác chứa danh sách các nhà hàng trong khu vực.

Hiện tại, bạn có thể xem thông tin tóm tắt về khu vực cho các loại địa điểm xuất hiện trong phần Loại được hỗ trợ của danh mục Khách sạn, cũng như các loại địa điểm cụ thể electric_vehicle_charging_station, geocodepremise.

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

Cả bản tóm tắt địa điểm tạo sinh và bản tóm tắt khu vực tạo sinh đều thường xuyên được Google tạo ngoại tuyến. Bằng cách tạo các bản tóm tắt này khi không có mạng, bạn có thể tận dụng nội dung do Gemini cung cấp mà vẫn thấy hiệu suất như mong đợi từ API Địa điểm (Mới).

Google thường xuyên tạo lại các bản tóm tắt này để đảm bảo rằng chúng luôn mới nhất 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ụ của mình khi gọi API.

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

Tìm kiếm bằng 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, chẳng hạn như "pizza ở New York" hoặc "cửa hàng giày gần Ottawa". Phản hồi của tính năng Tìm kiếm bằng văn bản (Mới) chứa danh sách các địa điểm khớp với chuỗi văn bản và mọi độ lệch 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 nội dung phản hồi, nội dung phản hồi hiện sẽ bao gồm bài đánh giá, ảnh và nội dung giải thích giúp người dùng trả lời các 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ụ: hôm nay, bạn gửi một yêu cầu đến tính năng Thông tin chi tiết về địa điểm (Mới), Tìm kiếm bằng văn bản (Mới) hoặc Tìm kiếm địa điểm lân cận (Mới) và yêu cầu này có một địa điểm cụ thể trong nội dung phản hồi. Dữ liệu phản hồi cho địa điểm giống nhau đối với cả 3 yêu cầu vì dữ liệu được trả về được liên kết với địa điểm đó.

Tuy nhiên, đối với một Tìm kiếm bằng văn bản (Mới) sử dụng các chức năng mới, phản hồ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 bối cảnh là duy nhất cho chuỗi truy vấn. Ví dụ: bạn tạo một yêu cầu Tìm kiếm văn bản (Mới) bằng chuỗi truy vấn sau:

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

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

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

Đố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 đó sẽ giống nhau vì dữ liệu đó được liên kết với chính địa điểm đó. Tuy nhiên, kết quả tìm kiếm theo bối cảnh là duy nhất cho cụm từ tìm kiếm vì chúng được lấy từ chuỗi truy vấn. Sau đó, bạn có thể hiển thị bài đánh giá, hình ảnh và lý do từ kết quả tìm kiếm theo ngữ cảnh cho người dùng để giúp họ quyết định địa điểm nào trong nội dung phản hồi phù hợp nhất với yêu cầu tìm kiếm của họ.

Bật các tính năng của mô hình Gemini cho API Địa điểm (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 cho Places API (Mới). Để biết thêm thông tin, hãy xem bài viết Thiết lập dự án Google Cloud.

Các 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ợ bản tóm tắt về địa điểm và khu vực cho các địa điểm ở Hoa Kỳ bằng tiếng Anh.

Gemini là gì?

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

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

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

  • Thông tin tóm tắt Tổng quan được tạo sinh tương tự như thông tin tóm tắt biên tập tĩnh liên kết với một địa điểm. Tóm tắt ngắn tạo sinh, trung bình khoảng 100 ký tự, có một số ưu điểm:

    • Nhiều địa điểm không có bản tóm tắt nội dung biên tập, vì vậy, bản tóm tắt này sẽ bổ sung thông tin còn thiếu về một địa điểm.

    • Các địa điểm này được tạo từ LLM nên chủ sở hữu địa điểm không cần duy trì các địa điểm đó.

  • Nội dung tóm tắt tạo sinh của Nội dung mô tả đượ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 ký tự) bao gồm danh sách các bài đánh giá được dùng để tạo phần mô tả dài.

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

Thông tin chi tiết về địa điểm (Mới), Tìm kiếm bằng văn bản (Mới)Tìm kiếm địa điểm lân cận (Mới) hỗ trợ bản tóm tắt địa điểm. Để đưa bản tóm tắt địa điểm vào nội dung phản hồi, hãy thêm trường sau vào mặt nạ trường của yêu cầu:

  • Thông tin chi tiết về địa điểm: generativeSummary

  • Tìm kiếm bằng văn bản và Tìm kiếm lân cận: places.generativeSummary

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

  • generativeSummary.overview: Tóm tắt tổng quan về nội dung tạo sinh.
  • generativeSummary.description: Tóm tắt nội dung mô tả tạo sinh.
  • generativeSummary.references: Một mảng gồm tối đa 5 bài đánh giá dùng để cung cấp nội dung cho phần tóm tắt nội dung mô tả. Nếu không có bản tóm tắt nội dung mô tả, thì mảng này sẽ trống.
  • overviewFlagContentUri: Đường liên kết mà người dùng có thể gắn cờ một vấn đề có bản tóm tắt tổng quan.
  • descriptionFlagContentUri: Đường liên kết mà người dùng có thể gắn cờ vấn đề với phần tóm tắt nội dung mô tả.

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

Ví dụ này sử dụng mặt nạ trường places.generativeSummary để trả về toàn bộ đối tượng generativeSummary, bao gồm cả các trường generativeSummary.overview, generativeSummary.descriptiongenerativeSummary.references:

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": "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": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "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"
        },
        . . .
}

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

Ví dụ về Tìm kiếm bằng văn bản này chỉ trả về bản tóm tắt overview về các nhà hàng chay cay ở Mountain View, California:

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.textoverview.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"
        }
      }
    },
  . . .
}

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

Tóm tắt 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. Tóm tắt khu vực có thể đóng vai trò quan trọng đối với người dùng khi đưa ra quyết định về một địa điểm.

Ví dụ: bạn muốn đặt phòng khách sạn ở một thành phố mới và mặc dù có thể tìm thấy một khách sạn đáp ứng các yêu cầu của bạn, nhưng 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 đồ khu vực xung quanh rồi phải điều tra từng địa điểm trên bản đồ, bạn có thể tạo bản tóm tắt khu vực cho khách sạn.

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

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

  • areaSummary (Thông tin chi tiết về địa điểm)
  • places.areaSummary (Tìm kiếm bằng văn bản và Tìm kiếm lân cận).

Trường areaSummary cho một địa điểm trong phản hồi chứa trường flagContentUri mà bạn có thể dùng để gắn cờ nội dung không phù hợp để Google có thể xoá nội dung đó. Tệp này cũng chứa một mảng gồm tối đa 4 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 địa điểm thuộc loại electric_vehicle_charging_station, các khối chủ đề bao gồm: "overview", "coffee", "restaurant""store".

  • Đối với một địa điểm có loại được xác định theo danh mục Khách sạn và các loại địa điểm cụ thể geocodepremise, các khối chủ đề bao gồm: "overview", "activity", "restaurant""store".

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

Yêu cầu Chi tiết về địa điểm mẫu này trả về thông tin tóm tắt về khu vực cho một trạm sạc xe điện cụ thể ở Mountain View, được xác định bằng 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ả mảng contentBlocks:

  • Trường topic chỉ định loại khối nội dung. Vì địa điểm trong ví dụ này là một trạm sạc xe điện, nên 4 khối nội dung là "overview", "coffee", "restaurant""store".

  • Trường content bao gồm nội dung tóm tắt về chủ đề đó, bao gồm cả mã ngôn ngữ.

  • Mảng references chỉ định tên tài nguyên vị trí, ở dạng 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"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

Ví dụ về yêu cầu tóm tắt khu vực cho một khách sạn

Ví dụ về yêu cầu Tìm kiếm bằng văn bản này yêu cầu thông tin về khách sạn ở Mountain View, California:

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ả mảng contentBlocks. Phản hồi cho các địa điểm thuộc loại khách sạn chứa các khối nội dung cho các chủ đề "overview", "activity", "restaurant""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"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

Yêu cầu kết quả tìm kiếm theo bối cảnh

Phản hồi cho yêu cầu Tìm kiếm bằng văn bản (Mới) chứa một mảng địa điểm khớp với tiêu chí của chuỗi 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 bối cảnh trong phản hồi dựa trên truy vấn đầu vào cho API.

Để hỗ trợ thông tin 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 là 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, nằm ở vị trí mảng tương ứng như vị trí trong mảng places. Tức là phần tử tại contextualContents[0] tương ứng với vị trí 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 5 ảnh.
  • contextualContents.justifications: Một mảng lý do cho địa điểm, bao gồm:

    • reviewJustification: Làm nổi bật một phần 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 mà người dùng cuối có thể quan tâm.

Để đưa kết quả tìm kiếm theo ngữ cảnh vào nội dung phản hồi, hãy thêm contextualContents vào mặt nạ trường của yêu cầu Tìm kiếm bằng 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

Nội dung phản hồi chứa mảng contextualContents cho mỗi địa điểm trong phản hồ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": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "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": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "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/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "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": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

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

Để đảm bảo an toàn cho người lái xe, Google khuyên bạn nên hiển thị bản tóm tắt AI tạo sinh ở chế độ đỗ xe cho trải nghiệm trên ô tô. Nếu hiển thị thông tin 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à ngắn gọn để đảm bảo người lái xe nhanh chóng tập trung trở lại đường.

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

Đặc biệt 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 AI tạo sinh theo cách an toàn và tuân thủ mọi luật và quy định của địa phương.

Phân bổ

Khi hiển thị bài đánh giá, ảnh và bản tóm tắt do AI tạo sinh trong ứng dụng, bao gồm cả bản 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 thông tin ghi công bắt buộc.

Hiển thị thông tin phân bổ cho bản tóm tắt tạo sinh

Khi hiển thị bản tóm tắt do AI tạo sinh trong ứng dụng, bao gồm cả bản tóm tắt về địa điểm và khu vực, bạn cũng phải hiển thị các thông tin ghi công cần thiết. Phần này mô tả cách hiển thị thông tin phân bổ dựa trên cách bạn hiển thị bản tóm tắt AI tạo sinh trong ứng dụng.

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

Bản tóm tắt về AI tạo sinh được hiển thị trong bối cảnh của các dữ liệu khác của Google

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

Đối với phần ghi công, hãy sử dụng văn bản "Tóm tắt bằng AI" như trong hình ảnh này:

Đối với phần ghi công, hãy sử dụng văn bản Tóm tắt bằng AI.

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

Khi bản tóm tắt nội dung do AI tạo sinh xuất hiện riêng biệt với mọi nội dung khác trên Google Maps, bản tóm tắt đó phải bao gồm cả phần ghi công AI tạo sinh và phần ghi công Google, được phân tách bằng dấu chấm phẩy. Đối với phần ghi công, hãy sử dụng văn bản "Tóm tắt bằng AI" và biểu trưng Google như trong hình ảnh này:

Đối với bản tóm tắt hiển thị riêng biệt, hãy thêm mô hình phân bổ AI tạo sinh và mô hình phân bổ của Google, phân tách bằng dấu chấm phẩy.

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

Khi lặp lại một thông tin tổng quan tóm tắt về địa điểm do AI tạo sinh trong danh sách địa điểm, trong đó tất cả:

  • Nội dung danh sách được phân bổ cho Google
  • Bản tóm tắt hiển thị là do AI tạo
  • Nội dung do Google cung cấp

Nội dung ghi công phải hiển thị ở trên hoặc dưới danh sách trên một dòng. Thuộc tính AI được căn trái và thuộc tính Google được căn phải:

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

Nếu bạn sử dụng nội dung tóm tắt mô tả dài hơn do AI tạo sinh trong danh sách, thì mỗi nội dung tóm tắt phải có thông tin ghi công AI ("Do AI tóm tắt" kèm theo biểu tượng/nút thông tin).

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

Cùng với bản tóm tắt AI tạo sinh, bạn phải cung cấp một hộp thoại cho người dùng cuối để 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 vấn đề bằng cách sử dụng giá trị nhận dạng duy nhất của bản tóm tắt có trong trường flagContentUri. Khi sử dụng tóm tắt nội dung mô tả do AI tạo sinh, bạn phải đưa vào thông tin về nguồn của bản tóm tắt, được gọi là thông tin tham 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ưới dạng một tính năng tương tác) cùng với mô hình phân bổ AI (như mô tả trong các ví dụ trên) và làm cho khu vực phân bổ AI và biểu tượng phản hồi một thao tác nhấn/nhấp.

Đối với bản tóm tắt địa điểm tạo sinh, hãy hiển thị:

Giới thiệu Thông tin tóm tắt về địa điểm do AI tạo được tạo từ các bài đánh giá trên Google và các dữ liệu khác.
Báo cáo sự cố Để báo cáo vấn đề với Google về nội dung của một bản tóm tắt, hãy sử dụng đường liên kết có trong trường flagContentUri.
Tài liệu tham khảo Bài đánh giá nguồn

Ví dụ:

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

Đối với bản tóm tắt về khu vực tạo sinh, hãy hiển thị:

Giới thiệu Thông tin tóm tắt về khu vực do AI tạo đượ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 đề với Google về nội dung của một bản tóm tắt, hãy sử dụng đường liên kết có trong trường flagContentUri.

Hiển thị mô hình phân bổ tóm tắt theo khu vực.