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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يجب تفعيل Places API (جديدة) لاستخدام إمكانات نماذج Gemini للأماكن 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 بفاصل. للإسناد، استخدم النص "ملخص من إنشاء الذكاء الاصطناعي (AI) وشعار Google كما هو موضح في هذه الصورة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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