مكوّن "البحث المتقدّم عن الأماكن"

يقدّم الإصدار المتقدّم من مكوّن "البحث عن الأماكن" الميزات نفسها التي يقدّمها أساسيات البحث عن الأماكن. يتيح لك أيضًا ضبط أزرار الإجراءات الخاصة بالمكوّن وتطبيق خيارات البحث والفلترة على المراجعات والوسائط التي تظهر.

إعدادات البحث المتقدّم عن الأماكن

استخدِم AdvancedPlaceSearchFragment للوصول إلى الميزات المتقدّمة.

ضبط أزرار الإجراءات

استخدِم واجهة PlaceActionProvider في AdvancedPlaceSearchFragment لتحديد أزرار الإجراءات وتخصيصها.

متطلبات تحديد المصدر بشكل مرئي

طريقة عرض "البحث المتقدّم" في AdvancedPlace مع أزرار مخصّصة
نتيجة بحث عن مكان مع زر مخصّص

ملاحظة مهمة: يجب أن توضّح للمستخدمين الحالات التي سيشارك فيها زر الإجراء المخصّص معلومات المستخدم مع جهة خارجية غير Google. راجِع متطلبات الإشارة إلى المصدر بشكل مرئي.

يعرض المثال صورة مخصّصة توضّح أنّه سيتم إرسال معلومات المستخدم إلى "Altostrat".

تطبيق خيارات البحث والفلترة

استخدِم واجهتَي SearchMediaOptions وSearchReviewsOptions في AdvancedPlaceSearchFragment لتفعيل البحث عن الوسائط أو المراجعات وفلترتها.

أمثلة على البحث المتقدّم عن الأماكن

إنشاء جزء AdvancedPlaceSearch

Kotlin

// Initialize Places first
Places.initializeWithNewPlacesApiEnabled(context, API_KEY)

// How the fragment is created
AdvancedPlaceSearchFragment.newInstance(
          selectedContent,
          orientation,
          R.style.BrandedPlaceDetailsTheme,
        )

// Fragment supports the same configs that PlaceSearchFragment supported
fragment.preferTruncation = false
fragment.attributionPosition = AttributionPosition.BOTTOM
fragment.selectable = true

Kotlin

// Performing a search works the same as with a regular placeSearchFragment.

advancedPlaceSearchFragment.configureFromSearchByTextRequest(searchByTextRequest)

advancedPlaceSearchFragment.configureFromSearchNearbyRequest(searchNearbyRequest)

الاستماع إلى النتائج

Kotlin

// attach the existing PlaceSearchFragmentListener to get notified about when places load or are selected from the results list.  
override fun onAttachFragment(fragment: Fragment) {
    super.onAttachFragment(fragment)
    when (fragment) {
      // Reuse the placeSearchFragmetnListener from the Essentials version
      is AdvancedPlaceSearchFragment -> fragment.registerListener(placeSearchFragmentListener)
      // use placeListFragmentListener, its functionally identical but with a new name.  
      is AdvancedPlaceListFragment -> fragment.registerListener(advancedPlaceListFragmentListener)
    }
}