Фотографии мест (новинка)

Выберите платформу: Веб-сервис Android iOS.

Для использования этой функции необходимо включить Places API (новое), новое поколение Places API. Дополнительные сведения см. в разделе Включение API .

Вы можете использовать Places SDK для iOS (новинка), чтобы запросить фотографии мест для отображения в вашем приложении. Фотографии, возвращаемые службой фотографий, поступают из различных источников, включая фотографии владельцев бизнеса и фотографии, предоставленные пользователями.

Фотографии — это растровые изображения, представленные объектом UIImage . Максимальный размер растрового изображения составляет 4800 на 4800 пикселей.

Запросить изображение

Для места можно запросить до 10 фотографий:

1. Вызовите [GMSPlacesClient lookUpPhotosForPlaceID] , передав идентификатор места и обратный вызов GMSPlacePhotoMetadataResultCallback . Этот запрос вызывает обратный вызов GMSPlacePhotoMetadataResultCallback с объектом GMSPlacePhotoMetadataList .

2. Из объекта GMSPlacePhotoMetadataList в обратном вызове свойство массива results содержит фотографии, где каждая фотография представлена ​​объектом GMSPlacePhotoMetadata .

3. Используйте объект GMSPlacePhotoMetadata , чтобы создать GMSFetchPhotoRequest , включая максимальный размер запрошенного изображения.

4. Для каждого объекта GMSPlacePhotoMetadata в массиве вызовите [GMSPlacesClient fetchPhotoWithRequest:callback:] передав объект GMSFetchPhotoRequest . Этот метод вызывает обратный вызов GMSFetchPhotoResultCallback с пригодным для использования растровым изображением в качестве UIImage.

Другой способ запросить фотографии места — сделать запрос «Сведения о месте (новый)» , включив GMSPlacePropertyPhotos в список полей. Преимущество вызова Place Details заключается в том, что ответный объект GMSPlace может содержать фотографии и любые другие поля данных, необходимые для этого места.

Примечание. Каждый раз, когда вы показываете фотографию места в своем приложении, обязательно соблюдайте правила атрибуции. Дополнительную информацию см. в разделе «Атрибуция» .

Пример кода

Следующий пример метода принимает идентификатор места и получает первую фотографию в возвращаемом списке. Вы можете использовать этот метод в качестве шаблона для метода, который вы создадите в своем собственном приложении.

Быстрый

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

Цель-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
    }
  }];
}];

Places Swift SDK для iOS (предварительная версия)

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

Кэширование

Фотографии, загруженные с помощью [GMSPlacesClient loadPlacePhoto:callback:] или [GMSPlacesClient loadPlacePhoto:constrainedToSize:scale:callback:] кэшируются как на диске, так и в памяти системой загрузки URL-адресов Foundation в общем NSURLCache .

Чтобы настроить поведение кэширования, вы можете изменить общий кэш URL-адресов, используя [NSURLCache setSharedURLCache:] в методе application application:didFinishLaunchingWithOptions: делегата вашего приложения.

Если вы не хотите, чтобы ваше приложение использовало NSURLCache совместно с Places SDK для iOS, вы можете создать новый NSURLCache и использовать его исключительно в своем приложении, не устанавливая его в качестве общего кеша.

Атрибуции

В большинстве случаев фотографии мест можно использовать без указания авторства или же оно будет включено в изображение как часть изображения. Однако если возвращенный экземпляр GMSPlacePhotoMetadata содержит какие-либо attributions или authorAttribution , вы должны включить эти сведения об авторстве в свое приложение, где бы вы ни отображали изображение. См. документацию по атрибуции .