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

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

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

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

  • "تبعد مسافة تتراوح بين دقيقتين و4 دقائق سيرًا على الأقدام، وتتوفر العديد من خيارات تناول الطعام والتسوق، بما في ذلك مطعم Chef Chu's وGen Korea للشواء وAmber India وPacific Catch والعديد من متاجر البقالة، مثل Walmart و Whole Foods Market وTrader Joe's."

  • "على بُعد من دقيقة إلى 5 دقائق سيرًا على الأقدام، تتوفر العديد من خيارات تناول الطعام والتسوّق، بما في ذلك "مطبخ خاو كانغ تاي" و"روجر ديلي آند دونتس" و"لا كوستينيا". بالنسبة إلى السوشي، يُعدّ جوي سوشي خيارًا جيدًا. بالنسبة للبقالة، تقدم Dollar Tree مجموعة متنوعة من المنتجات بأسعار مخفضة".

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

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

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

ملخّصات عن الأماكن من إنشاء الذكاء الاصطناعي التوليدي

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

توفِّر واجهة Places API (الجديدة) نوعَين من ملخّصات الأماكن من إنشاء الذكاء الاصطناعي التوليدي:

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

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

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

ملخّصات عن المناطق استنادًا إلى الذكاء الاصطناعي التوليدي

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تفعيل إمكانات نماذج 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: يتضمّن هذا القسم مجموعة من خمس مراجعات كحد أقصى تستخدم لتقديم محتوى ملخّص الوصف. إذا لم يكن هناك ملخص للوصف، فتكون هذه الصفيفة فارغة.

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

يعرض هذا المثال "البحث النصي" ملخّص 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 مع جميع معايير الألوان والأنماط والخطوط الطباعية. لمزيد من المعلومات حول هذه المعايير، يمكنك الاطّلاع على سياسات واجهة برمجة تطبيقات الأماكن (جديد).

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

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

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

بالنسبة إلى نَسب العمل، استخدِم النص الذي لخّصه الذكاء الاصطناعي (AI).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مثلاً:

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

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

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

إحالة ملخص منطقة العرض