Place Photos

Selecciona la plataforma: Android iOS JavaScript Servicio web

Puedes usar el SDK de Places para iOS para solicitar fotos de lugares que se mostrarán en tu aplicación. Las fotos que muestra el servicio de fotos provienen de diversas fuentes, como los propietarios comerciales y los usuarios. Para recuperar fotos de un lugar, debes seguir estos pasos:

1. Llama a [GMSPlacesClient fetchPlaceFromPlaceId] y pasa una cadena con un ID de lugar y una devolución de llamada. Con esto se llamará a la devolución de llamada con un objeto GMSPlacePhotoMetadataList.
2. En el objeto GMSPlacePhotoMetadataList, accede a la propiedad results y selecciona las fotos que se cargarán desde el array.
3. Para cada GMSPlacePhotoMetadata que desees cargar desde esta lista, llama a [GMSPlacesClient loadPlacePhoto:callback:] o a [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]. Estos llamarán al callback con un UIImage utilizable. Las fotos pueden tener un ancho o una altura máximos de 1,600 píxeles.

Nota: Siempre que muestres una foto de un lugar, asegúrate de seguir los lineamientos de atribución. Consulta Atribuciones para obtener más información.

Código de muestra

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

// Specify the place data types to return (in this case, just photos).
let fields: GMSPlaceField = GMSPlaceField(rawValue: UInt(GMSPlaceField.photos.rawValue))!

placesClient?.fetchPlace(fromPlaceID: "INSERT_PLACE_ID_HERE",
                         placeFields: fields,
                         sessionToken: nil, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    // Get the metadata for the first photo in the place photo metadata list.
    let photoMetadata: GMSPlacePhotoMetadata = place.photos![0]

    // Call loadPlacePhoto to display the bitmap and attribution.
    self.placesClient?.loadPlacePhoto(photoMetadata, callback: { (photo, error) -> Void in
      if let error = error {
        // TODO: Handle the error.
        print("Error loading photo metadata: \(error.localizedDescription)")
        return
      } else {
        // Display the first image and its attributions.
        self.imageView?.image = photo;
        self.lblText?.attributedText = photoMetadata.attributions;
      }
    })
  }
})

Objective-C

// Specify the place data types to return (in this case, just photos).
GMSPlaceField fields = (GMSPlaceFieldPhotos);

NSString *placeId = @"INSERT_PLACE_ID_HERE";

[_placesClient fetchPlaceFromPlaceID:placeId placeFields:fields sessionToken:nil callback:^(GMSPlace * _Nullable place, NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"An error occurred %@", [error localizedDescription]);
    return;
  }
  if (place != nil) {
    GMSPlacePhotoMetadata *photoMetadata = [place photos][0];
    [self->_placesClient loadPlacePhoto:photoMetadata callback:^(UIImage * _Nullable photo, NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error loading photo metadata: %@", [error localizedDescription]);
        return;
      } else {
        // Display the first image and its attributions.
        self->imageView.image = photo;
        self->lblText.attributedText = photoMetadata.attributions;
      }
    }];
  }
}];

Almacenamiento en caché

Las fotos que se cargan con [GMSPlacesClient loadPlacePhoto:callback:] o [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] se almacenan en el caché del disco y de la memoria interna por el sistema de carga de URL de Foundation en el NSURLCache compartido.

Para configurar el comportamiento de almacenamiento en caché, puedes cambiar el caché de URL compartido usando [NSURLCache setSharedURLCache:] en el método application:didFinishLaunchingWithOptions: del delegado de tu aplicación.

Si no deseas que tu aplicación comparta un NSURLCache con el SDK de Places para iOS, puedes crear un NSURLCache nuevo y usarlo exclusivamente en tu app sin configurarlo como el caché compartido.

Atribuciones

En la mayoría de los casos, las fotos de lugares se pueden usar sin atribución o tendrán la atribución requerida incluida como parte de la imagen. Sin embargo, si en la instancia de GMSPlacePhotoMetadata que se muestra incluye una atribución, debes incluir la atribución adicional en tu aplicación dondequiera que muestres la imagen. Ten en cuenta que los vínculos en la atribución deben ser seleccionables. Consulta la documentación sobre las atribuciones.

Límites de uso

La recuperación de una imagen cuesta una unidad de cuota. No hay límites de uso para recuperar metadatos de fotos. Obtén más información sobre uso y facturación.