الأسئلة الشائعة حول واجهة برمجة التطبيقات 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.
لمزيد من المعلومات، يُرجى الانتقال إلى أنواع الأماكن.
كيف يمكنني تحديد مساحة بحث مخصّصة ليست دائرية؟
يمكنك تحديد مساحة بحث مخصّصة باستخدام مضلّع. قدِّم قائمة بإحداثيات خطوط العرض والطول التي تحدّد رؤوس مضلّع واحد بترتيب عكس اتجاه عقارب الساعة. يجب أن تتطابق الإحداثيات الأولى والأخيرة لإغلاق المضلّع.
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
