Erweiterte „Place Search“-Komponente

Die erweiterte Version der „Place Search“-Komponente bietet dieselben Funktionen wie „Place Search Essentials“. Außerdem können Sie die Aktionsbuttons der Komponente konfigurieren und Such- und Filteroptionen auf die angezeigten Rezensionen und Medien anwenden.

Erweiterte „Place Search“-Konfiguration

Verwenden Sie AdvancedPlaceSearchFragment, um auf erweiterte Funktionen zuzugreifen.

Aktionsbuttons konfigurieren

Verwenden Sie die PlaceActionProvider-Schnittstelle von AdvancedPlaceSearchFragment, um Aktionsbuttons zu definieren und anzupassen.

Anforderungen an die visuelle Quellenangabe

AdvancedPlace Search-Ansicht mit benutzerdefinierten Tasten
„Place Search“-Suchergebnis mit benutzerdefiniertem Button

Wichtig:Sie müssen Nutzern klar mitteilen, wenn ein benutzerdefinierter Aktionsbutton Nutzerinformationen an einen anderen Drittanbieter als Google weitergibt. Weitere Informationen finden Sie unter Anforderungen an die visuelle Quellenangabe.

Im Beispiel ist ein benutzerdefiniertes Bild zu sehen, das verdeutlicht, dass Nutzerinformationen an „Altostrat“ gesendet werden.

Such- und Filteroptionen anwenden

Verwenden Sie die Schnittstellen SearchMediaOptions und SearchReviewsOptions von AdvancedPlaceSearchFragment, um die Suche und Filterung für Medien oder Rezensionen zu aktivieren.

Beispiele für die erweiterte „Place Search“

AdvancedPlaceSearch-Fragment erstellen

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)

Ergebnisse anhören

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)
    }
}