Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Arama önerileri

Arama önerileri kullanıcı arayüzü görünümü oluşturucu isteyin

Arama önerileri kullanıcı arayüzü görünümünü almak için önce aşağıdaki adımları uygulayarak oluşturucusunu almanız gerekir:

Hedef Activity sınıfınızın GetSearchSuggestionsViewGeneratorCallback arayüzünü uygulamasını sağlayın veya anonim iç sınıfı kullanın.
GetSearchSuggestionsViewGeneratorCallback arayüzünün onSuccess(SearchSuggestionsViewGenerator) ve onError(String) yöntemlerini geçersiz kılın.
Arama bağlamları listesiyle GetSearchSuggestionsViewOptions sınıf örneğini oluşturun. (İsteğe bağlı) Bu nesne, arama önerileri kullanıcı arayüzünün görünümünü özelleştirmek için bazı seçenekler sunan bir SearchSuggestionsViewOptions nesnesi de alır.
SearchInAppsService'nın getSearchSuggestionsView(GetSearchSuggestionsViewOptions, GetSearchSuggestionsViewGeneratorCallback) işlevini kullanın.
Kullanıcı arayüzü oluşturucuyu aldıktan sonra, etkinliğin yeniden oluşturulması gerektiğinde (ör. uygulama çalışırken yapılandırma değiştiğinde) oluşturucuyu tekrar istemeniz gerekmemesi için bunu bir ViewModel'de saklayabilirsiniz.

Örnek kod

Java

package ...;

...
import androidx.appcompat.app.AppCompatActivity;
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewGeneratorCallback;
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewOptions;
import com.google.android.libraries.searchinapps.SearchInAppsService;
import com.google.android.libraries.searchinapps.SearchSuggestionsViewGenerator;
import java.util.Arrays;
import java.util.List;
...

public class MainActivity extends AppCompatActivity implements GetSearchSuggestionsViewGeneratorCallback {
  private SearchInAppsService service;

  @Override
  public void onSuccess(SearchSuggestionsViewGenerator generator) {
    ...
  }

  @Override
  public void onError(String errorMessage) {
    ...
  }

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    ...
    service = SearchInAppsService.create(this);
    // Right now only the first element of this list will be used.
  List<String> searchContext = Arrays.asList(new String[]{"This is a test query, for example."});
    // Uses the default SearchSuggestionsViewOptions.
    service.getSearchSuggestionsView(
      new GetSearchSuggestionsViewOptions().setTextContext(searchContext),this);
    ...
  }

  @Override
  public void onDestroy() {
    service.shutDown();
    super.onDestroy();
  }
}

Jetpack Compose

package ...

...
import android.os.Bundle
import androidx.activity.compose.setContent
import androidx.appcompat.app.AppCompatActivity
import androidx.compose.runtime.Composable
import androidx.compose.runtime.DisposableEffect
import androidx.compose.runtime.mutableStateOf
import androidx.compose.ui.platform.LocalContext
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewGeneratorCallback
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewOptions
import com.google.android.libraries.searchinapps.SearchInAppsService
import com.google.android.libraries.searchinapps.SearchSuggestionsViewGenerator
...

class MainActivity : AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContent {
      SearchSuggestionsUI()
    }
  }

  @Composable
  fun SearchSuggestionsUI() {
    ...
    var service by remember {
      mutableStateOf<SearchInAppsService?>(
        SearchInAppsService.create(LocalContext.current))
    }
    DisposableEffect(Unit) { onDispose { service?.shutDown() } }
    val callback =
              object : GetSearchSuggestionsViewGeneratorCallback {
                override fun onSuccess(generator: SearchSuggestionsViewGenerator) {
                  ...
                }

              override fun onError(errorMessage: String) {
                ...
              }
            }
  var searchContexts: List<String> = listOf<String>("Query")
  // Uses the default SearchSuggestionsViewOptions.
  var options: GetSearchSuggestionsViewOptions =
            GetSearchSuggestionsViewOptions()
              .setTextContext(searchContexts)
  service?.getSearchSuggestionsView(options, callback)
  ...
 }
}

Konuma dayalı arama önerileri isteme

getSearchSuggestionsView giriş noktası, konuma dayalı arama önerilerini de destekler. Aşağıdaki adımları uygulayarak LocationContext nesnelerinin listesini içeren bir GetSearchSuggestionsViewOptions nesnesi oluşturun. Ardından, önceki bölümde yer alan adımları uygulayarak GetSearchSuggestionsViewOptions'i getSearchSuggestionsView işlevine geçirin.

(Zorunlu) LocationContext nesnesini GeographicalRestrictions nesnesiyle oluşturun. GeographicalRestrictions nesnesi, alanın merkezinin enlemini ve boylamını, alanın yarıçapını içeren bir CircularArea nesnesi alır.
(İsteğe bağlı) TimeRestrictions nesnesini TimeSegment nesnesiyle oluşturun. TimeSegment nesnesi, ISO 8601 biçimindeki zaman segmentini temsil eden bir dize alır.
(İsteğe bağlı) İstenen coğrafi türlerle GeoTypeRestrictions nesnesini oluşturun. Sağlanan türler, hizmet tarafından döndürülen sonuçların sıralamasını ve filtrelenmesini ayarlamak için kullanılır. Desteklenen değerler: "restaurant" (restoran), "cafe" (kafe), "bar" (bar), "park" (park), "zoo" (hayvanat bahçesi), "museum" (müze), "attraction" (turistik yer), "atm" (ATM), "bank" (banka), "hair_salon" (kuaför), "real_estate_agency" (emlak acentesi), "bicycle_sharing_location" (bisiklet paylaşım noktası), "car_rental_agency" (araç kiralama acentesi), "shopping_center" (alışveriş merkezi), "grocery_store" (bakkal) ve "hotel" (otel).

Örnek kod

Java

package ...;

...
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewGeneratorCallback;
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewOptions;
import com.google.android.libraries.searchinapps.LocationContext;
import com.google.android.libraries.searchinapps.LocationContext.CircularArea;
import com.google.android.libraries.searchinapps.LocationContext.GeoTypeRestrictions;
import com.google.android.libraries.searchinapps.LocationContext.GeographicalRestrictions;
import com.google.android.libraries.searchinapps.LocationContext.LatLng;
import com.google.android.libraries.searchinapps.LocationContext.TimeRestrictions;
import com.google.android.libraries.searchinapps.LocationContext.TimeSegment;
import com.google.android.libraries.searchinapps.SearchInAppsService;
import com.google.android.libraries.searchinapps.SearchSuggestionsViewGenerator;
...
LocationContext locationContext = new LocationContext(
    new GeographicalRestrictions(
        new CircularArea(
            new LatLng(
                40.7414728,
                -74.0059622),
                1000)))
    // Optional. If set, the returned suggestions are categories of which
    // there are several businesses in the requested area that are open at
    // the given time.
    .setTimeRestrictions(
      new TimeRestrictions(
        new TimeSegment("2024-05-18T19:20:30.45+01:00")))
    // Optional. If set, the returned suggestions are subset of the
    // requested categories.
    .setGeoTypeRestrictions(
      new GeoTypeRestrictions("restaurant", "parks"));

// Uses the default SearchSuggestionsViewOptions.
service = SearchInAppsService.create(this);
// Uses the default SearchSuggestionsViewOptions.
service.getSearchSuggestionsView(
  new GetSearchSuggestionsViewOptions().setLocationContext(Arrays.asList(locationContext)), this);

Jetpack Compose

package ...

...
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewGeneratorCallback
import com.google.android.libraries.searchinapps.GetSearchSuggestionsViewOptions
import com.google.android.libraries.searchinapps.LocationContext
import com.google.android.libraries.searchinapps.LocationContext.CircularArea
import com.google.android.libraries.searchinapps.LocationContext.GeoTypeRestrictions
import com.google.android.libraries.searchinapps.LocationContext.GeographicalRestrictions
import com.google.android.libraries.searchinapps.LocationContext.LatLng
import com.google.android.libraries.searchinapps.LocationContext.TimeRestrictions
import com.google.android.libraries.searchinapps.LocationContext.TimeSegment
import com.google.android.libraries.searchinapps.SearchInAppsService
import com.google.android.libraries.searchinapps.SearchSuggestionsViewGenerator
...

var locationContext: LocationContext = LocationContext(
  GeographicalRestrictions(
    CircularArea(
      LatLng(40.7414728, -74.0059622),
      1000)))
  // Optional. If set, there are several businesses in the requested area that
  // are open at the given time.
  .setTimeRestrictions(
    TimeRestrictions(
      TimeSegment("2024-05-18T19:20:30.45+01:00")))
  // Optional. If set, the returned suggestions are subset of the requested
  // categories.
  .setGeoTypeRestrictions(
    GeoTypeRestrictions("restaurant", "parks"))

// Uses the default SearchSuggestionsViewOptions.
var options: GetSearchSuggestionsViewOptions =
          GetSearchSuggestionsViewOptions()
            .setLocationContext(listOf<LocationContext>(locationContext))
service.getSearchSuggestionsView(options, callback)
...