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

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

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

اسم الفلتر الوصف النوع القيم المسموح بها
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 متر مربع). إذا حدّدت مساحة بحث أقل من هذا الحد، ستعرض الدالة خطأ في الوسيطة غير صالحة.

 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"]