أصبحت واجهة برمجة التطبيقات Places Aggregate API، المعروفة سابقًا باسم Places Insights API، متاحة للجميع الآن.
الأسئلة الشائعة حول واجهة برمجة التطبيقات Places Aggregate API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
هل هناك حدّ أقصى لعدد الطلبات التي يمكن إرسالها إلى واجهة برمجة التطبيقات؟
بالنسبة إلى Places Aggregate API، يبلغ الحدّ التلقائي لعدد الطلبات 1,200 طلب في الدقيقة.
ما الفرق بين included_primary_types وincluded_types في TypeFilter؟
-
included_primary_types: يتم استخدام هذه السمة لفلترة الأماكن التي تشكّل فيها الأنواع المحدّدة الفئة الرئيسية أو الأساسية. قد تتضمّن هذه الأماكن أيضًا أنواعًا ثانوية أخرى.
included_types: يفلتر هذا الخيار الأماكن التي تتضمّن الأنواع المحدّدة كأي من فئاتها، بغض النظر عمّا إذا كان النوع أساسيًا أو ثانويًا.
على سبيل المثال، سيؤدي البحث باستخدام included_primary_types الذي تم ضبطه على restaurant إلى عرض أماكن وظيفتها الأساسية هي تقديم الطعام، بينما سيؤدي البحث باستخدام included_types الذي تم ضبطه على restaurant إلى عرض أماكن تقدّم الطعام حتى إذا كانت لديها فئة أساسية أخرى، مثل museum مع cafe.
لمزيد من المعلومات، يُرجى الانتقال إلى أنواع الأماكن.
كيف يمكنني تحديد مساحة بحث مخصّصة ليست دائرية؟
يمكنك تحديد مساحة بحث مخصّصة باستخدام مضلّع. قدِّم قائمة بإحداثيات خطوط العرض والطول التي تحدّد رؤوس مضلّع واحد بترتيب عكس اتجاه عقارب الساعة. يجب أن تتطابق الإحداثيات الأولى والأخيرة لإغلاق المضلّع.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Places Aggregate API FAQ\n\nIs there a rate limit on the API?\n---------------------------------\n\nFor Places Aggregate API, there is a default rate limit of\n1,200 queries per minute.\n\nWhat is the difference between 'included_primary_types' and 'included_types' in the TypeFilter?\n-----------------------------------------------------------------------------------------------\n\n- `included_primary_types`: Filters for places where the specified types are their main or primary category. These places might also have other secondary types.\n- `included_types`: Filters for places that have the specified types as any of their categories, regardless of whether it's the primary or secondary type.\n\nFor example, a search using `included_primary_types` set to `restaurant` would\nreturn places whose primary function is to serve food, whereas `included_types`\nset to `restaurant` would return places that serve food even if they have\nanother primary category, such as a `museum` with a `cafe`.\n\nFor further reading, visit [Place Types](/maps/documentation/places/web-service/place-types).\n\nHow do I define a custom search area that isn't a circle?\n---------------------------------------------------------\n\nYou can define a custom search area using a polygon. Provide a list of latitude\nand longitude coordinates that define the vertices of a single polygon in a\ncounter-clockwise order. The first and last coordinates *must* be the same to\nclose the polygon."]]
