توفّر إمكانات نماذج Gemini في Places API (الجديدة) إمكانية استخدام النماذج اللغوية الكبيرة في Places API على الويب بحيث يمكنك عرض البيانات المرتبطة بالمكان (ساعات العمل والمراجعات والصور) إلى جانب البيانات التي تقدّمها النماذج اللغوية الكبيرة. تحتوي هذه البيانات التوليدية على بيانات مجمّعة وملخصة من النماذج اللغوية الكبيرة لتحسين البيانات المرتبطة بالمكان.
على سبيل المثال، يؤدي إجراء بحث نصي (جديد) عادي حول "محطات شحن المركبات الكهربائية" إلى عرض قائمة بالأماكن التي تتوفّر فيها خدمة شحن المركبات الكهربائية. لا بأس بهذا النوع من الاستجابة إذا كنت تبحث فقط عن أقرب شاحن مركبة كهربائية أو أقرب شاحن متوافق مع مركبتك.
ولكنك قد ترغب أيضًا في الحصول على فهم أفضل للمنطقة المحيطة بمحطة الشحن، خاصة إذا كنت ستذهب هناك لمدة ساعة أو أكثر أثناء شحن مركبتك. عند استخدام إمكانات نموذج Gemini في البحث نفسه، يمكن أن تحتوي الاستجابة على أوصاف ديناميكية وإنتاجية لكل مكان في الاستجابة، بما في ذلك معلومات حول المنطقة المحيطة بمحطة الشحن:
"على بُعد دقيقتين إلى 4 دقائق سيرًا على الأقدام، هناك العديد من خيارات تناول الطعام والتسوق، بما في ذلك Chef Cha's وGen Korea المؤدية إلى مشويات وAmber India و Pacific Catch، والعديد من متاجر البقالة مثل Walmart وHowle Foods Market وTrader Joe's".
". بالنسبة إلى السوشي، تُعدّ السوشي على شكل Joy خيار جيد. بالنسبة للبقالة، تقدم Dollar Tree مجموعة من المنتجات بأسعار مخفضة".
إنّ هذا المحتوى التوليدي من النماذج اللغوية الكبيرة يحسّن الاستجابة ويوفّر معلومات إضافية لمساعدة المستخدمين على اتخاذ قرار مدروس.
تمت إضافة ميزات جديدة مستندة إلى الذكاء الاصطناعي (AI) إلى Places API (ميزة جديدة)
تضيف هذه الإمكانات البيانات التالية إلى استجابة Places API (جديدة):
ملخّصات الأماكن التوليدية التي ترتبط بمكان معيّن. تتوفّر ملخّصات الأماكن باستخدام تفاصيل المكان (جديد) والبحث النصي (جديد) والبحث عن قرب (ميزة جديدة).
ملخّصات البيانات التوليدية التي ترتبط بمنطقة حول مكان معيّن معيّنة. تتوفّر ملخّصات عن المنطقة باستخدام تفاصيل المكان (جديد) والبحث النصي (جديد) والبحث عن قرب (ميزة جديدة).
تتوفّر نتائج البحث السياقي في البحث النصي (جديد) وتحتوي على بيانات استنادًا إلى سلسلة البحث التي يتم تمريرها في الطلب، بدلاً من البيانات المرتبطة مباشرةً بالمكان. تساعد هذه البيانات في فهم كيفية تحديد "البحث النصي" (جديد) للاستجابة.
ملخّصات من إنشاء الأماكن
تختص الملخصات التوليدية عن الأماكن برقم تعريف مكان معيّن. تقوم الملخصات بتجميع العديد من أنواع البيانات المختلفة في ملخص واحد للمكان.
توفر Places API (جديدة) نوعين من الملخصات التوليدية للأماكن:
ملخّصات عامة: نظرة عامة مختصرة حول مكان معيّن تضمّ 100 حرف في المتوسط، ويمكن أن تساعد المستخدمين في الحصول على نبذة عن المكان.
ملخصات الوصف: ملخصات أطول لمكان، في المتوسط 400 حرف تقريبًا، والتي تقدم نظرة عامة تفصيلية تغطي أهم الجوانب في المكان.
تتوفر ملخصات الأماكن حاليًا لأنواع الأماكن المعروضة في الأنواع المتوافقة مع الفئات التالية: الثقافة، والترفيه والترفيه، والمأكولات والمشروبات، والتسوّق، والرياضة.
ملخّصات المنطقة التوليدية
وتنشئ النماذج اللغوية الكبيرة ملخّصات المنطقة القريبة حول مكان معيّن. قد يتضمن ملخص المنطقة لمكان ما جميع المعلومات اللازمة لاتخاذ قرار، بدون الحاجة إلى تقديم طلبات إضافية للتعمق في تفاصيل المنطقة.
إلى جانب وصف المنطقة، يحتوي الرد أيضًا على قائمة بمعرّفات الأماكن للأماكن المشار إليها في الوصف، وقائمة بالأماكن مرتبة حسب أنواع المحتوى المختلفة. على سبيل المثال، يحتوي أحد أنواع المحتوى على قائمة بالأماكن المرتبطة بالأنشطة في المنطقة، ويحتوي نوع آخر على قائمة بالمطاعم في المنطقة.
تتوفر ملخّصات عن المنطقة حاليًا لأنواع الأماكن المعروضة في الأنواع المتوافقة مع فئة السكن، فضلاً عن أنواع الأماكن المحدّدة
electric_vehicle_charging_station وgeocode وpremise.
إنشاء ملخّصات عن الأماكن والمناطق
بشكل متكرر، تنشأ Google كل من الملخّصات التوليدية وملخّصات المنطقة التوليدية بلا اتصال بالإنترنت. من خلال إنشاء هذه الملخصات بلا اتصال، يمكنك الاستفادة من المحتوى الذي يدعمه Gemini مع الاستمرار في مشاهدة الأداء نفسه من Places API (الجديدة) التي كنت تتوقّعها بالفعل.
تعيد Google إنشاء هذه الملخّصات بشكل متكرر للتأكّد من أنّها حديثة وتستند إلى أحدث المعلومات المتاحة. وهذا يعني أنك ستعرض أحدث البيانات في خدمتك عند استدعاء واجهة برمجة التطبيقات.
نتائج البحث السياقي
يعرض البحث النصي (جديد) معلومات حول مجموعة من الأماكن استنادًا إلى سلسلة، على سبيل المثال "فطائر في دبي" أو "متاجر أحذية بالقرب من أوتاوا". تحتوي استجابة البحث النصي (جديد) على قائمة بالأماكن التي تطابق السلسلة النصية وأي تحيز للموقع الجغرافي تم تحديده في الطلب.
بعد إضافة نتائج بحث سياقية إلى الردّ، سيشمل الردّ الآن المراجعات والصور والتبريرات التي تساعد المستخدمين في الإجابة عن الأسئلة:
- لماذا أرى هذا المكان في النتائج؟
- لماذا يجب أن أختار هذا المكان؟
على سبيل المثال، إذا أرسلت طلبًا إلى "تفاصيل المكان" (جديد) أو "بحث نصي (جديد)" أو "بحث قريب" (جديد) اليوم، يتضمّن الردّ مكانًا محددًا في الردّ. بيانات الاستجابة الخاصة بالمكان هي نفسها لجميع الطلبات الثلاثة لأن البيانات التي تم إرجاعها مرتبطة بهذا المكان.
ومع ذلك، بالنسبة إلى البحث النصي (الجديد) الذي يستخدم الإمكانات الجديدة، يمكن أن تتضمّن الاستجابة بيانات مستمدة من سلسلة طلب البحث المُدخلة نفسها. وهذا يعني أن نتائج البحث السياقية تكون فريدة من نوعها لسلسلة طلب البحث. على سبيل المثال، يمكنك إجراء طلب بحث نصي (جديد) باستخدام سلسلة الاستعلام التالية:
"مطعم نباتي حار في ماونتن فيو، كاليفورنيا"
يمكنك بعد ذلك ترك جميع معلمات الإدخال كما هي وتغيير سلسلة طلب البحث فقط إلى:
"مطعم نباتي حار في ماونتن فيو، كاليفورنيا"
بالنسبة للمطعم الذي يظهر في كلا الردين، تكون بيانات الاستجابة حول المكان هي نفسها لأن هذه البيانات مرتبطة بالمكان نفسه. ولكن تكون نتائج البحث السياقية فريدة بطلب البحث، لأنها مشتقة من سلسلة طلب البحث. يمكنك بعد ذلك عرض المراجعات والصور والتبريرات من نتائج البحث السياقية للمستخدمين لمساعدتهم في تحديد المكان الأكثر ملاءمة لطلب البحث في الرد.
تفعيل إمكانيات نموذج Gemini في Places API (جديدة)
يجب تمكين واجهة برمجة تطبيقات الأماكن (جديدة) لاستخدام إمكانيات نموذج Gemini لواجهة برمجة تطبيقات الأماكن (جديدة). لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مشروعك على Google Cloud.
قيود الإصدار التجريبي
يتيح هذا الإصدار استخدام ملخّصات الأماكن والمناطق حول الأماكن في الولايات المتحدة باللغة الإنجليزية فقط.
ما هو الجوزاء؟
لمعرفة معلومات عن نموذج Gemini، يُرجى الاطّلاع على الأسئلة الشائعة حول Gemini.
طلب ملخّص من إنشاء المكان
إنّ ملخّصات الأماكن هي ملخّصات من إنشاء النموذج اللغوي الكبير تشير إلى مكان محدّد. تضيف واجهة Places API (جديدة) نوعين من الملخّصات إلى أي رد:
نظرة عامة هي ملخّصات من إنشاء المستخدمين تشبه الملخص التحريري الثابت المرتبط بأحد الأماكن. للملخصات القصيرة التوليدية، التي تتضمن في المتوسط حوالي 100 حرف، عدة مزايا:
لا تتوفر ملخصات تحريرية للعديد من الأماكن، لذلك يملأون فجوة في المعلومات المتاحة للمكان.
ويتم إنشاء هذه النماذج من النموذج اللغوي الكبير، وبالتالي ليس من الضروري أن يتولّى مالكها صيانتها.
الوصف يتم استنتاج الملخّصات التوليدية من عدة مصادر، بما في ذلك المراجعات من "خرائط Google". يتضمن الوصف، في المتوسط 400 حرف تقريبًا، قائمة بالمراجعات المستخدمة لإنشاء الوصف الطويل.
لإنشاء ملخصات وصفية يدويًا، يتطلب الأمر من الشخص تجميع البيانات من العديد من المواقع ثم صياغة المحتوى يدويًا وصيانته. تنشئ إمكانات نماذج Gemini في Places API (الجديدة) هذه الملخّصات من النماذج اللغوية الكبيرة للحفاظ على نطاق المحتوى الذي يتم إنشاؤه وحداثته.
تتوفّر ملخّصات الأماكن باستخدام تفاصيل المكان (جديد) والبحث النصي (جديد) والبحث عن قرب (ميزة جديدة). لتضمين ملخّص المكان في الردّ، عليك تضمين الحقل التالي في قناع الحقل الخاص بالطلب:
تفاصيل المكان:
generativeSummaryالبحث النصي والبحث عن قرب:
places.generativeSummary
يحتوي الحقل
generativeSummary
على الحقول التالية:
generativeSummary.overview: ملخّص النظرة العامة التوليديgenerativeSummary.description: ملخّص الوصف التوليديgenerativeSummary.references: هي مجموعة تضم ما يصل إلى خمس مراجعات تُستخدم لتوفير محتوى ملخّص الوصف. إذا لم يكن هناك ملخص وصف، فيكون هذا الصفيف فارغًا.
مثال على طلب ملخّص النظرة العامة
يعرض هذا المثال "البحث النصي" ملخّص overview فقط للمطاعم النباتية الحارة في ماونتن فيو بولاية كاليفورنيا:
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
ويحتوي الرد على الحقل generativeSummary.overview الذي يتضمّن
overview.text و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"
}
}
},
. . .
}
مثال لطلب ملخّص عن الوصف ونظرة عامة
يجري هذا المثال طلب البحث نفسه كما هو موضّح في المثال السابق، ولكنه يستخدم قناع حقل places.generativeSummary لعرض كائن generativeSummary بأكمله، بما في ذلك الحقول generativeSummary.overview وgenerativeSummary.description و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"
},
. . .
}
طلب ملخّص إنشاءي للمنطقة
إنّ ملخّصات المنطقة هي ملخّصات من إنشاء النموذج اللغوي الكبير تهدف إلى إنشاء المناطق المجاورة من مكان معيّن. يمكن أن تكون ملخصات المنطقة مهمة للمستخدمين الذين يتخذون قرارًا بشأن مكان ما.
على سبيل المثال، إذا كنت تريد حجز فندق في مدينة جديدة، وبينما يمكنك العثور على فندق يلبي متطلباتك، أنت تريد أيضًا معرفة المزيد حول المنطقة المحيطة بالفندق. فبدلاً من إلقاء نظرة على خريطة للمنطقة المحيطة، ثم الحاجة إلى البحث في كل مكان على الخريطة، يمكنك بدلاً من ذلك إنشاء ملخص لمنطقة الفندق.
تتوفّر ملخّصات عن المنطقة باستخدام تفاصيل المكان (جديد) والبحث النصي (جديد) والبحث عن قرب (ميزة جديدة).
لتضمين ملخص المنطقة في الرد، يجب تضمين قناع الحقل للطلب:
areaSummary(تفاصيل المكان)places.areaSummary(البحث النصي والبحث عن قرب).
يحتوي حقل areaSummary لمكان ما في الرد على مصفوفة تصل إلى أربعة contentBlocks.
يعتمد موضوع كل قطعة على نوع المكان:
بالنسبة إلى محطة شحن المركبات الكهربائية، التي تُعرف على أنّها مكان من النوع
electric_vehicle_charging_station، تشمل مجموعات المواضيع ما يلي:"overview"و"coffee"و"restaurant"و"store".إذا كان المكان من النوع الذي تحدّده فئة الإقامة وأنواع الأماكن المحدّدة
geocodeوpremise، تشمل عناصر الحظر المواضيع:"overview"و"activity"و"restaurant"و"store".
مثال على طلب الحصول على ملخّص المنطقة لمحطة شحن للمركبات الكهربائية
يعرض هذا المثال على طلب تفاصيل المكان ملخّص المنطقة لمحطة شحن معيّنة
للمركبات الكهربائية في ماونتن فيو، ويتم تحديدها من خلال رقم تعريف المكان
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
ويحتوي الرد على الحقل areaSummary، بما في ذلك صفيف contentBlocks:
يحدّد الحقل
topicنوع حظر المحتوى. بما أنّ المكان الوارد في هذا المثال هو محطة شحن للمركبات الكهربائية، فإن مجموعات المحتوى الأربعة هي"overview"و"coffee"و"restaurant"و"store".ويتضمّن الحقل
contentملخّصًا لهذا الموضوع، بما في ذلك رمز اللغة.تحدّد المصفوفة
referencesأسماء موارد الأماكن، على شكلplaces/PLACE_ID، وتُستخدم لتوفير محتوى لحظر المحتوى.
{
"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"
]
}
}
]
}
}
مثال على طلب لملخّص المنطقة لأحد الفنادق
يطلب هذا المثال على ميزة "البحث النصي" الفنادق في مدينة ماونتن فيو في كاليفورنيا:
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
ويحتوي الرد على الحقل areaSummary، بما في ذلك مصفوفة contentBlocks. الرد الخاص بالأماكن من نوع الفنادق يتضمّن مجموعات محتوى
للمواضيع "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"
]
}
}
]
}
},
...
]
}
طلب نتائج بحث سياقي
يحتوي الرد على طلب البحث النصي (جديد) على مصفوفة من الأماكن التي تطابق معايير سلسلة البحث الإدخال. يمكنك الآن طلب بيانات البحث السياقي في الردّ استنادًا إلى طلب البحث الذي أدخلته في واجهة برمجة التطبيقات.
لإتاحة الملخّصات السياقية، يتضمّن الردّ من
بحث نصي (جديد)
مصفوفة جديدة باسم contextualContents في المستوى نفسه الذي يتضمّن
مصفوفة places في الردّ:
{
"places": [],
"contextualContents":[]
}
يقع كل عنصر في صفيف contextualContents، من النوع
ContextualContent،
في موقع الصفيف المقابل كمكان في الصفيف places. وهذا يعني أنّ العنصر في contextualContents[0] يتجاوب مع المكان في places[0].
يحتوي كل عنصر صفيف على حقول الصفيفة التالية:
contextualContents.reviews: مصفوفة تضم ما يصل إلى ثلاث مراجعات.contextualContents.photos: مصفوفة مكوّنة من خمس صور كحد أقصى.contextualContents.justifications: مجموعة من التبريرات للمكان، بما في ذلك:reviewJustification: سلِّط الضوء على قسم من مراجعات المستخدمين قد يهمّ المستخدم النهائيbusinessAvailabilityAttributesJustification: تتضمن سمات النشاط التجاري الذي قد يهم المستخدم النهائي.
لتضمين نتائج البحث السياقي في الردّ، يمكنك تضمين
contextualContents في
قناع الحقل
من طلب البحث النصي (جديد):
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
يحتوي الرد على صفيف contextualContents لكل مكان في الرد:
{
"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
}
}
]
},
. . .
]
}
إرشادات التنفيذ لحالات استخدام السيارات
حفاظًا على سلامة السائق، تنصح Google بعرض ملخّصات الذكاء الاصطناعي التوليدي في وضع "الركن" لتجارب السيارات. في حال عرض ملخّصات في "وضع القيادة"، يجب أن تكون المعلومات الظاهرة على الشاشة بسيطة وواضحة وموجزة لضمان عودة انتباه السائق بسرعة إلى الطريق.
- ما لا يزيد عن 3 أسطر
- 120 حرفًا أو 24 كلمة أو أقل
- الحد الأدنى للحجم الأمامي: 24 بكسل مستقل الكثافة
تقع على عاتق المطوّر، خاصة في سياقات قطاع السيارات، مسؤولية عرض ملخّصات عن الذكاء الاصطناعي التوليدي بطرق آمنة ومتوافقة مع جميع القوانين واللوائح المحلية.
عمليات تحديد المصدر
عند عرض المراجعات والصور والملخّصات عن الذكاء الاصطناعي التوليدي في تطبيقك، بما في ذلك الملخّصات عن الأماكن والمناطق، عليك التأكّد أيضًا من عرض السمات المطلوبة.
عرض عمليات تحديد المصدر للملخّصات التوليدية
عند عرض ملخّصات عن الذكاء الاصطناعي التوليدي في تطبيقك، بما في ذلك ملخّصات عن الأماكن والمناطق، عليك أيضًا عرض معلومات المساهمين اللازمة. يوضّح هذا القسم كيفية عرض الإحالات استنادًا إلى طريقة عرض ملخّصات الذكاء الاصطناعي التوليدي في تطبيقك.
في جميع الحالات، يجب أن يستخدم الإسناد حالة الأحرف. يجب أن يتوافق الإسناد وشعار Google مع جميع معايير الألوان والأنماط والخطوط الطباعية. لمزيد من المعلومات حول هذه المعايير، راجع سياسات Places API (جديدة).
ملخّص للذكاء الاصطناعي التوليدي معروض في سياق بيانات أخرى على Google
في هذه الحالة، يمكن عرض مصدر الذكاء الاصطناعي التوليدي وحده فوق الملخّص أو تحته، بالاعتماد على إحالة المحتوى إلى "Google" في مكان آخر.
بالنسبة إلى تحديد المصدر، استخدِم النص "لخّصه الذكاء الاصطناعي" كما هو موضّح في هذه الصورة:
ملخّص للذكاء الاصطناعي التوليدي معروض بمعزل عن التطبيقات
عندما يظهر ملخّص الذكاء الاصطناعي التوليدي بمعزل عن أي محتوى آخر على "خرائط Google"، يجب أن يتضمّن كلاً من إسناد الذكاء الاصطناعي التوليدي وإسناده إلى Google مفصولاً بعلامة علامة. بالنسبة إلى ذِكر أسماء المساهمين، استخدِم النصّ "تمّ تلخيصه بواسطة الذكاء الاصطناعي" وشعار Google كما هو موضّح في هذه الصورة:
ملخّص حول الذكاء الاصطناعي التوليدي مكرّر في قائمة
عند تكرار نظرة عامة حول ملخّص مكان الذكاء الاصطناعي التوليدي في قائمة من الأماكن، حيث:
- يُنسب محتوى القائمة إلى Google
- الملخّصات المعروضة من إنشاء الذكاء الاصطناعي
- المحتوى متوفّر من Google.
يجب عرض معلومات تحديد المصدر أعلى القائمة أو أسفلها في سطر واحد. تتم محاذاة إحالة الذكاء الاصطناعي إلى اليسار وإحالة Google بالتوافق إلى اليمين:
إذا تمّ استخدام ملخّصات وصف أطول للذكاء الاصطناعي التوليدي في قائمة، يجب أن يتضمّن كل ملخّص نموذج تحديد المصدر بالذكاء الاصطناعي (AI) ("تم تلخيصه بواسطة الذكاء الاصطناعي" مع رمز/زر المعلومات).
عرض معلومات حول ملخّص الذكاء الاصطناعي التوليدي في مربّع حوار
إلى جانب ملخص الذكاء الاصطناعي التوليدي، يجب إتاحة مربّع حوار للمستخدمين النهائيين يعرض معلومات عن الملخّص ورابطًا للإبلاغ عن المشاكل. عند استخدام ملخّص وصفي للذكاء الاصطناعي التوليدي، يجب تضمين معلومات حول مصادر الملخّص، وتُسمّى references.
يمكنك تفعيل إمكانية الوصول إلى مربّع الحوار هذا من خلال تضمين رمز معلومات (كعنصر تفاعل) مع نموذج تحديد المصدر بالاستناد إلى الذكاء الاصطناعي (كما هو موضّح في الأمثلة أعلاه) وجعل منطقة ورمز الذكاء الاصطناعي تستجيب للضغط/النقرة.
بالنسبة إلى الملخصات التوليدية عن الأماكن، اعرض ما يلي:
| لمحة عامة | يتم إنشاء ملخّصات الأماكن استنادًا إلى الذكاء الاصطناعي من مراجعات Google وبيانات أخرى. |
| الإبلاغ عن مشكلة | لإبلاغ Google عن مشكلة في محتوى ملخّص، اتّبِع هذا الرابط. |
| المراجع | المراجعات المصدر |
مثلاً:
بالنسبة إلى ملخّصات المنطقة التوليدية، يمكنك عرض ما يلي:
| لمحة عامة | يتم إنشاء ملخّصات المنطقة المستندة إلى الذكاء الاصطناعي من مراجعات Google والبيانات المحلية. |
| الإبلاغ عن مشكلة | لإبلاغ Google عن مشكلة في محتوى ملخّص، اتّبِع هذا الرابط. |
