Các chức năng của mô hình Gemini dành cho Places API (Mới) hỗ trợ các LLM 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 đã liên kết với một địa điểm.
Ví dụ: thao tác Tìm kiếm bằng 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. Loại phản hồi này sẽ phù hợp nếu bạn chỉ đang tìm kiếm bộ 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 mình.
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 nếu bạn sẽ ở đó từ một giờ trở lên trong khi sạc xe. Khi sử dụng các chức năng của mô hình Gemini cho cùng một nội dung tìm kiếm, nội dung phản hồi có thể chứa các nội dung mô tả linh động và tạo sinh về từng địa điểm trong phản hồi, bao gồm cả thông tin về khu vực xung quanh trạm sạc:
"Chỉ trong vòng 2-4 phút đi bộ, bạn có thể đến nhiều lựa chọn ăn uống và mua sắm, bao gồm Chef Chu's, Gen Korea BBQ House, Amber India, Pacific Catch và một vài cửa hàng tạp hoá như Walmart, Whole Foods Market và Trade Joe's."
"Chỉ trong vòng 1 đến 5 phút đi bộ, bạn có thể đến nhiều lựa chọn ăn uống và mua sắm, bao gồm Khao Kang Thai Kitchen, Rogers's Deli & Donuts và La Costeña. Đối với sushi, Joy sushi là một lựa chọn tốt. Đối với các cửa hàng tạp hoá, đô la cung cấp nhiều loại sản phẩm với giá chiết khấu."
Nội dung tạo sinh này từ các LLM giúp cải thiện 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.
Các tính năng mới sử dụng trí tuệ nhân tạo đã được thêm vào Places API (Mới)
Những chức năng này thêm dữ liệu sau vào phản hồi Places API (Mới):
Thông tin tóm tắt về địa điểm tạo sinh liên quan đến một địa điểm cụ thể. Tính năng tóm tắt thông tin 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).
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. Tính năng tóm tắt khu vực đượ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).
Kết quả tìm kiếm theo ngữ cảnh được Text Search (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 bằng văn bản (Mới) xác định câu trả lời.
Thông tin tóm tắt tạo sinh về địa điểm
Thông tin tóm tắt về địa điểm tạo sinh là dành riêng cho một mã địa điểm. Thông tin tóm tắt đị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 hai loại thông tin 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ả: Bản 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 các khía cạnh hàng đầu của địa điểm.
Tính năng tóm tắt về địa điểm hiện có sẵn cho các loại địa điểm hiển thị trong Loại được hỗ trợ cho các danh mục Văn hóa, Giải trí và giải trí, Ẩm thực và đồ uống, Mua sắm và Thể thao.
Thông tin tóm tắt về khu vực tạo sinh
LLM tạo bản tóm tắt về khu vực tạo sinh cho khu vực lân cận xung quanh một địa điểm. Nội dung 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 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 cho các địa điểm được tham chiếu trong nội dung mô tả và danh sách các địa điểm được sắp xếp theo 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 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ể sử dụng thông tin tóm tắt về khu vực cho các loại địa điểm hiển thị trong Các loại được hỗ trợ của 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 thông tin tóm tắt về địa điểm và khu vực
Cả nội dung tóm tắt về địa điểm do AI tạo lẫn nội dung tóm tắt về khu vực do AI tạo đề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 trong khi vẫn thấy được 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 các 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 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 tập hợp đị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 độ chệ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 câu trả lời, giờ đây, câu trả lời sẽ bao gồm các bài đánh giá, ảnh và lý do giúp người dùng trả lời câu hỏi:
- Tại sao tôi lạ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 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) bao gồm 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à như 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 công cụ 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 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) với chuỗi truy vấn sau:
"Nhà hàng món chay cay ở Mountain View, CA"
Sau đó, bạn để nguyên tất cả các tham số đầu vào và chỉ thay đổi chuỗi truy vấn thành:
"Nhà hàng thuần chay cay ở 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, kết quả tìm kiếm theo ngữ cảnh là duy nhất đối với cụm từ tìm kiếm vì chúng bắt nguồn từ chuỗi cụm từ tìm kiếm. Sau đó, bạn có thể cho người dùng thấy các bài đánh giá, ảnh và lý do giải thích trong kết quả tìm kiếm theo ngữ cảnh để giúp họ quyết định vị trí nào trong 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 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 chức 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.
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.
Song Tử 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 thông tin tóm tắt về địa điểm do AI tạo
Thông tin tóm tắt về địa điểm là những bản tóm tắt do LLM tạo ra cho một địa điểm cụ thể. Places API (Mới) thêm 2 loại nội dung tóm tắt vào câu trả lời:
Nội dung tóm tắt do AI tạo Tổng quan tương tự như bản tóm tắt tĩnh của nội dung biên tập được liên kết với một địa điểm. Bản tóm tắt ngắn gọn mang tính 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 của người biên tập, vì vậy, họ cung cấp thông tin còn thiếu cho một địa điểm.
Các đối tượng này được tạo từ LLM, vì vậy, chủ sở hữu địa điểm không cần phải duy trì các mô hình đó.
Nội dung mô tả: Nội dung tóm tắt do AI tạo đượ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 khoảng 400 ký tự) sẽ 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, người dùng phải tổng hợp dữ liệu từ nhiều địa điểm, sau đó làm 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 bản tóm tắt này từ các LLM để duy trì phạm vi và độ mới của nội dung được tạo.
Tính năng tóm tắt thông tin 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 phản hồi, hãy đưa trường sau đây vào mặt nạ trường của yêu cầu:
Thông tin về đị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: Phần tóm tắt tổng quan về quá trình tạo sinh.generativeSummary.description: Tóm tắt nội dung mô tả về quá trình tạo sinh.generativeSummary.references: Một dãy 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 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
Ví dụ về Tìm kiếm văn bản này chỉ trả về tóm tắt overview cho các nhà hàng món 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 này 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 tóm tắt nội dung tổng quan và nội dung mô tả
Ví dụ này thực hiện truy vấn tương tự như 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á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
Thông tin tóm tắt về khu vực là thông tin tóm tắt do LLM tạo ra cho khu vực lân cận của một địa điểm. Thông tin tóm tắt khu vực có thể 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à trong khi tìm được một khách sạn đáp ứng các 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 đồ khu vực xung quanh và sau đó 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.
Tính năng tóm tắt khu vực đượ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 phầ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 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 một mảng gồm tối đa 4 contentBlocks.
Chủ đề cho mỗi khối dựa trên loại địa điểm:
Đối với một 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 nhóm 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 bằng danh mục Nhà nghỉ cũng như 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 về thông tin tóm tắt 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 cho 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 này 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à 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 nội dung 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"
]
}
}
]
}
}
Ví dụ về yêu cầu cung cấp thông tin tóm tắt về 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 nà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 này 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 theo 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 bằng văn bản (Mới) chứa một mảng vị trí phù hợp với tiêu chí của chuỗi tìm kiếm đầu vào. Bây giờ, 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ợ bản tóm tắt theo ngữ cảnh, nội dung phản hồi qua phần 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, ở vị trí mảng tương ứng là 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 dãy 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 loạt lý do 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 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 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 khi lái xe. 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à súc tích để đảm bảo người lái xe nhanh chóng chú ý đến đường đi.
- Không quá 3 dòng
- Tối đa 120 ký tự hoặc 24 từ
- Kích thước 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 dựa trên AI tạo sinh theo cách an toàn và tuân thủ tất cả luật và quy định của địa phương.
Phân bổ
Khi cho thấy bài đánh giá, ảnh và thông tin tóm tắt dựa trên AI tạo sinh trong ứng dụng của mình, bao gồm cả thông tin tóm tắt về địa điểm và khu vực, bạn phải đảm bảo rằng mình cũng hiển thị các thông tin tóm tắt bắt buộc.
Hiện thông tin ghi nhận sự đóng góp cho bản tóm tắt do AI tạo
Khi cho thấy thông tin tóm tắt về AI tạo sinh trong ứng dụng, bao gồm cả tóm tắt về địa điểm và khu vực, 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ị các mô hình phân bổ dựa trên cách bạn hiện tóm tắt về AI tạo sinh trong ứng dụng của mình.
Trong mọi trường hợp, thuộc tính phải sử dụng cách viết hoa đầu câu. Thuộc tính và biểu trưng 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 Places API (Mới).
Bản tóm tắt bằng AI tạo sinh xuất hiện trong bối cảnh dữ liệu khác trên Google
Trong trường hợp này, mô hình phân bổ dựa trên AI tạo sinh có thể chỉ hiển thị ở phía trên hoặc phía dưới phần tóm tắt, dựa vào dữ liệu phân bổ của Google đối với nội dung ở 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:
Trình bày riêng bản tóm tắt về AI tạo sinh
Khi bản tóm tắt dựa trên AI tạo sinh xuất hiện tách biệt với bất kỳ nội dung nào khác của Google Maps, thì bản tóm tắt đó phải bao gồm cả dữ liệu phân bổ và phân bổ dựa trên AI tạo sinh cho Google, được phân tách bằng dấu chấm than. Đối với tính năng phân bổ, 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 dưới đây:
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 thông tin tóm tắt địa điểm dựa trên AI tạo sinh trong danh sách các địa điểm, trong đó có tất cả:
- Nội dung danh sách được gán cho Google
- Nội dung tóm tắt được hiển thị là nội dung do AI tạo
- Nội dung có trên Google
Thuộc tính phải được hiển thị phía trên hoặc phía dưới danh sách trong một dòng duy nhất. Mô hình phân bổ AI được căn trái và mô hình phân bổ Google được căn phải:
Nếu bạn sử dụng các bản tóm tắt nội dung mô tả của AI tạo sinh dạng dài hơn trong một danh sách, thì mỗi bản tóm tắt phải có mô hình phân bổ dựa trên AI ("Do AI tóm tắt" có biểu tượng/nút thông tin).
Hiện thông tin tóm tắt về AI tạo sinh trong một hộp thoại
Ngoài bản tóm tắt dựa trên AI tạo sinh, bạn phải cung cấp cho người dùng cuối một hộp thoại cho 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 thêm thông tin về nguồn của bản tóm tắt, được gọi là references.
Cho phép truy cập vào hộp thoại này bằng cách bao gồm một biểu tượng thông tin (dưới dạng khả năng tương tác) cùng với thuộc tính AI (như mô tả trong các ví dụ ở trên), đồng thời làm cho khu vực và biểu tượng thuộc tính AI phản hồi với một lượt nhấn/lượt nhấp.
Đối với thông tin tóm tắt về địa điểm do AI tạo, hãy hiển thị:
| Giới thiệu | Thông tin tóm tắt về địa điểm bằng AI được tạo dựa trên 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 đề về nội dung của bản tóm tắt cho Google, 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ụ:
Đối với phầ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 sử dụng trí tuệ nhân tạo được tạo dựa trên 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 đề về nội dung của bản tóm tắt cho Google, hãy truy cập vào đường liên kết này. |
