Zdjęcia miejsc (nowe)

Za pomocą pakietu Places SDK na iOS (nowego) możesz przesyłać żądania zdjęć miejsc, które będą wyświetlane w Twojej aplikacji. Zdjęcia zwracane przez usługę zdjęć pochodzą z różnych źródeł, w tym od właścicieli firm i użytkowników.

Zdjęcia to obrazy bitmapowe reprezentowane przez obiekt UIImage. Obraz bitmapowy może mieć maksymalnie 4800 x 4800 pikseli.

Prośba o obraz

Możesz poprosić o maksymalnie 10 zdjęć miejsca:

1. Wywołaj funkcję Call [GMSPlacesClient lookUpPhotosForPlaceID], przekazując identyfikator miejsca i funkcję zwrotną GMSPlacePhotoMetadataResultCallback. To żądanie wywołuje wywołanie zwrotne GMSPlacePhotoMetadataResultCallback z obiektem GMSPlacePhotoMetadataList.

2. Obiekt GMSPlacePhotoMetadataList w wywołaniu zwrotnym zawiera właściwość tablicy results, która zawiera zdjęcia. Każde zdjęcie jest reprezentowane przez obiekt GMSPlacePhotoMetadata.

3. Użyj obiektu GMSPlacePhotoMetadata, aby utworzyć GMSFetchPhotoRequest, w tym maksymalny rozmiar żądanego obrazu.

4. Dla każdego obiektu GMSPlacePhotoMetadata w tablicy wywołaj funkcję [GMSPlacesClient fetchPhotoWithRequest:callback:] przekazując obiekt GMSFetchPhotoRequest. Ta metoda wywołuje wywołanie zwrotne GMSFetchPhotoResultCallback z użytecznym obrazem bitmapowym jako UIImage.

Innym sposobem na przesłanie prośby o zdjęcia miejsca jest wysłanie żądania Place Details (New) (Szczegóły miejsca – nowa wersja) z uwzględnieniem GMSPlacePropertyPhotos na liście pól. Zaletą wywołania Place Details jest to, że obiekt odpowiedzi GMSPlace może zawierać zdjęcia i inne pola danych, które chcesz uzyskać dla danego miejsca.

Przykładowy kod

Poniższa przykładowa metoda pobiera identyfikator miejsca i uzyskuje pierwsze zdjęcie na liście zwróconej przez interfejs API. Możesz użyć tej metody jako szablonu metody, którą utworzysz we własnej aplikacji.

// 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
}

// 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: ")
    }
  )
}

// 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
    }
  }];
}];

Pamięć podręczna

Zdjęcia wczytywane za pomocą [GMSPlacesClient loadPlacePhoto:callback:] lub [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] są buforowane na dysku i w pamięci przez system wczytywania adresów URL Foundation w udostępnionym NSURLCache.

Aby skonfigurować działanie pamięci podręcznej, możesz zmienić udostępnioną pamięć podręczną adresów URL za pomocą funkcji [NSURLCache setSharedURLCache:] w metodzie application:didFinishLaunchingWithOptions: delegata aplikacji.

Jeśli nie chcesz, aby Twoja aplikacja udostępniała NSURLCache pakietowi Places SDK na iOS, możesz utworzyć nowy NSURLCache i używać go wyłącznie w aplikacji bez ustawiania go jako pamięci podręcznej udostępnianej.

Atrybucje

W większości przypadków zdjęć miejsc można używać bez podawania atrybucji lub wymagana atrybucja jest dołączana do obrazu. Jeśli jednak zwrócona instancja GMSPlacePhotoMetadata zawiera attributions lub authorAttribution, musisz umieścić te informacje o autorstwie w aplikacji wszędzie tam, gdzie wyświetlasz obraz. Więcej informacji znajdziesz w dokumentacji dotyczącej atrybucji.