Các chức năng của mô hình Gemini dành cho Places API (Mới) hỗ trợ các LLM (mô hình ngôn ngữ lớn) cho Places API để 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 các 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 để cải thiện dữ liệu đã được liên kết với một địa điểm.
Ví dụ: Tìm kiếm văn bản (Mới) tiêu chuẩn 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. Bạn có thể dùng loại câu trả lời này nếu chỉ đang tìm trạm sạc xe điện gần nhất hoặc bộ 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 hiểu rõ hơn về khu vực xung quanh trạm sạc, đặc biệt là nếu bạn sẽ ở đó trong một giờ trở lên trong khi xe đang sạc. Khi sử dụng các tính năng của mô hình Gemini cho cùng một lượt tìm kiếm, câu trả lời có thể chứa nội dung mô tả linh động do AI tạo về từng đị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:
"Trong vòng 2-4 phút đi bộ, có một số lựa chọn ăn uống và mua sắm, bao gồm Chef Chu's, Gen Korea BBQ House, Amber India, PacificCatch và 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ó một số địa điểm ăn uống và mua sắm, bao gồm Khao Kang Thai Kitchen, Robert's Deli & Donuts và La Chieña. Đối với sushi, Joy Sushi là một lựa chọn tốt. Đối với hàng tạp hoá, Đô la Tree cung cấp nhiều sản phẩm với mức giá chiết khấu."
Nội dung tạo sinh của các LLM cải thiện câu trả lờ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.
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 địa điểm cụ thể. Phần tóm tắt địa điểm được hỗ trợ bởi Chi tiết đị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 khu vực tạo sinh liên quan đến một khu vực cụ thể xung quanh một địa điểm. Tính năng tóm tắt khu vực được hỗ trợ bởi Chi tiết đị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 Tìm kiếm văn bản (Mới) hỗ trợ 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 liên kết trực tiếp với một địa điểm. Dữ liệu này giúp hiểu cách tính năng Tìm kiếm văn bản (Mới) xác định phản hồ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. Địa điểm tóm tắt 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 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 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 bao gồm những địa điểm hàng đầu của địa điểm.
Hiện tại, bạn có thể xem thông tin tóm tắt về địa điểm cho các loại địa điểm hiển thị trong Các loại được hỗ trợ cho các danh mục Văn hoá, Giải trí 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. Bản tóm tắt 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 yêu cầu thêm để xem chi tiết khu vực.
Cùng với nội dung mô tả về khu vực, phản hồi còn chứa danh sách mã địa điểm của những địa điểm được tham chiếu trong phần 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 quan đến các hoạt động trong khu vực và một loại khác chứa danh sách các nhà hàng trong khu vực.
Bạn hiệ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
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 được Google thường xuyên tạo khi không có mạng. 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 đạt được hiệu suất tương tự như Places API (Mới) như 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 mẻ 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 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". Phản hồi Tìm kiếm văn bản (Mới) chứa danh sách các vị trí khớp với chuỗi văn bản và mọi độ lệch vị trí được đặt trong yêu cầu.
Giờ đây, khi bạn thêm kết quả tìm kiếm theo bối cảnh vào câu trả lời, thì câu trả lời sẽ bao gồm bài đánh giá, hình ảnh và lý do 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 đư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ìm kiếm lân cận (Mới) kèm theo một địa điểm cụ thể trong câu trả lời. Dữ liệu phản hồi cho địa điểm là giống nhau cho cả 3 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, 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 ngữ cảnh là duy nhất đối với chuỗi truy vấn. Ví dụ: bạn đưa ra 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 sẽ 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 ă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 đó là giống nhau 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 đối với truy vấn vì chúng được lấy từ chuỗi truy vấn. Sau đó, bạn có thể cho người dùng thấy các bài đánh giá, ảnh và lý giải từ kết quả tìm kiếm theo ngữ cảnh để giúp họ quyết định nơi phù hợp nhất với yêu cầu tìm kiếm của họ trong câu trả lời.
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 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 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 ở Hoa Kỳ bằng tiếng Anh.
Gemini là gì?
Để tìm hiểu về mô hình Gemini, hãy xem phần Câu hỏi thường gặp về Gemini.
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à các bản tóm tắt tạo sinh do LLM tạo cho một địa điểm cụ thể. Places API (Mới) thêm hai loại nội dung tóm tắt vào phản hồi:
Bản tóm tắt tạo sinh Tổng quan tương tự như bản tóm tắt biên tập tĩnh liên kết với một địa điểm. Bản 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 nơi do không có thông tin tóm tắt của biên tập viên nên sẽ bổ sung thông tin còn thiếu cho một địa điểm.
Các mô hình này được tạo từ LLM, nên chủ sở hữu địa điểm không cần phải 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ả các bài đánh giá trên Google Maps. Nội dung mô tả trung bình dài khoảng 400 ký tự, bao gồm một danh sách các bài đánh giá dùng để tạo nội dung mô tả dài.
Để tạo bản tóm tắt nội dung mô tả theo cách thủ công, con người phải tổng hợp dữ liệu từ nhiều địa điểm, sau đó tự làm 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 mô hình ngôn ngữ lớn (LLM) để duy trì phạm vi và độ mới của nội dung đã tạo.
Phần tóm tắt địa điểm được hỗ trợ bởi Chi tiết đị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 nội dung tóm tắt địa điểm vào phản hồi, hãy đưa trường sau vào mặt nạ trường của yêu cầu:
Chi tiết địa điểm:
generativeSummaryTìm kiếm 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: 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á 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ó phần tóm tắt nội dung mô tả, thì mảng này sẽ trống.
Ví dụ về yêu cầu tóm tắt thông tin tổng quan
Trong ví dụ này, tính năng Tìm kiếm văn bản chỉ trả về thông tin tóm tắt overview về 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.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 thực hiện cùng một truy vấn như trong ví dụ trước nhưng sử dụng mặt nạ trường của places.generativeSummary để trả về toàn bộ đối tượng generativeSummary, bao gồm các trường generativeSummary.overview, 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. Thông tin tóm tắt về 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ề một đị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 có thể tìm được 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 đồ của khu vực xung quanh rồi phải tìm hiểu từng địa điểm trên bản đồ, bạn có thể tạo bản tóm tắt về khu vực cho khách sạn.
Tính năng tóm tắt khu vực được hỗ trợ bởi Chi tiết đị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 nội dung 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(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).
Trường areaSummary cho một vị trí trong phản hồi chứa một mảng 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ủ đề sẽ bao gồm:"overview","coffee","restaurant"và"store".Đối với một địa điểm có loại được xác định theo danh mục Nhà nghỉ và các loại địa điểm cụ thể
geocodevàpremise, các khối chủ đề sẽ 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 Thông tin chi tiết về địa điểm này trả về thông tin tóm tắt về khu vực của một trạm sạc xe điện cụ thể ở 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ả mảng contentBlocks:
Trường
topicchỉ đị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"và"store".Trường
contentbao gồm thông tin tóm tắt về chủ đề đó, bao gồm cả mã ngôn ngữ.Mảng
referenceschỉ định tên tài nguyên địa điểm, ở dạngplaces/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ả mảng 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 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 yêu cầu Tìm kiếm văn bản (Mới) có chứa một mảng các vị trí 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 ngữ cảnh trong phản hồi dựa trên truy vấn đầu vào gửi đến API.
Để hỗ trợ nội dung tóm tắt theo ngữ cảnh, phản hồi từ Text Search (New) (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 giải thích cho địa điểm, bao gồm:reviewJustification: Làm nổi bật một phần trong 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ể là mối quan tâm của người dùng cuối.
Để đưa kết quả tìm kiếm theo ngữ cảnh vào phản hồi, hãy đưa contextualContents vào 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 từng vị trí 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": "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 dựa trên AI tạo sinh ở chế độ đỗ xe cho trải nghiệm trên ô tô. Nếu hiển thị bản tóm tắt ở chế độ lái xe, thì 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 người lái xe nhanh chóng tập trung vào đườ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 dựa trên AI tạo sinh sao cho an toàn và tuân thủ mọi luật và quy định tại đị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 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 cho thấy thông tin cần thiết.
Hiện thông tin ghi nhận sự đóng góp cho bản tóm tắt tạo sinh
Khi hiển thị bản tóm tắt dựa trên 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 cho thấy các thuộc tính 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ị nội dung tóm tắt về AI tạo sinh trong ứng dụng.
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. Thuộc tính và biểu trưng của Google phải tuân thủ 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, hãy xem Chính sách dành cho API Địa điểm (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 phía dưới phần tóm tắt, tuỳ thuộc vào thông tin ghi nhận tác giả của Google cho nội dung đó ở những nơi 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 ảnh sau:
Bản tóm tắt về AI tạo sinh được hiển thị riêng biệt
Khi xuất hiện riêng biệt với mọi nội dung khác trên Google Maps, một bản tóm tắt về AI tạo sinh phải bao gồm cả thông tin ghi nhận sự đóng góp và thuộc tính của AI tạo sinh được phân tách bằng dấu ngắt quãng. Đố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" và biểu trưng của Google như trong hình ảnh sau:
Bản tóm tắt về AI tạo sinh lặp lại trong một danh sách
Khi lặp lại nội dung tổng quan tóm tắt về vị trí do AI tạo sinh tạo trong một danh sách đị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 được căn phải:
Nếu bạn sử dụng bản tóm tắt nội dung mô tả của AI tạo sinh dạng dài trong một danh sách, thì mỗi bản tóm tắt phải có mô hình phân bổ AI ("Tóm tắt bởi AI" kèm theo 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 cho người dùng cuối để người dùng cuối thấy thông tin về bản tóm tắt đó và một đường liên kết để báo cáo vấn đề. Khi sử dụng bản tóm tắt nội dung mô tả dựa trên AI tạo sinh, bạn phải cung cấp thông tin về nguồn của bản tóm tắt đó, gọi là references.
Bật quyền 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 nội dung 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), đồng thời làm cho vùng phân bổ và biểu tượng AI phản hồi với thao tác nhấn/lượt 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à các dữ liệu khác. |
| Báo cáo vấn đề | Để báo cáo vấn đề cho Google về nội dung của bản tóm tắt, hãy 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ụ:
Để 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 vấn đề | Để báo cáo vấn đề cho Google về nội dung của bản tóm tắt, hãy truy cập vào đường liên kết này. |
