Você pode usar o SDK do Places para iOS (novo) e solicitar a exibição de fotos de lugares no seu aplicativo. Fotos retornadas pelo serviço de fotos vêm de várias fontes, incluindo proprietários de empresas e fotos enviadas pelos usuários.
Fotos são imagens em bitmap representadas por um objeto UIImage. Uma imagem de bitmap tem um tamanho máximo de 4.800 por 4.800 pixels.
Solicitar uma imagem
Você pode solicitar até dez fotos para um lugar:
Chame
[GMSPlacesClient lookUpPhotosForPlaceID]
transmitindo um ID de lugar e um callbackGMSPlacePhotoMetadataResultCallback
. Essa solicitação chama o callbackGMSPlacePhotoMetadataResultCallback
com um objetoGMSPlacePhotoMetadataList
.No objeto
GMSPlacePhotoMetadataList
no callback, a propriedade de matrizresults
contém as fotos, em que cada foto é representada por um objetoGMSPlacePhotoMetadata
.Use o objeto
GMSPlacePhotoMetadata
para criar umGMSFetchPhotoRequest
, incluindo o tamanho máximo da imagem solicitada.Para cada objeto
GMSPlacePhotoMetadata
na matriz, chame[GMSPlacesClient fetchPhotoWithRequest:callback:]
transmitindo o objetoGMSFetchPhotoRequest
. Esse método chama o callbackGMSFetchPhotoResultCallback
com uma imagem de bitmap utilizável como uma UIImage.
Outra maneira de solicitar fotos de um lugar é fazer uma solicitação ao Place Details (novo), incluindo GMSPlacePropertyPhotos
na lista de campos. A vantagem de fazer uma chamada do Place Details é que o objeto de resposta GMSPlace
pode conter as fotos e qualquer outro campo de dados que você queira para o local.
Exemplo de código
O método de exemplo a seguir usa um ID de lugar e extrai a primeira foto na lista retornada. Use esse método como um modelo para o método que você criará no seu próprio 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 } }]; }];
GooglePlacesSwift
// First fetch place details // A hotel in Saigon with an attribution. let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs" let fetchPlaceRequest = FetchPlaceRequest( placeID: placeID, placeProperties: [ . name, .website ] ) var fetchedPlace: Place switch await placesClient.fetchPlace(with: fetchPlaceRequest) { case .success(let place): fetchedPlace = place case .failure(let placesError): // Handle error } // Use the place details to fetch a photo's image. guard let photo = fetchedPlace.photos?.first else { // Handle place without photos. } let fetchPhotoRequest = FetchPhotoRequest(photo: photo, maxSize: CGSizeMake(4800, 4800)) switch await placesClient.fetchPhoto(with: fetchPhotoRequest) { case .success(let uiImage): // Handle image. case .failure(let placesError): // Handle error }
Armazenamento em cache
As fotos carregadas usando [GMSPlacesClient loadPlacePhoto:callback:]
ou [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
são armazenadas em cache no disco e na memória pelo sistema de carregamento de URL básico
no NSURLCache
compartilhado.
Para configurar o comportamento de armazenamento em cache, altere o cache do URL compartilhado usando [NSURLCache setSharedURLCache:]
no método application:didFinishLaunchingWithOptions:
do delegado do aplicativo.
Se você não quiser que seu aplicativo compartilhe um NSURLCache
com o SDK do Places para iOS, crie um novo NSURLCache
e use-o exclusivamente no seu app sem defini-lo como o cache compartilhado.
Atribuições
Na maioria dos casos, fotos de lugares podem ser usadas sem atribuição ou a atribuição necessária vai ser incluída na imagem. No entanto, se a instância
GMSPlacePhotoMetadata
retornada incluir
attributions
ou
authorAttribution
,
será necessário incluir essas atribuições no aplicativo sempre que você exibir a
imagem. Consulte a documentação sobre
atribuições.