البحث في الأماكن

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

توضّح هذه الصفحة خيارات الطلب، بما في ذلك خيارات Pro، ومحتوى الردّ، وكيفية فوترة الطلبات. للاطّلاع على المخطط الكامل للأدوات، يُرجى مراجعة مرجع search_places.

خيارات الطلب

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

Option الوصف
text_query الحقل مطلوب. طلب البحث، مثل coffee shops near Golden Gate Park يجب أن يحتوي طلب البحث على معلومات كافية عن الموقع الجغرافي ليكون واضحًا، أو يجب أن يتضمّن الطلب location_bias.
location_bias دائرة (center وradius_meters اختياري، حتى 50,000 متر) لتوجيه النتائج نحوها إذا كان text_query يشير إلى موقع جغرافي صريح، يتم استخدام هذا الموقع بدلاً من ذلك.
language_code لغة الملخّص، مثل en أو ja. يتم ضبط اللغة تلقائيًا على الإنجليزية.
region_code رمز منطقة CLDR للمستخدم، على سبيل المثال US. يؤثر هذا الإعداد في أسماء الأماكن الخاصة بمنطقة معيّنة، ويمكن أن يؤثر في النتائج استنادًا إلى القانون الساري.
page_size الحد الأقصى لعدد الأماكن التي سيتم عرضها. القيمة التلقائية هي 5. القيم من 6 إلى 10 هي خيار Pro. وتؤدي القيم التي تزيد عن 10 إلى ظهور الخطأ INVALID_ARGUMENT. قد تعرض الخدمة عددًا أقل من الأماكن المطلوبة.
include_extended_details عندما تكون قيمة المَعلمة true، يتضمّن الملخّص تفاصيل المكان الموسّعة. هذا خيار احترافي. القيمة التلقائية هي false.

خيارات Pro

يحدّد خياران رمز التخزين التعريفي Pro. يتم تحصيل رسوم الطلب الذي يستخدم أيًا منهما أو كليهما ضمن رمز التخزين التعريفي Pro:

خيار Pro حالات الاستخدام
تم ضبط موقع include_extended_details في العنوان true يتطلّب طلب المستخدم تفاصيل موسّعة عن المكان، مثل إحصاءات من المراجعات أو أبرز عناصر القائمة أو الأجواء أو نصائح الزوّار.
‫page_size من 6 إلى 10 يريد المستخدم مقارنة أكثر من 5 أماكن.

أما الطلبات التي لا تستخدم أيًا من الخيارَين، بما في ذلك الطلبات التي تتضمّن page_size من 1 إلى 5، فتتم فوترتها ضمن رمز التخزين التعريفي Essentials.

تفاصيل المكان الموسّعة

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

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

تعتمد الإحصاءات في الملخّص على طلب البحث والبيانات المتاحة لكل مكان. لا يظهر كل نوع من الإحصاءات في كل ردّ.

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

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

مثال

يطلب الطلب التالي ما يصل إلى 8 أماكن مع تفاصيل موسّعة. ويتم تحصيل رسومها ضمن رمز التخزين التعريفي Pro:

{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      "text_query": "date night Italian restaurants in Chicago",
      "page_size": 8,
      "include_extended_details": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

بدون تفاصيل موسّعة، يصف الملخّص كل مكان في جملة أو جملتَين:

Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) A neighborhood trattoria known for handmade pasta and a long wine list.

With extended details, the summary adds what reviewers highlight and practical tips:

Example Trattoria [0] (4.6★ (1,250) · 123 W Example St · $$$) مطعم إيطالي صغير يوفّر أجواءً حميمية على ضوء الشموع، ويصفه المراجعون بأنّه رومانسي ولكنّه صاخب في عطلات نهاية الأسبوع. وتشمل الأطباق المميّزة تالياتيلي آل راغو وجبنة البوراتا والتيراميسو. يُنصح بالحجز مسبقًا، إذ قد يضطر الزبائن الذين يأتون بدون حجز إلى الانتظار لمدة تتراوح بين 30 و45 دقيقة مساء الجمعة والسبت، كما أنّ مواقف السيارات في الشارع محدودة.

الردّ

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

  • ‫summary: ملخّص بلغة طبيعية لنتائج البحث قد يحتوي على اقتباسات تستند إلى الصفر، مثل [0]، والتي يتم ربطها بالإدخالات في places.
  • ‫places[]: الأماكن المذكورة في الملخّص يتضمّن كل مكان ما يلي:
    • ‫place: اسم المورد الخاص بالمكان، بالتنسيق places/{id}
    • ‫id: رقم تعريف المكان يمكنك استخدامها مع واجهات برمجة التطبيقات الأخرى في "منصة خرائط Google"، على سبيل المثال لعرض المكان على خريطة.
    • ‫location: خط العرض وخط الطول للمكان
    • ‫googleMapsLinks: روابط إلى "خرائط Google" للمكان (placeUrl) والاتجاهات (directionsUrl) والمراجعات (reviewsUrl) والصور (photosUrl) وكتابة مراجعة (writeAReviewUrl)
    • ‫attribution: مصدر المعلومات الذي يجب عرضه مع المكان يُرجى الاطّلاع على متطلبات الإسناد.

يكون للردّ البنية نفسها لكل من رمزَي التخزين التعريفيَين. للاطّلاع على تفاصيل الحقول، يُرجى مراجعة مرجع search_places.

خيارات Pro خلال فترة التوفّر المحدود للجمهور العام

خلال فترة التوفّر العام المحدود، لا تتوفّر خيارات Pro إلا للمشاريع المدرَجة في القائمة المسموح بها في Pro. إذا لم يكن مشروعك مدرجًا في القائمة المسموح بها بعد، يتم تجاهل خيارات Pro بدلاً من رفضها:

  • يتم التعامل مع "include_extended_details" على أنّه "false".
  • يتم خفض قيم page_size التي تزيد عن 5، بما في ذلك القيم التي تزيد عن 10، إلى 5.

تتم فوترة الطلب ضمن رمز التخزين التعريفي لـ Essentials. لطلب الوصول، يُرجى الاطّلاع على خيارات Pro خلال فترة التوفّر العام المحدود.

الفوترة والحصص

كل طلب من search_places هو حدث واحد قابل للفوترة:

تبلغ حصة search_places 300 طلب بحث في الدقيقة لكل مشروع، وتتم مشاركتها من خلال كل من رمزَي التخزين التعريفيَين. لمعرفة الأسعار، يُرجى الاطّلاع على جدول الأسعار الرئيسي وجدول الأسعار في الهند.