Zdjęcia miejsc (nowe)

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:

  1. Wywołaj [GMSPlacesClient lookUpPhotosForPlaceID], przesyłając identyfikator miejsca i wywołanie zwrotne GMSPlacePhotoMetadataResultCallback. To żądanie wywołuje wywołanie zwrotne GMSPlacePhotoMetadataResultCallback za pomocą obiektu GMSPlacePhotoMetadataList.

  2. Właściwość tablicy results w obiekcie GMSPlacePhotoMetadataList w wywołaniu zwrotnym zawiera zdjęcia, z których każde jest reprezentowane przez obiekt GMSPlacePhotoMetadata.

  3. Dla każdego obiektu GMSPlacePhotoMetadata w tablicy wywołaj [GMSPlacesClient loadPlacePhoto:callback:] lub [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:]. Te metody wywołują wywołanie zwrotne z użyciem obrazu bitmapy jako interfejsu 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 = photos.first else { return }

  // Request individual photos in the response list
  let fetchPhotoRequest = GMSFetchPhotoRequest(metadata: photoMetadata, maxSize: CGSizeMake(4800, 4800)
  placesClient.fetchPhoto(fetchPhotoRequest: fetchPhotoRequest, callback: {
    (photoURL: URL?, error: Error?) in
      guard let photoURL, error == nil else { return }
      print("Photo URL: \(photoURL)")
  })
};

Objective-C

// A hotel in Saigon with an attribution.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

[placesClient lookUpPhotosForPlaceID:placeID callback: (GMSPlacePhotoMetadataList *list, NSError *error) {
  GMSPlacePhotoMetadata *photoMetadata = [list firstObject];

  if (photoMetadata == nil) { return }

  // Request individual photos in the response list
  GMSFetchPhotoRequest *fetchPhotoRequest = [[GMSFetchPhotoRequest alloc] initWithPhotoMetadata:photoMetadata maxSize:CGSizeMake(4800, 4800)];
  [placesClient fetchPhoto:fetchPhotoRequest, callback: ^(NSURL *_Nullable photoURL, NSError *_Nullable error) {
    if (error == null) {
      NSLog(@"Photo URL: %@", photoURL)
    }
  }];
}];

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.