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

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

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

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

يستند تقييم "أماكن Google" إلى مراجعات المستخدمين للمكان ويتراوح بين 1.0 و5.0.

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

 FLOAT بين 1.0 و5.0
max_rating

تحدّد هذه المَعلمة الحدّ الأقصى لتقييم المكان الذي يجب وضعه في الاعتبار.

يستند تقييم "أماكن Google" إلى مراجعات المستخدمين للمكان ويتراوح بين 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