مزيد من المعلومات حول فلاتر الأنواع

في Places Aggregate API، يساعدك فلتر النوع في تركيز بحثك من خلال السماح لك باختيار أنواع الأماكن التي تريد تضمينها في الرد أو استبعادها منه. يمكنك إنشاء قوائم بأنواع الأماكن التي تريدها وتلك التي لا تريدها، وذلك لكل من الفئة الرئيسية للمكان وتفاصيله الأخرى. بهذه الطريقة، يمكنك إنشاء عمليات بحث محدّدة للعثور على الأماكن التي تبحث عنها بالضبط.

يتوفّر أكثر من 200 نوع مكان. للحصول على قائمة كاملة بأنواع الأماكن التي تتيحها Places Aggregate API، يُرجى الاطّلاع على الجدول أ ضمن أنواع الأماكن في Places API (الجديدة).

طريقة عمل أنواع الأماكن

يمكن أن يتضمّن المكان أنواعًا متعددة من الأماكن:

• يمكن أن يكون للمكان نوع أساسي واحد يعكس وظيفته الأساسية. ومع ذلك، في بعض الحالات، قد لا يتم تحديد النوع الأساسي لمكان معيّن.

• يمكن أن يكون للمكان نوع ثانوي واحد أو أكثر. الأنواع الثانوية هي فئات إضافية تنطبق على مكان معيّن لتقديم معلومات تكميلية حول خصائص المكان وخدماته.

على سبيل المثال، قد يحدّد مكان نوعه الأساسي على أنّه restaurant، ولكن بما أنّه يقدّم أيضًا خدمات الطعام ويضمّ بارًا، يمكنه أيضًا تحديد أنواع الأماكن الثانوية على أنّها bar, food وestablishment.

تصفية حسب النوع

لتصفية الأماكن حسب النوع الأساسي، استخدِم includedPrimaryTypes وexcludedPrimaryTypes في الطلب. لا ينطبق الفلتر إلا على النوع الأساسي للمكان. على سبيل المثال، يعرض فلتر includedPrimaryTypes للأماكن التي تعمل بشكل أساسي كمطاعم restaurant فقط.

لفلترة الأماكن حسب النوعين الأساسي والثانوي، استخدِم includedTypes وexcludedTypes في الطلب. وينطبق الفلتر على كلا النوعين. على سبيل المثال، يؤدي البحث عن includedTypes من bar إلى عرض أماكن يكون bar إما نوعها الأساسي أو الثانوي.

ملاحظة مهمة: عند استخدام فلاتر متعددة، من المهم فهم التفاعل بين الفلاتر. على وجه الخصوص، يتم تقييم الأماكن باستخدام منطق "أو" ضمن الفلتر نفسه ومنطق "و" في الفلاتر المختلفة.

• ضمن الفلتر (منطق "أو"): على سبيل المثال، يعني includedTypes: restaurant, bar أنّ المكان يمكن أن يكون إما restaurant أو bar.
• الفلاتر المتقاطعة (المنطق "و"): يجب استيفاء جميع معايير الفلتر المحدّدة في الوقت نفسه. وهذا يعني أنّ كل فلتر يضيف مستوى من القيود إلى طلب البحث، ولن يتم تضمين سوى الأماكن التي تستوفي جميع الشروط في النتائج.

على سبيل المثال، إذا ضبطت includedTypes: restaurant, bar وexcludedTypes: hotel، سيختار الفلتر includedTypes أولاً جميع الأماكن المصنّفة على أنّها restaurant أو bar. ثانيًا، سيزيل الفلتر excludedTypes أي أماكن من هذا الاختيار مصنّفة أيضًا على أنّها hotel. نتيجةً لذلك، سيعرض طلب البحث أماكن مصنّفة على أنّها restaurant أو bar، ولكن فقط إذا لم يتم تصنيفها أيضًا على أنّها hotel في أي من أنواعها (الأساسية أو الثانوية).