Eseguire la migrazione a Place Photo (novità)

Questa funzionalità richiede l'attivazione dell'API Places (nuova), la nuova generazione dell'API Places. Per saperne di più, consulta Abilita le API.

Places SDK for iOS (Legacy) supporta Place Photos (Legacy). Se hai dimestichezza con Place Photos (Legacy), Place Photos (New) apporta le seguenti modifiche:

• Utilizza un nuovo modello di prezzo. Per informazioni sui prezzi di tutte le API, consulta Utilizzo e fatturazione.

• Place Photos (Legacy) supportava una dimensione massima delle foto di 1600 x 1600 pixel. Place Photos (New) supporta dimensioni fino a 4800 x 4800 pixel.

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

• Passa alla richiesta:

  • Un'istanza della nuova classe GMSFetchPhotoRequest che definisce tutti i parametri della richiesta, inclusa la dimensione massima dell'immagine.

  • Un callback di tipo GMSPlacePhotoMetadataResultCallback per gestire la risposta.

• Ogni foto è rappresentata da un'istanza GMSPlacePhotoMetadata. Per Places SDK for iOS (nuovo), l'istanza GMSPlacePhotoMetadata contiene un nuovo campo authorAttribution rappresentato dalla nuova classe GMSPlaceAuthorAttribution.

  Se l'istanza GMSPlacePhotoMetadata restituita include attributions o authorAttribution, devi includere queste attribuzioni nella tua applicazione ovunque mostri l'immagine. Consulta la documentazione sulle attribuzioni.

Esempio di richiesta

Il seguente metodo di esempio prende un ID luogo e recupera la prima foto nell'elenco restituito. Puoi utilizzare questo metodo come modello per il metodo che creerai nella tua app.

Swift

// A hotel in Saigon with an attribution.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Request list of photos for a place
placesClient.lookUpPhotos(forPlaceID: placeID) { (photos, error) in

  guard let photoMetadata: GMSPlacePhotoMetadata = photos?.results[0] else {
    return }

  // Request individual photos in the response list
  let fetchPhotoRequest = GMSFetchPhotoRequest(photoMetadata: photoMetadata, maxSize: CGSizeMake(4800, 4800))
  self.client.fetchPhoto(with: fetchPhotoRequest, callback: {
    (photoImage: UIImage?, error: Error?) in
      guard let photoImage, error == nil else {
        print("Handle photo error: ")
        return }
      print("Display photo Image: ")
    }
  )
}

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

[placesClient lookUpPhotosForPlaceID:placeID callback: ^(GMSPlacePhotoMetadataList *list, NSError *error) {
  GMSPlacePhotoMetadata *photoMetadata = [list results][0];

  // Request individual photos in the response list
  GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)];
  [placesClient fetchPhotoWithRequest:fetchPhotoRequest callback: ^(UIImage *_Nullable photoImage, NSError *_Nullable error) {
    if (error == nil) {
      // Display photo
    }
  }];
}];