مؤلفه «فهرست مکان پیشرفته»

مؤلفه «فهرست مکان پیشرفته» به شما امکان می‌دهد فهرستی از مکان‌ها را تعریف و نمایش دهید. می‌توانید حداکثر ۲۰ مکان را از همان مجموعه هویت‌های پشتیبانی‌شده توسط مؤلفه «جزئیات مکان» (شناسه‌های مکان، نام‌های منبع مکان، یا مختصات طول/عرض جغرافیایی) فهرست کنید.

می‌توانید از بین نمایش فهرست افقی یا عمودی انتخاب کنید. جهت پیش‌فرض عمودی است. همان اطلاعات و گزینه‌های پیکربندی کارت‌های جزئیات مکان فشرده و کامل برای هر مورد فهرست دردسترس است.

از واسط PlaceActionProvider AdvancedPlaceListFragment برای ایجاد فهرست استفاده کنید.

صورت‌حساب

برای هر درخواست فهرست صورت‌حساب دریافت می‌کنید و هرگونه تغییر در فهرست یک رویداد جدید قابل‌صورت‌حساب است.

مثال

ایجاد بخش AdvancedPlaceList

Kotlin

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

// how fragment is created
AdvancedPlaceListFragment.newInstance(
          selectedContent,
          orientation,
          R.style.BrandedPlaceDetailsTheme,
        )

// fragments support the same configurations that PlaceSearchFragment supports
fragment.preferTruncation = false
fragment.attributionPosition = AttributionPosition.BOTTOM
fragment.mediaSize = AdvancedPlaceListFragment.MediaSize.SMALL
fragment.selectable = true

نمایش فهرست مکان

Kotlin

// You can use resourceNames or placeIds
advancedPlaceListFragment.configureFromPlaceIds(placeIds)

advancedPlaceListFragment.configureFromResourceNames(resourceNames)

// Alternatively, use coordinates, which are a list of LatLng:
advancedPlaceListFragment.configureFromCoordinates(coordinates)
// Uses reverse geocoding to get the place

گوش دادن به نتایج

Kotlin

// Attach the existing PlaceSearchFragmentListener to get notified 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, it's functionally identical but with a new name.  
      is AdvancedPlaceListFragment -> fragment.registerListener(advancedPlaceListFragmentListener)
    }
}