Migrar a Place Photo (nuevo)

Esta función requiere que habilites la API de Places (nueva), la próxima generación de la API de Places. Para obtener más información, consulta Habilita las APIs.

El SDK de Places para iOS admite Place Photo (heredado). Si conoces Place Photo (heredado), Place Photo (nuevo) realiza los siguientes cambios:

• Usa un nuevo modelo de precios. Para obtener información sobre los precios de todas las APIs, consulta Precios del SDK de Places para iOS (nuevo).

• Place Photo (heredado) admitía un tamaño máximo de foto de 1,600 por 1,600 píxeles. Place Photo (nuevo) admite tamaños de hasta 4,800 por 4,800 píxeles.

• Para realizar una solicitud, llama al nuevo GMSPlacesClient fetchPhotoWithRequest:callback: método.

• Pasa lo siguiente a la solicitud:

  • Una instancia de la nueva GMSFetchPhotoRequest clase que define todos los parámetros de la solicitud, incluido el tamaño máximo de la imagen

  • Una devolución de llamada de tipo GMSPlacePhotoMetadataResultCallback para controlar la respuesta

• Cada foto se representa con una GMSPlacePhotoMetadata instancia. Para el SDK de Places para iOS (nuevo), la GMSPlacePhotoMetadata instancia contiene un nuevo authorAttribution campo representado por la nueva GMSPlaceAuthorAttribution clase.

  Si la instancia de GMSPlacePhotoMetadata que se muestra incluye attributions o authorAttribution, debes incluir estas atribuciones en tu aplicación en cualquier lugar donde muestres la imagen. Consulta la documentación sobre las atribuciones.

Ejemplo de solicitud

En el siguiente método de ejemplo, se toma un ID de lugar y se obtiene la primera foto de la lista que se muestra. Puedes usar este método como plantilla para el método que crearás en tu propia 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
    }
  }];
}];