يمكنك تطبيق فلاتر على دوال عدد الأماكن باستخدام المَعلمات الموضّحة في الجدول أدناه. يُرجى العِلم أنّ المَعلمات المطلوبة تختلف لكل دالة:
PLACES_COUNT
: تتطلّبgeography
PLACES_COUNT_PER_TYPE
: يتطلّبgeography
وtype
PLACES_COUNT_PER_GEO
: تتطلّبgeographies
PLACES_COUNT_PER_H3
: يتطلّبgeography
وh3_resolution
تعرِض الدالة خطأ في الوسيطة غير الصالحة إذا لم يتم تحديد اسم الفلتر وقيمته وفقًا للمتطلبات أدناه.
اسم الفلتر | الوصف | النوع | القيم المسموح بها |
---|---|---|---|
geography |
بالنسبة إلى تحدّد هذه السمة منطقة للبحث. يمكن استخدام أي نوع من يمكنك استخدام المَعلمة يتم فرض حد أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر مربع). إذا حدّدت مساحة بحث أقل من هذا الحدّ، ستعرض الدالة خطأ في الوسيطة غير صالحة. |
GEOGRAPHY |
أي نوع من GEOGRAPHY |
geographies |
لـ " تحدّد هذه السمة قائمة بالمناطق المطلوب البحث فيها. يمكن استخدام أي نوع من يمكنك استخدام المَعلمة يتم فرض حد أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر مربع). إذا حدّدت مساحة بحث أقل من هذا الحدّ، ستعرض الدالة خطأ في الوسيطة غير صالحة. |
ARRAY<GEOGRAPHY> |
أي نوع من GEOGRAPHY |
geography_radius |
تضيف هذه السمة نطاقًا جغرافيًا أو منطقة عازلة، بالأمتار، إلى الموقع الجغرافي المحدّد. القيمة التلقائية هي 0. يجب أن تحدّد القيمة المحدّدة حدًا أدنى لمساحة البحث يبلغ 40.0 مترًا في 40.0 مترًا (1600 متر2). على سبيل المثال، بالنسبة إلى منطقة جغرافية |
INT64 |
الحد الأدنى هو 0. |
h3_resolution |
لـ " تشير إلى دقة H3 المستخدَمة لتجميع عدد الأماكن في خلايا H3. |
INT64 |
بين 0 و8 |
types |
تحدّد هذه السمة أنواع الأماكن التي يجب أخذها في الاعتبار. يحتوي كل مكان على مجموعة من أنواع الأماكن، مثل |
ARRAY<STRING> |
للاطّلاع على القائمة الكاملة بالقيم المحتملة، راجِع الجدول "أ" والجدول "ب" في أنواع الأماكن. مثال:
|
primary_types |
تحدّد هذه السمة الأنواع الأساسية التي يجب أخذها في الاعتبار. يمكن أن يكون للمكان نوع أساسي واحد فقط، وهو النوع الذي يصف الموقع الجغرافي على أفضل وجه. في حال عدم تحديد أي أنواع أساسية، سيتم أخذ جميع الأنواع الأساسية للأماكن في الاعتبار في النتيجة. |
ARRAY<STRING> |
للاطّلاع على القائمة الكاملة بالقيم المحتملة، راجِع الجدول "أ" والجدول "ب" في أنواع الأماكن. مثال:
|
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> |
القيم المسموح بها:
مثال:
|
business_status |
تحدّد هذه السمة حالة المؤسسة التي يجب أخذها في الاعتبار. يمكنك تحديد حالات نشاط تجاري متعددة. | ARRAY<STRING> |
القيم المسموح بها:
مثال:
|
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 " |