Suggerimenti per la ricerca

Visualizza le ricerche suggerite

Per ricevere suggerimenti di ricerca, chiama il metodo getSearchSuggestions su ContextualSearchRuntime. Questo metodo utilizza un singolo metodo GetSearchSuggestionsOptions in cui puoi specificare il testo da utilizzare per ottenere i suggerimenti di ricerca.

L'oggetto SearchSuggestions restituito non contiene proprietà accessibili. Contiene tutte le informazioni necessarie per visualizzare i suggerimenti di ricerca, ma è altrimenti opaco.

Swift utilizza lo stile di concorrenza di Swift, mentre Objective-C utilizza una funzione di callback.

Swift

getSearchSuggestions(withOptions:)

Task {
    let suggestions = try await searchRuntime.getSearchSuggestions(
            withOptions: GetSearchSuggestionsOptions(withTextContext:['Sample Query', 'Another query string']))
}

Objective-C

getSearchSuggestionsWithOptions

  [searchRuntime
      getSearchSuggestionsWithOptions:
            [[GetSearchSuggestionsOptions alloc] initWithTextContext: @[@'Sample Query', @'Another query string' ]]
                             completionHandler:^(SearchSuggestions *_Nullable suggestions,
                                                 NSError *_Nullable error) {
                              // error will be not null if there is an error.
                              // On success, suggestions will be non null.
                            }];

Ricevere ricerche suggerite basate sulla posizione

La richiesta getSearchSuggestions supporta anche i suggerimenti di ricerca basati sulla posizione. Crea un oggetto GetSearchSuggestionsOptions con un LocationSuggestionsContext.

Per creare la classe LocationSuggestionsContext:

1. (Obbligatorio) Imposta latitude, longitude e radiusMeters in modo che corrispondano all'area richiesta.
2. (Facoltativo) Imposta startTime in modo che corrisponda all'ora richiesta in cui devono essere applicati i suggerimenti di ricerca.
3. (Facoltativo) Imposta l'elenco geoTypes con i tipi di dati geografici richiesti. I tipi forniti vengono utilizzati per regolare il ranking e il filtro dei risultati restituiti dal servizio. I valori supportati sono documentati in LocationSuggestionsContext.

Swift

getSearchSuggestions(withOptions:)

Task {
    let locationContext: LocationSuggestionsContext = {
      let context = LocationSuggestionsContext()
      context.latitude = 40.748595
      context.longitude = -73.992365
      context.radiusMeters = 2500
      context.startTime = try?
        Date.ISO8601FormatStyle.iso8601.parse("2024-03-14T19:20:30.000+02:00")
      context.geoTypes = ["restaurant", "cafe"]
      return context
    }()
    let suggestions = try await searchRuntime.getSearchSuggestions(
            withOptions: GetSearchSuggestionsOptions(locationContext: [
              locationContext
            ]))
}

Objective-C

getSearchSuggestionsWithOptions

  LocationSuggestionsContext *locationContext;
  locationContext = [[LocationSuggestionsContext alloc] init];
  locationContext.latitude = 40.748595;
  locationContext.longitude = -73.992365;
  locationContext.radiusMeters = @2500;
  [searchRuntime
      getSearchSuggestionsWithOptions:
            [[GetSearchSuggestionsOptions alloc] initWithLocationContext: locationContext]
                             completionHandler:^(SearchSuggestions *_Nullable suggestions,
                                                 NSError *_Nullable error) {
                              // error will be not null if there is an error.
                              // On success, suggestions will be non null.
                            }];

Display

Per visualizzare i chip di suggerimenti di ricerca, utilizza i seguenti metodi (lo stile varia se utilizzi UIKit e SwiftUI).

UIKit Swift

Mostra i chip di suggerimenti di ricerca utilizzando SearchSuggestionsViewController.

// Create the SearchSuggestionsViewController with specified display options.
var searchSuggestionsController = SearchSuggestionsViewController(options: viewOptions)
...
// Add the view controller to the existing view hierarchy
searchSuggestionsController.addToViewContoller(self)
view.addSubview(searchSuggestionsController.view)
...
// Assign a specific set of search suggestions to this view controller.
searchSuggestionsController.searchSuggestions = suggestions

Objective-C

Mostra i chip di suggerimenti di ricerca utilizzando SearchSuggestionsViewController.

// Create the SearchSuggestionsController with specified display options.
SearchSuggestionsViewController *_searchSuggestionsController =
      [[SearchSuggestionsViewController alloc] initWithOptions:_customizationOptions];
...
// Add the view controller to the existing view hierarchy
[_searchSuggestionsController addToViewController:self];
[self.view addSubview:_searchSuggestionsController.view];
...
// Assign a specific set of search suggestions to this view controller.
_searchSuggestionsController.searchSuggestions = suggestions

SwiftUI

I suggerimenti di ricerca possono essere visualizzati con SearchSuggestionsView

SearchSuggestionsView(suggestions: suggestions, options: options)

Passaggio successivo: visualizzare i risultati di ricerca