Esegui la migrazione al completamento automatico dei luoghi (novità)

Questa funzionalità richiede l'abilitazione della nuova API Places, la generazione successiva dell'API Places. Per maggiori informazioni, consulta Attivare le API.

Places SDK for iOS supporta Completamento automatico dei luoghi (legacy). Se conosci Place Autocomplete (legacy), Place Autocomplete (nuovo) apporta le seguenti modifiche:

• Utilizza un nuovo modello di prezzi. Per informazioni sui prezzi di tutte le API, consulta Prezzi di Places SDK for iOS (nuovo).

• Per effettuare una richiesta, chiama il nuovo metodo GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:.

• Passa alla richiesta:

  • Un'istanza della nuova classe GMSAutocompleteRequest che definisce tutti i parametri della richiesta, come la query e il token di sessione.

  • Un callback di tipo GMSAutocompleteSuggestionsCallback per gestire la risposta.

• La classe GMSAutocompleteFilter ora ti consente di:

  • Imposta il codice regione utilizzato per determinare la formattazione dei risultati.
  • Imposta l'offset di previsione, un offset dei caratteri Unicode basato su zero della query.

• La risposta è definita dalla nuova classe GMSAutocompleteSuggestion. Questa classe contiene un array di istanze del nuovo tipo GMSAutocompletePlaceSuggestion che rappresentano i suggerimenti.

• La sessione termina con una chiamata a Place Details (New) o Address Validation. Per ulteriori informazioni, consulta Completamento automatico (nuovo) e prezzi delle sessioni.

Richiesta di esempio

Con il completamento automatico dei luoghi (nuovo), invii una richiesta e trasmetti tutti i parametri nell'istanza GMSAutocompleteRequest:

SwiftObjective-C

let token = GMSAutocompleteSessionToken()

let northEastBounds = CLLocationCoordinate2DMake(37.38816277477739, -122.08813770258874)
let southWestBounds = CLLocationCoordinate2DMake(37.39580487866437, -122.07702325966572)

let filter = GMSAutocompleteFilter()
filter.types = [kGMSPlaceTypeRestaurant]
filter.locationBias = GMSPlaceRectangularLocationOption(northEastBounds, southWestBounds)

let request = GMSAutocompleteRequest(query:"Sicilian piz")
request.filter = filter
request.sessionToken = token
GMSPlacesClient.shared().fetchAutocompleteSuggestions(from: request, callback: { results, error in
   // Handle response
})

  CLLocationCoordinate2D northEast = CLLocationCoordinate2DMake(37.38816277477739, -122.08813770258874);
  CLLocationCoordinate2D southWest = CLLocationCoordinate2DMake(37.39580487866437, -122.07702325966572);

  GMSAutocompleteFilter *filter = [[GMSAutocompleteFilter alloc] init];
  filter.types = @[ kGMSPlaceTypeRestaurant ];
  filter.locationBias = GMSPlaceRectangularLocationOption(northEast, southWest);
  GMSAutocompleteRequest *request = [[GMSAutocompleteRequest alloc] initWithQuery:@"Sicilian piz"];
  request.sessionToken = token;
  request.filter = filter;

  [[GMSPlacesClient sharedClient] fetchAutocompleteSuggestionsFromRequest:request callback:^(NSArray<GMSAutocompleteSuggestion *> * results, NSError * error){
    // Handle response
    for (GMSAutocompleteSuggestion *suggestion in results) {
      if (suggestion.placeSuggestion) {
        // Show place suggestion data.
      }
    }
  }];