مَعلمات الفلترة

يمكنك تطبيق الفلاتر على دوال عدد الأماكن باستخدام المَعلمات الموضّحة في الجدول أدناه. يُرجى العِلم أنّ المَعلمات المطلوبة تختلف لكل دالة:

• PLACES_COUNT: يتطلب geography
• PLACES_COUNT_PER_TYPE_V2: يتطلّب geography وtype
• PLACES_COUNT_V2: يتطلب geographies
• PLACES_COUNT_PER_H3: يتطلّب geography وh3_resolution
• PLACES_COUNT_CHANGE: يتطلّب month1 وmonth2

اسم الفلتر وقيمته حسّاسان لحالة الأحرف. يجب تحديدها تمامًا كما تظهر في الجدول. وإلا، فسيُرجع الاستعلام خطأ وسيطة غير صالح.

اسم الفلتر	الوصف	النوع	القيم المسموح بها
geography	لتطبيقات "PLACES_COUNT" وPLACES_COUNT_PER_TYPE وPLACES_COUNT_PER_H3 تحدّد هذه السمة منطقة للبحث. يتوافق أي نوع من GEOGRAPHY، مثل Point وLineString وPolygon. يمكنك استخدام المَعلمة geography مع geography_radius لإضافة مخزن مؤقت إلى منطقة البحث. يتم فرض حد أدنى لمساحة البحث يبلغ 40.0 متر في 40.0 متر (1600 متر^2). إذا حدّدت منطقة بحث أقل من هذا الحدّ، ستعرض الدالة خطأ وسيطة غير صالحة.	GEOGRAPHY	أي نوع من GEOGRAPHY
geographies	لـ "PLACES_COUNT_PER_GEO" فقط تحدّد هذه السمة قائمة بالمناطق التي يتم البحث فيها. يتوافق أي نوع من GEOGRAPHY، مثل Point وLineString وPolygon. يمكنك استخدام المَعلمة geographies مع geography_radius لإضافة مخزن مؤقت إلى منطقة البحث. تتم إضافة النطاق الاحتياطي إلى جميع المناطق الجغرافية المحدّدة. يتم فرض حد أدنى لمساحة البحث يبلغ 40.0 متر في 40.0 متر (1600 متر^2). إذا حدّدت منطقة بحث أقل من هذا الحدّ، ستعرض الدالة خطأ وسيطة غير صالحة.	ARRAY<GEOGRAPHY>	أي نوع من GEOGRAPHY
geography_radius	تضيف هذه الدالة نطاقًا جغرافيًا أو مخزنًا مؤقتًا، بالأمتار، إلى الموقع الجغرافي المحدّد. القيمة التلقائية هي 0. يجب أن تحدّد القيمة المحدّدة حدًا أدنى لمساحة البحث يبلغ 40.0 متر في 40.0 متر (1600 متر^2). على سبيل المثال، بالنسبة إلى منطقة جغرافية تبلغ مساحتها Point، يكون الحدّ الأدنى لنصف القطر هو 23 مترًا.	INT64	الحد الأدنى هو 0.
h3_resolution	لـ "PLACES_COUNT_PER_H3" فقط دقة H3 المستخدَمة لتجميع عدد الأماكن في خلايا H3.	INT64	بين 0 و11.
types	يحدّد أنواع الأماكن التي يجب أخذها في الاعتبار. يحتوي كل مكان على مجموعة من أنواع الأماكن، مثل "restaurant" و"cafe". إذا لم يتم تحديد أي أنواع، يتم أخذ جميع أنواع الأماكن في الاعتبار في النتيجة.	ARRAY<STRING>	للاطّلاع على القائمة الكاملة للقيم المحتملة، يُرجى مراجعة أنواع الأماكن. مثال: ["restaurant", "cafe", "bar"]
primary_type	تحدّد هذه السمة الأنواع الأساسية التي يجب أخذها في الاعتبار. يمكن أن يكون للمكان نوع أساسي واحد فقط، وهو النوع الذي يصف الموقع الجغرافي على أفضل وجه. في حال عدم تحديد أي أنواع أساسية، يتم أخذ جميع الأنواع الأساسية للأماكن في الاعتبار في النتيجة.	ARRAY<STRING>	للاطّلاع على القائمة الكاملة للقيم المحتملة، يُرجى مراجعة أنواع الأماكن. مثال: ["restaurant", "cafe", "bar"]
brand_ids	بالنسبة إلى PLACES_COUNT_PER_H3 وPLACES_COUNT_V2 وPLACES_COUNT_PER_TYPE_V2 فقط تحدّد معرّفات العلامات التجارية المطلوب أخذها في الاعتبار. يمكن ربط كل مكان بمعرّفات علامات تجارية. إذا لم يتم تحديد أي معرّفات علامات تجارية، يتم أخذ جميع العلامات التجارية (والأماكن غير المرتبطة بعلامة تجارية) في الاعتبار في النتيجة. ملاحظة: تتوفّر بيانات العلامات التجارية في بلدان معيّنة فقط. في الوقت الحالي: الولايات المتحدة (US) وكندا (CA) والمملكة المتحدة (GB) وأستراليا (AU).	ARRAY<STRING>	مصفوفة من معرّفات العلامات التجارية لمزيد من المعلومات عن بيانات العلامات التجارية، يُرجى الاطّلاع على مقالة كتابة طلب بحث باستخدام بيانات العلامات التجارية. مثال: ["brand_001", "brand_002"]
min_rating	تحدّد هذه السمة الحدّ الأدنى لتقييم المكان الذي يجب أخذه في الاعتبار. يستند تقييم المكان إلى مراجعات المستخدمين له، ويتراوح بين 1.0 و5.0 إذا حدّدت تقييمًا خارج هذا النطاق، ستعرض الدالة خطأ وسيطة غير صالحة.	FLOAT	بين 1.0 و5.0
max_rating	يحدّد الحد الأقصى لتقييم المكان المطلوب أخذه في الاعتبار. يستند تقييم المكان إلى مراجعات المستخدمين له، ويتراوح بين 1.0 و5.0 إذا حدّدت تقييمًا خارج هذا النطاق، ستعرض الدالة خطأ وسيطة غير صالحة.	FLOAT	بين 1.0 و5.0
min_user_rating_count	يحدّد هذا الإعداد الحدّ الأدنى لعدد تقييمات المستخدمين التي يجب أخذها في الاعتبار. عدد تقييمات المستخدمين هو إجمالي عدد المراجعات التي حصل عليها مكان معيّن. الحد الأدنى للقيمة هو 0. إذا حدّدت قيمة أقل من 0، ستعرض الدالة خطأ وسيطة غير صالحة.	INT64	الحد الأدنى للقيمة هو 0.
max_user_rating_count	تحدّد هذه السياسة الحدّ الأقصى لعدد تقييمات المستخدمين التي يجب أخذها في الاعتبار. عدد تقييمات المستخدمين هو إجمالي عدد المراجعات التي حصل عليها مكان معيّن. الحد الأدنى للقيمة هو 0. إذا حدّدت قيمة أقل من 0، ستعرض الدالة خطأ وسيطة غير صالحة.	INT64	الحد الأدنى للقيمة هو 0.
price_level	تحدّد مستويات الأسعار التي يجب أخذها في الاعتبار. ويمكنك تحديد مستويات أسعار متعددة.	ARRAY<STRING>	القيم المسموح بها: "PRICE_LEVEL_FREE" "PRICE_LEVEL_INEXPENSIVE" "PRICE_LEVEL_MODERATE" "PRICE_LEVEL_EXPENSIVE" "PRICE_LEVEL_VERY_EXPENSIVE" مثال: ["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]
business_status	تحدّد حالة النشاط التجاري التي يجب أخذها في الاعتبار. يمكنك تحديد حالات متعددة للمؤسسة.	ARRAY<STRING>	القيم المسموح بها: "OPERATIONAL" "CLOSED_TEMPORARILY" "CLOSED_PERMANENTLY" "FUTURE_OPENING" مثال: ["OPERATIONAL","CLOSED_TEMPORARILY"]
takeout	يتم البحث عن الأماكن التي تقدّم مأكولات سفرية.	BOOLEAN	‫TRUE، FALSE
delivery	يتم البحث عن الأماكن التي توفّر خدمة التوصيل.	BOOLEAN	‫TRUE، FALSE
dine_in	يتم البحث عن الأماكن التي تتيح الجلوس في المطعم.	BOOLEAN	‫TRUE، FALSE
curbside_pickup	يتم عرض الأماكن التي توفّر خدمة الاستلام من السيارة.	BOOLEAN	‫TRUE، FALSE
reservable	ابحث عن الأماكن التي يمكن حجزها.	BOOLEAN	‫TRUE، FALSE
outdoor_seating	يتم أخذ الأماكن التي توفّر مقاعد خارجية في الاعتبار.	BOOLEAN	‫TRUE، FALSE
live_music	يأخذ في الاعتبار الأماكن التي تقدّم عروض موسيقى حية.	BOOLEAN	‫TRUE، FALSE
allows_dogs	ابحث عن أماكن تسمح باصطحاب الكلاب.	BOOLEAN	‫TRUE، FALSE
restroom	يتم عرض الأماكن التي توفّر دورات مياه.	BOOLEAN	‫TRUE، FALSE
serves_breakfast	يتم البحث عن الأماكن التي تقدّم وجبة الفطور.	BOOLEAN	‫TRUE، FALSE
serves_lunch	يتم البحث عن أماكن تقدّم وجبة الغداء.	BOOLEAN	‫TRUE، FALSE
serves_dinner	يتم البحث عن أماكن تقدّم العشاء.	BOOLEAN	‫TRUE، FALSE
serves_beer	يتم البحث عن أماكن تقدّم البيرة.	BOOLEAN	‫TRUE، FALSE
serves_wine	يتم البحث عن الأماكن التي تقدّم النبيذ.	BOOLEAN	‫TRUE، FALSE
serves_brunch	يتم البحث عن أماكن تقدّم وجبات الإفطار المتأخر.	BOOLEAN	‫TRUE، FALSE
serves_vegetarian_food	يتم البحث عن أماكن تقدّم طعامًا نباتيًا.	BOOLEAN	‫TRUE، FALSE
serves_cocktails	يتم البحث عن أماكن تقدّم مشروبات الكوكتيل.	BOOLEAN	‫TRUE، FALSE
serves_dessert	يتم البحث عن أماكن تقدّم الحلويات.	BOOLEAN	‫TRUE، FALSE
serves_coffee	يأخذ في الاعتبار الأماكن التي تقدّم القهوة.	BOOLEAN	‫TRUE، FALSE
menu_for_children	يتم أخذ الأماكن التي تقدّم قوائم طعام للأطفال في الاعتبار.	BOOLEAN	‫TRUE، FALSE
good_for_children	ابحث عن أماكن مناسبة للأطفال.	BOOLEAN	‫TRUE، FALSE
good_for_groups	ابحث عن أماكن مناسبة للمجموعات.	BOOLEAN	‫TRUE، FALSE
good_for_watching_sports	ضَع في اعتبارك الأماكن المناسبة لمشاهدة المباريات الرياضية.	BOOLEAN	‫TRUE، FALSE
accepts_credit_cards	ابحث عن الأماكن التي تقبل بطاقات الائتمان.	BOOLEAN	‫TRUE، FALSE
accepts_debit_cards	ابحث عن الأماكن التي تقبل بطاقات السحب الآلي.	BOOLEAN	‫TRUE، FALSE
accepts_cash_only	ضَع في اعتبارك الأماكن التي تقبل الدفع نقدًا فقط.	BOOLEAN	‫TRUE، FALSE
accepts_nfc	ابحث عن الأماكن التي تقبل الدفعات عبر NFC.	BOOLEAN	‫TRUE، FALSE
free_parking_lot	يتم أخذ الأماكن التي توفّر موقف سيارات مجانيًا في الاعتبار.	BOOLEAN	‫TRUE، FALSE
paid_parking_lot	يتم البحث عن الأماكن التي توفّر موقف سيارات برسوم.	BOOLEAN	‫TRUE، FALSE
free_street_parking	يتم عرض الأماكن التي توفّر موقف سيارات في الشارع مجانًا.	BOOLEAN	‫TRUE، FALSE
paid_street_parking	يتم عرض الأماكن التي توفّر مواقف سيارات في الشارع برسوم.	BOOLEAN	‫TRUE، FALSE
valet_parking	يتم البحث عن الأماكن التي تتوفّر فيها خدمة صفّ السيارات.	BOOLEAN	‫TRUE، FALSE
free_garage_parking	يعرض الأماكن التي توفّر مرآبًا مجانيًا للسيارات.	BOOLEAN	‫TRUE، FALSE
paid_garage_parking	يتم عرض الأماكن التي توفّر مرآبًا لركن السيارات برسوم.	BOOLEAN	‫TRUE، FALSE
wheelchair_accessible_parking	يتم أخذ الأماكن التي تتوفّر فيها مواقف سيارات مناسبة لأصحاب الكراسي المتحرّكة في الاعتبار.	BOOLEAN	‫TRUE، FALSE
wheelchair_accessible_entrance	يتم أخذ الأماكن التي تتوفّر فيها مداخل مناسبة لأصحاب الكراسي المتحرّكة في الاعتبار.	BOOLEAN	‫TRUE، FALSE
wheelchair_accessible_restroom	يتم البحث عن أماكن تتوفّر فيها دورات مياه مناسبة لأصحاب الكراسي المتحرّكة.	BOOLEAN	‫TRUE، FALSE
wheelchair_accessible_seating	يتم البحث عن أماكن تتوفّر فيها أماكن جلوس مناسبة لأصحاب الكراسي المتحرّكة.	BOOLEAN	‫TRUE، FALSE
snapshot_date	يحدّد شهر اللقطة السابقة المطلوب الاستعلام عنه. في حال عدم إدخال قيمة، يتم استخدام أحدث لقطة تلقائيًا.	STRING	التنسيق: YYYY-MM مثلاً: "2026-07"
month1	لـ "PLACES_COUNT_CHANGE" فقط يحدّد هذا الحقل شهر اللقطة الأساسية المطلوب الاستعلام عنها.	STRING	التنسيق: YYYY-MM مثلاً: "2026-01"
month2	لـ "PLACES_COUNT_CHANGE" فقط تحدّد هذه المَعلمة شهر اللقطة التي تريد مقارنتها بطلب البحث.	STRING	التنسيق: YYYY-MM مثلاً: "2026-02"
regular_opening_hours	لفلترة الأماكن حسب ساعات العمل العادية	JSON	مثلاً: JSON_OBJECT('monday', [JSON_OBJECT('start_time', '09:00', 'end_time', '12:00')])
min_ev_charge_connector_count	تحدّد هذه السمة الحدّ الأدنى لعدد وصلات شحن المركبات الكهربائية.	INT64	الحد الأدنى هو 0.
max_ev_charge_connector_count	تحدّد هذه السمة الحد الأقصى لعدد موصلات شحن المركبات الكهربائية.	INT64	الحد الأدنى هو 0.
max_ev_max_charge_rate_kw	تحدّد الحد الأقصى لمعدّل الشحن بالكيلوواط لمحطات شحن المركبات الكهربائية.	FLOAT64	الحد الأدنى هو 0.0.
ev_charge_connector_types	تحدّد هذه السمة أنواع وصلات المركبات الكهربائية التي يجب أخذها في الاعتبار.	ARRAY<STRING>	مثلاً: ["EV_CONNECTOR_TYPE_TESLA"]