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 der Place Search

Über das AdvancedPlaceSearchFragment können Sie auf erweiterte Funktionen zugreifen.

Aktionsschaltflächen konfigurieren

Über die PlaceActionProvider-Oberfläche von AdvancedPlaceSearchFragment können Sie Aktionsschaltflächen definieren und anpassen.

Anforderungen bezüglich visueller Quellenangaben

Ansicht „Erweiterte Suche“ mit benutzerdefinierten Schaltflächen
Ergebnis der Ortssuche mit benutzerdefinierter Schaltfläche

Wichtig:Sie müssen Nutzern deutlich mitteilen, wenn über eine benutzerdefinierte Aktionsschaltfläche Nutzerinformationen an einen anderen Drittanbieter als Google weitergegeben werden. Weitere Informationen zu den Anforderungen an die visuelle Quellenangabe

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

Such- und Filteroptionen anwenden

Verwenden Sie die SearchMediaOptions- und SearchReviewsOptions-Schnittstellen von AdvancedPlaceSearchFragment, um die Suche und Filterung von Medien oder Rezensionen zu ermöglichen.

Erweiterte Beispiele für die Suche nach Orten

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