Możesz użyć pakietu SDK Miejsc na iOS (nowego), aby poprosić o wyświetlenie w aplikacji zdjęć miejsc. Zdjęcia zwracane w usłudze zdjęć pochodzą z różnych źródeł, m.in. od właścicieli firm i użytkowników.
Zdjęcia to obrazy bitmapowe reprezentowane przez obiekt UIImage. Maksymalny rozmiar obrazu bitmapy to 4800 x 4800 pikseli.
Poproś o obraz
Możesz poprosić o dodanie maksymalnie 10 zdjęć dla danego miejsca:
Wywołaj
[GMSPlacesClient lookUpPhotosForPlaceID]
, przesyłając identyfikator miejsca i wywołanie zwrotneGMSPlacePhotoMetadataResultCallback
. To żądanie wywołuje wywołanie zwrotneGMSPlacePhotoMetadataResultCallback
za pomocą obiektuGMSPlacePhotoMetadataList
.Właściwość tablicy
results
w obiekcieGMSPlacePhotoMetadataList
w wywołaniu zwrotnym zawiera zdjęcia, z których każde jest reprezentowane przez obiektGMSPlacePhotoMetadata
.Użyj obiektu
GMSPlacePhotoMetadata
, aby utworzyć obiektGMSFetchPhotoRequest
z maksymalnym rozmiarem żądanego obrazu.Dla każdego obiektu
GMSPlacePhotoMetadata
w tablicy wywołaj polecenie[GMSPlacesClient fetchPhotoWithRequest:callback:]
, które przekazuje obiektGMSFetchPhotoRequest
. Ta metoda wywołuje wywołanie zwrotneGMSFetchPhotoResultCallback
z użytecznym obrazem bitmapy jako UIImage.
Innym sposobem przesłania prośby o zdjęcia miejsca jest przesłanie prośby o szczegóły miejsca (nowe), w tym GMSPlacePropertyPhotos
na liście pól. Zaletą wywołania informacji o miejscu jest to, że obiekt odpowiedzi GMSPlace
może zawierać zdjęcia i inne wymagane pola danych związane z danym miejscem.
Przykładowy kod
Ta przykładowa metoda przejmuje identyfikator miejsca i pobiera pierwsze zdjęcie na liście zwracanych. Możesz użyć tej metody jako szablonu metody tworzonej we własnej aplikacji.
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 }
Zapisywanie w pamięci podręcznej
Zdjęcia wczytane przy użyciu [GMSPlacesClient loadPlacePhoto:callback:]
lub [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]
są zapisywane zarówno na dysku, jak i w pamięci przez system wczytywania adresu URL Fundation URL w udostępnionym NSURLCache
.
Aby skonfigurować działanie buforowania, możesz zmienić udostępnianą pamięć podręczną adresów URL za pomocą metody [NSURLCache setSharedURLCache:]
w metodzie application:didFinishLaunchingWithOptions:
delegata aplikacji.
Jeśli nie chcesz, aby Twoja aplikacja udostępniała obiekt NSURLCache
pakietowi SDK Miejsc na iOS, możesz utworzyć nowy NSURLCache
i używać go wyłącznie w aplikacji bez ustawiania go jako współdzielonej pamięci podręcznej.
Atrybucje
W większości przypadków zdjęcia miejsc można wykorzystać bez podawania informacji o autorze lub zawierają wymagane informacje o autorze. Jeśli jednak zwrócona instancja GMSPlacePhotoMetadata
zawiera dowolne wartości attributions
lub authorAttribution
, musisz uwzględnić te atrybucje w swojej aplikacji podczas wyświetlania obrazu. Zobacz dokumentację na temat atrybucji.