Erweiterte „Place Search“-Komponente

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

Erweiterte Konfiguration für die Place Search

Verwenden Sie die AdvancedPlaceSearchFragment, um auf erweiterte Funktionen zuzugreifen.

Aktionsbuttons konfigurieren

Verwenden Sie die Schnittstelle PlaceActionProvider der AdvancedPlaceSearchFragment, um Aktionsschaltflächen zu definieren und anzupassen.

Anforderungen an die visuelle Attribution

AdvancedPlace Search-Ansicht mit benutzerdefinierten Tasten
Place Search-Ergebnis mit benutzerdefinierter Schaltfläche

Wichtig: Sie müssen Nutzer darüber informieren, wenn über einen benutzerdefinierten Aktionsbutton Nutzerdaten an einen anderen Drittanbieter als Google weitergegeben werden. Weitere Informationen finden Sie unter Anforderungen an den visuellen Urheberrechtsvermerk.

Das Beispiel zeigt ein benutzerdefiniertes Bild, das deutlich macht, dass Nutzerinformationen an „Altostrat“ gesendet werden.

Such- und Filteroptionen anwenden

Verwenden Sie die Schnittstellen SearchMediaOptions und SearchReviewsOptions der AdvancedPlaceSearchFragment, um die Suche und Filterung nach 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)
    }
}