تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إمكانات نموذج Gemini في Places API

إمكانات نموذج Gemini في Places API (ميزة جديدة) توفّر إمكانية استخدام النماذج اللغوية الكبيرة في واجهة برمجة التطبيقات Places API حتى تتمكّن من عرض البيانات المرتبطة بمكان معيّن (ساعات العمل والمراجعات والصور) بالإضافة إلى البيانات التي تقدّمها النماذج اللغوية الكبيرة. تحتوي هذه البيانات التوليدية على بيانات مجمّعة وملخّصة من النماذج اللغوية الكبيرة لتحسين البيانات المرتبطة بمكان معيّن.

على سبيل المثال، يؤدي إجراء عملية بحث نصي (جديد) عادي عن "محطات شحن المركبات الكهربائية" إلى عرض قائمة بالأماكن التي تتوفّر فيها محطات شحن المركبات الكهربائية. يكون هذا نوع الردّ مناسبًا إذا كنت تبحث فقط عن أقرب محطة شحن للمركبات الكهربائية أو أقرب محطة متوافقة مع مركبتك.

ولكن قد تحتاج أيضًا إلى التعرّف بشكل أفضل على المنطقة المحيطة بمحطة الشحن، خاصةً إذا كنت ستنتظر لمدة ساعة أو أكثر بينما يتم شحن مركبتك. عند استخدام إمكانات نموذج Gemini لإجراء عملية البحث نفسها، يمكن أن يحتوي الردّ على أوصاف ديناميكية وتوليدية لكل مكان في الردّ، بما في ذلك معلومات عن المنطقة المحيطة بمحطة شحن المركبات الكهربائية:

"في غضون دقيقتين إلى 4 دقائق سيرًا على الأقدام، تتوفّر عدة خيارات للتسوّق وتناول الطعام، بما في ذلك مطعم Chef Chu's وGen Korean BBQ House وAmber India وPacific Catch والعديد من متاجر البقالة مثل Walmart وWhole Foods Market و Trader Joe's".
"في غضون مدة تتراوح بين دقيقة واحدة و5 دقائق سيرًا على الأقدام، تتوفّر عدة خيارات للتسوّق وتناول الطعام، بما في ذلك مطعم Khao Kang Thai Kitchen ومطعم Roger's Deli & Donuts ومطعم La Costeña. بالنسبة إلى السوشي، يُعدّ Joy Sushi خيارًا جيدًا. بالنسبة إلى البقالة، تقدّم Dollar Tree مجموعة متنوعة من المنتجات بأسعار مخفَّضة".

يُحسِّن هذا المحتوى التوليدي من النماذج اللغوية الكبيرة الردّ ويقدّم معلومات إضافية لمساعدة المستخدمين في اتخاذ قرار مدروس.

ميزات جديدة مستندة إلى الذكاء الاصطناعي تمت إضافتها إلى Places API (جديدة)

تضيف هذه الإمكانات البيانات التالية إلى ردّ Places API (الإصدار الجديد):

ملخّصات الأماكن التوليدية المرتبطة بأحد الأماكن تتوفّر ملخّصات الأماكن في تفاصيل الأماكن (ميزة جديدة) والبحث النصي (ميزة جديدة) والبحث في الأماكن القريبة (ميزة جديدة).
ملخّصات المناطق التوليدية المرتبطة بمنطقة معيّنة حول مكان تتوفّر ملخّصات المناطق في تفاصيل الأماكن (ميزة جديدة) والبحث النصي (ميزة جديدة) والبحث في الأماكن القريبة (ميزة جديدة).
تتوفّر نتائج البحث السياقي من خلال البحث النصي (جديد) وتحتوي على بيانات استنادًا إلى سلسلة البحث التي تم تمريرها في الطلب، بدلاً من البيانات المرتبطة مباشرةً بمكان معيّن. تساعد هذه البيانات في فهم كيفية تحديد "بحث النصّ (جديد)" للردّ.

ملخّصات الأماكن التوليدية

تكون ملخّصات الأماكن التوليدية خاصة بمعرّف مكان معيّن. تجميع ملخّصات الأماكن لأنواع مختلفة من البيانات في ملخّص واحد للمكان

توفّر ‫Places API (الإصدار الجديد) نوعَين من ملخّصات الأماكن التوليدية:

الملخّصات الإجمالية: نظرة عامة موجزة عن مكان ما، تبلغ في المتوسّط نحو 100 حرف، يمكن أن تساعد المستخدمين في الحصول على لمحة عن المكان.
ملخّصات الوصف: ملخّصات أطول للمكان، تبلغ في المتوسّط حوالي 400 حرف، تقدّم نظرة عامة تفصيلية حول أهم سمات المكان

تتوفّر حاليًا ملخّصات الأماكن لأنواع الأماكن المعروضة في أنواع المتوافقة للفئات التالية: الثقافة والترفيه والأنشطة الترفيهية والطعام والشراب والتسوّق والرياضة.

ملخّصات المناطق التوليدية

تُنشئ ميزة "المعالجة اللغوية الكبيرة" ملخصات إبداعية للمنطقة المجاورة حول مكان معيّن. قد يحتوي ملخّص المنطقة لأحد الأماكن على جميع المعلومات اللازمة ليتمكّن المستخدم من اتّخاذ قرار، بدون أن يحتاج إلى تقديم طلبات إضافية للتوغّل في تفاصيل المنطقة.

بالإضافة إلى وصف المنطقة، يحتوي الردّ أيضًا على قائمة بأرقام تعريف الأماكن المُشار إليها في الوصف، وقائمة بالأماكن المرتَّبة حسب أنواع المحتوى المختلفة. على سبيل المثال، يحتوي نوع المحتوى على قائمة بالأماكن المرتبطة بالأنشطة في المنطقة، ويحتوي نوع آخر على قائمة بالمطاعم في المنطقة.

تتوفّر ملخّصات المناطق حاليًا لأنواع الأماكن المعروضة في الأنواع المتوافقة لفئة أماكن الإقامة، بالإضافة إلى أنواع الأماكن المحدّدة electric_vehicle_charging_station وgeocode وpremise.

إنشاء ملخّصات الأماكن والمناطق

تنشئ Google بشكلٍ متكرّر ملخّصات الأماكن التوليدية وملخّصات المناطق التوليدية بدون اتصال بالإنترنت. من خلال إنشاء هذه الملخّصات بلا إنترنت، يمكنك الاستفادة من المحتوى المستنِد إلى Gemini مع مواصلة تحقيق الأداء نفسه الذي تتوقّعه من Places API (الإصدار الجديد).

تُنشئ Google هذه الملخّصات بشكل متكرّر للتأكّد من أنّها حديثة استنادًا إلى أحدث المعلومات المتاحة. وهذا يعني أنّك ستعرض أحدث البيانات في خدمتك عند طلب البيانات من واجهة برمجة التطبيقات.

نتائج البحث السياقي

تعرِض ميزة "البحث النصي" (جديد) معلومات عن مجموعة من الأماكن استنادًا إلى سلسلة، مثلاً "بيتزا في القاهرة" أو "متاجر أحذية بالقرب من الإسكندرية". يحتوي ردّ البحث عن النص (جديد) على قائمة بالمواقع التي تتطابق مع سلسلة النصوص وأي انحياز في الموقع الجغرافي تم ضبطه في الطلب.

عند إضافة نتائج بحث سياقية إلى الردّ، سيتضمّن الردّ الآن مراجعات وصورًا ومبرّرات تساعد المستخدمين في الإجابة عن الأسئلة التالية:

لماذا يظهر هذا المكان في النتائج؟
لماذا يجب اختيار هذا المكان؟

على سبيل المثال، قدّمت طلبًا اليوم إلى "تفاصيل المكان" (ميزة جديدة) أو "البحث النصي" (ميزة جديدة) أو "البحث عن الأماكن المجاورة" (ميزة جديدة) يتضمّن مكانًا معيّنًا في الاستجابة. إنّ بيانات الاستجابة للمكان هي نفسها في جميع الطلبات الثلاثة لأنّ البيانات المعروضة مرتبطة بهذا المكان.

ومع ذلك، بالنسبة إلى "البحث النصي (جديد)" باستخدام الإمكانات الجديدة، يمكن أن يحتوي الردّ على بيانات ناتجة من سلسلة طلب البحث التي تم إدخالها. وهذا يعني أنّ نتائج البحث حسب السياق فريدة لسلسلة طلب البحث. على سبيل المثال، يمكنك إرسال طلب بحث نصي (جديد) باستخدام سلسلة الاستعلام التالية:

"مطعم نباتي يقدم طعامًا حارًا في ماونتن فيو، كاليفورنيا"

بعد ذلك، يمكنك ترك جميع مَعلمات الإدخال كما هي وتغيير سلسلة طلب البحث فقط إلى:

"مطعم نباتي يقدم طعامًا حارًا في ماونتن فيو، كاليفورنيا"

بالنسبة إلى مطعم يظهر في كلا الردّين، تكون بيانات الردّ عن المكان متطابقة لأنّ هذه البيانات مرتبطة بالمكان نفسه. أمّا نتائج البحث السياقي، فهي فريدة لطلب البحث لأنّها مشتقة من سلسلة طلب البحث. يمكنك بعد ذلك عرض المراجعات والصور والكلمات المبررة من نتائج البحث السياقي للمستخدمين لمساعدتهم في تحديد المكان الأنسب لطلب البحث.

تفعيل إمكانات نموذج Gemini في Places API (ميزة جديدة)

يجب تفعيل Places API (الإصدار الجديد) لاستخدام إمكانات نموذج Gemini في Places API (الإصدار الجديد). لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد مشروعك على Google Cloud.

القيود المفروضة على الإصدار التجريبي

لا يتيح هذا الإصدار سوى ملخّصات الأماكن والمناطق للأماكن في الولايات المتحدة باللغة الإنجليزية فقط.

ما هو Gemini؟

للتعرّف على نموذج Gemini، يمكنك الاطّلاع على أسئلة Gemini الشائعة.

طلب ملخّص مكان تجميعي

ملخّصات الأماكن هي ملخّصات إبداعية أنشأها نموذج اللغة الكبيرة لمكان معيّن. تضيف Places API (الإصدار الجديد) نوعَين من الملخصات إلى الردّ:

نظرة عامة: ملخّصات إبداعية تشبه الملخّص الثابت لمراجعة تحريرية المرتبط بمكان معيّن تتميز الملخّصات القصيرة التوليدية، التي تبلغ في المتوسّط حوالي 100 حرف، بعدة مزايا:
- لا تتوفّر ملخّصات تحريرية للعديد من الأماكن، لذا تُعدّ هذه الملخّصات بديلاً عن المعلومات المتاحة عن المكان.
- يتم إنشاؤها من نموذج اللغة الكبيرة، لذا ليس على مالك المكان الحفاظ عليها.
يتم استخراج الملخصات التوليدية للوصف من عدة مصادر، بما في ذلك المراجعات من "خرائط Google". يتكوّن الوصف من 400 حرف تقريبًا في المتوسط، ويتضمّن قائمة بالمراجعات المستخدَمة لإنشاء الوصف الطويل.

لإنشاء ملخّصات للوصف يدويًا، يجب أن يجمع الشخص البيانات من عدة مواقع جغرافية، ثم ينشئ المحتوى يدويًا ويحافظ عليه. تُنشئ إمكانات نموذج Gemini في Places API (الميزات الجديدة) هذه الملخصات من النماذج اللغوية الكبيرة (LLM) للحفاظ على نطاق المحتوى الذي تم إنشاؤه وحداثته.

تتوفّر ملخّصات الأماكن في تفاصيل الأماكن (ميزة جديدة) والبحث النصي (ميزة جديدة) والبحث في الأماكن القريبة (ميزة جديدة). لتضمين ملخّص المكان في الردّ، أدرِج الحقل التالي في قناع الحقل للطلب:

تفاصيل المكان: generativeSummary
البحث النصي والبحث عن الأماكن القريبة: places.generativeSummary

يحتوي الحقل generativeSummary على الحقول التالية:

generativeSummary.overview: ملخّص النظرة العامة على المحتوى التوليدي
generativeSummary.description: ملخّص الوصف التوليدي
‫generativeSummary.references: مصفوفة تضم ما يصل إلى خمس مراجعات تُستخدَم لتوفير محتوى لملخّص الوصف إذا لم يكن هناك وصف ملخّص، تكون هذه المصفوفة فارغة.
overviewFlagContentUri: رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في الملخّص الإجمالي.
descriptionFlagContentUri: رابط يمكن للمستخدمين من خلاله الإبلاغ عن مشكلة في ملخّص الوصف

مثال على طلب النظر في النظرة العامة والملخّص الوصفي

يستخدم هذا المثال маскة حقل places.generativeSummary لعرض العنصر generativeSummary بالكامل، بما في ذلك حقول generativeSummary.overview وgenerativeSummary.description وgenerativeSummary.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

يكون الردّ على النحو التالي:

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

مثال على طلب ملخّص نظري

يعرض مثال "البحث النصي" هذا ملخص 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"
        }
      }
    },
  . . .
}

طلب ملخّص عن منطقة إبداعية

ملخّصات المناطق هي ملخّصات إبداعية أنشأها نموذج اللغة الكبيرة للمنطقة المجاورة لمكان معيّن. يمكن أن تكون ملخّصات المناطق مهمة للمستخدمين الذين يتّخذون قرارًا بشأن مكان ما.

على سبيل المثال، إذا كنت تبحث عن حجز فندق في مدينة جديدة، يمكنك العثور على فندق يستوفي متطلباتك، ولكنك تريد أيضًا معرفة المزيد عن المنطقة المحيطة بالفندق. بدلاً من الاطّلاع على خريطة للمنطقة المجاورة، ثمّ البحث عن كل مكان على الخريطة، يمكنك بدلاً من ذلك إنشاء ملخّص للمنطقة للفندق.

تتوفّر ملخّصات المناطق في تفاصيل الأماكن (ميزة جديدة) والبحث النصي (ميزة جديدة) والبحث في الأماكن القريبة (ميزة جديدة).

لتضمين ملخّص المنطقة في الردّ، يجب تضمين ما يلي في قناع الحقل للطلب:

areaSummary (تفاصيل المكان)
places.areaSummary (البحث النصي و"بحث في الجوار")

يحتوي الحقل areaSummary لمكان في الاستجابة على الحقل flagContentUri الذي يمكنك استخدامه للإبلاغ عن محتوى غير ملائم كي تتمكّن Google من إزالته. ويحتوي أيضًا على صفيف يصل إلى أربعة contentBlocks. يستند موضوع كل قسم إلى نوع المكان:

بالنسبة إلى محطة شحن المركبات الكهربائية، التي يتم تعريفها كمكان من النوع electric_vehicle_charging_station، تتضمّن مجموعات المواضيع ما يلي: "overview" و "coffee" و"restaurant" و"store".
بالنسبة إلى مكان له نوع محدّد من قِبل فئة أماكن الإقامة وأنواع الأماكن المحدّدة geocode وpremise، تتضمّن ملفّات topics: "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"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

مثال على طلب للحصول على ملخّص المنطقة لفندق

في ما يلي مثال على طلب البحث النصي يبحث عن فنادق في ماونتن فيو، كاليفورنيا:

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"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

طلب نتائج البحث السياقي

يحتوي الردّ على طلب البحث النصي (جديد) على صفيف من الأماكن التي تتطابق مع معايير سلسلة البحث المُدخلة. يمكنك الآن طلب بيانات البحث السياقي في الاستجابة استنادًا إلى طلب البحث الذي أدخلته إلى واجهة برمجة التطبيقات.

لتقديم ملخّصات سياقية، يحتوي الردّ من البحث النصي (جديد) على صفيف جديد باسم 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": "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
          }
        }
      ]
    },
    . . .
  ]
}

إرشادات التنفيذ لحالات الاستخدام في السيارات

للحفاظ على أمان السائق، تنصح Google بعرض ملخّصات الذكاء الاصطناعي التوليدي في ميزة "وضع الركن" لتجارب السيارات. في حال عرض الملخصات في وضع القيادة، يجب أن تكون المعلومات المعروضة على الشاشة بسيطة وواضحة وموجزة لضمان عودة انتباه السائق بسرعة إلى الطريق.

3 أسطر كحدّ أقصى
120 حرفًا أو 24 كلمة أو أقل
الحد الأدنى للحجم الأمامي هو 24dp

تقع على عاتق المطوّر مسؤولية عرض ملخّصات الذكاء الاصطناعي التوليدي بطرق آمنة وممتثلة لجميع القوانين واللوائح المحلية، خاصةً في السياقات المتعلّقة بالسيارات.

عمليات تحديد المصدر

عند عرض المراجعات والصور وملخّصات الذكاء الاصطناعي التوليدي في تطبيقك، بما في ذلك ملخّصات الأماكن والمناطق، يجب التأكّد من عرض الإسنادات المطلوبة أيضًا.

عرض الإسنادات للملخّصات التوليدية

عند عرض ملخّصات الذكاء الاصطناعي التوليدي في تطبيقك، بما في ذلك ملخّصات الأماكن والمناطق، يجب أيضًا عرض الإسنادات اللازمة. يوضّح هذا القسم كيفية عرض الإسنادات استنادًا إلى كيفية عرض ملخّصات الذكاء الاصطناعي التوليدي في تطبيقك.

في جميع الحالات، يجب استخدام حالة أحرف الجملة في الإسناد. يجب أن يتوافق كلّ من الشعار وعلامة تحديد المصدر مع جميع معايير الألوان والأسلوب ونوع الخط. لمزيد من المعلومات عن هذه المعايير، يُرجى الاطّلاع على السياسات المتعلّقة بواجهة برمجة التطبيقات Places API (الإصدار الجديد).

ملخّص الذكاء الاصطناعي التوليدي المعروض في سياق بيانات Google الأخرى

في هذه الحالة، يمكن عرض مصدر الذكاء الاصطناعي التوليدي وحده أعلى الملخص أو أسفله، مع الاعتماد على مصدر Google للمحتوى في مكان آخر.

بالنسبة إلى الإسناد، استخدِم النص "ملخّص بواسطة الذكاء الاصطناعي" كما هو موضّح في هذه الصورة:

بالنسبة إلى الإسناد، استخدِم النص "ملخّص من خلال الذكاء الاصطناعي".

ملخّص الذكاء الاصطناعي التوليدي المعروض بشكل منفصل

عندما يظهر ملخّص الذكاء الاصطناعي التوليدي بشكل منفصل عن أي محتوى آخر من "خرائط Google"، يجب أن يتضمّن كلاً من مصدر الذكاء الاصطناعي التوليدي ومصدر Google مفصولَين بفاصل. بالنسبة إلى الإسناد، استخدِم النص "ملخّص بواسطة الذكاء الاصطناعي" وشعار Google كما هو موضّح في هذه الصورة:

بالنسبة إلى الملخّص المعروض بشكل منفصل، يجب تضمين مصدر الذكاء الاصطناعي التوليدي
ومصدر Google مفصولَين بفاصل.

ملخّص الذكاء الاصطناعي التوليدي المتكرّر في قائمة

عند تكرار نظرة عامة على ملخّص الأماكن المستنِد إلى الذكاء الاصطناعي التوليدي في قائمة بالأماكن، حيث:

أن يكون محتوى القائمة منسوبًا إلى Google
الملخّصات المعروضة من إنشاء الذكاء الاصطناعي
المحتوى متوفّر من Google

يجب عرض الإسناد أعلى القائمة أو أسفلها في سطر واحد. تكون الإحالة إلى الذكاء الاصطناعي محاذية لليسار، وتكون الإحالة إلى Google محاذاة لليمين:

بالنسبة إلى القائمة، يجب عرض مصدرها فوقها أو تحتها في سطر واحد.

في حال استخدام ملخّصات أوصاف أطول من إنشاء الذكاء الاصطناعي التوليدي في قائمة، يجب أن يتضمّن كل ملخّص مصدرًا باستخدام الذكاء الاصطناعي (باستخدام العبارة "ملخّص من إنشاء الذكاء الاصطناعي" مع رمز/زرّ المعلومات).

عرض معلومات عن ملخّص الذكاء الاصطناعي التوليدي في مربّع حوار

إلى جانب ملخّص الذكاء الاصطناعي التوليدي، يجب توفير مربّع حوار للمستخدِمين النهائيين يعرض معلومات عن الملخّص، ورابط للإبلاغ عن المشاكل باستخدام المعرّف الفريد للملخّص الوارد في الحقل flagContentUri. عند استخدام ملخّص وصف من إنشاء الذكاء الاصطناعي التوليدي، يجب تضمين معلومات عن مراجع الملخّص.

يمكنك تفعيل الوصول إلى مربّع الحوار هذا من خلال تضمين رمز معلومات (كعنصر تفاعلي ) مع تحديد المصدر بالاستناد إلى الذكاء الاصطناعي (كما هو موضّح في المثالين أعلاه)، وجعل منطقة تحديد المصدر بالاستناد إلى الذكاء الاصطناعي والرمز يستجيبان للضغط/النقر.

بالنسبة إلى ملخّصات الأماكن التوليدية، يجب عرض ما يلي:

لمحة	يتم إنشاء ملخّصات الأماكن باستخدام الذكاء الاصطناعي من مراجعات Google وغيرها من البيانات.
الإبلاغ عن مشكلة	للإبلاغ عن مشكلة إلى Google بشأن محتوى ملخّص، استخدِم الرابط الوارد في حقل `flagContentUri`.
المراجع	مراجعات المصدر

على سبيل المثال:

عرض معلومات عن ملخّص الذكاء الاصطناعي التوليدي في مربّع حوار

بالنسبة إلى ملخّصات المناطق التوليدية، يجب عرض ما يلي:

لمحة	يتم إنشاء ملخّصات المناطق باستخدام الذكاء الاصطناعي من مراجعات Google والبيانات المحلية.
الإبلاغ عن مشكلة	للإبلاغ عن مشكلة إلى Google بشأن محتوى ملخّص، استخدِم الرابط الوارد في حقل `flagContentUri`.

عرض مصدر ملخّص المنطقة