Вы можете использовать Places SDK для Android, чтобы запросить фотографию места для отображения в вашем приложении. Фотографии, возвращаемые службой фотографий, поступают из различных источников, включая фотографии владельцев бизнеса и фотографии, предоставленные пользователями.
Выберите формат фотографии
Places SDK для Android поддерживает два формата запрошенной фотографии:
- All Places SDK для версий Android: возвращает растровое изображение. Максимальный размер растрового изображения составляет 1600 на 1600 пикселей.
- Places SDK для Android (новая версия) 3.4 и более поздних версий: возвращает URI растрового изображения. Максимальный размер растрового изображения составляет 4800 на 4800 пикселей.
Процесс поиска фотографий
Чтобы получить изображение места:
- Используйте Place Details для получения объекта
Place
(используйтеfetchPlace()
илиfindCurrentPlace()
). Обязательно включите полеPlace.Field PHOTO_METADATAS
в список полей, которые будут включены в ответный объектPlace
. - В
OnSuccessListener
для вашегоFetchPlaceResponse
илиFindCurrentPlaceResponse
:- Используйте
Place.getPhotoMetadas()
, чтобы получить объект метаданных фотографии типаPhotoMetadata
из объекта ответаPlace
. - Чтобы получить растровое изображение:
- Создайте объект
FetchPhotoRequest
, при необходимости указав максимальную высоту и ширину (в пикселях). Фотографии могут иметь максимальную ширину или высоту 1600 пикселей. - Используйте
PlacesClient.fetchPhoto()
для запроса растрового изображения фотографии. - Добавьте
OnSuccessListener
и получите фотографию изFetchPhotoResponse
.
- Создайте объект
- Чтобы получить URI фотографии:
- Создайте объект
FetchResolvedPhotoUriRequest
для выполнения запроса. Фотографии могут иметь максимальную ширину или высоту 4800 пикселей. - Используйте
PlacesClient.fetchResolvedPhotoUri()
, чтобы запросить URI фотографии. - Добавьте
OnSuccessListener
и получите URI фотографии из объектаFetchResolvedPhotoUriResponse
.
- Создайте объект
- Используйте
Доступ к данным PhotoMetadata, добавленным в версии 3.3.0 и более поздних версиях.
Places SDK для Android (новинка) добавляет поле AuthorAttributions
в класс PhotoMetadata
. Если ваше приложение поддерживает новый SDK, то объект PhotoMetadata
, возвращаемый Place.getPhotoMetadas()
, может содержать одно или несколько указаний автора.
Если объект PhotoMetadata
содержит какие-либо сведения об авторстве, либо новые сведения об авторстве, добавленные в версии 3.3.0, либо существующие сведения об авторстве, доступные в версии 3.2.0 и более ранних версиях, вы должны отобразить их вместе с фотографией. Дополнительную информацию об обработке всех типов атрибуции см. в разделе Атрибуция .
Чтобы заполнить объект PhotoMetadata
сведениями об авторах, необходимо:
- Включите новый SDK при настройке проекта Google Cloud .
- Инициализируйте новый SDK внутри действия или фрагмента.
- Включите
Place.Field.PHOTO_METADATAS
в список полей запроса сведений о месте. - Вызовите
PlacesClient.fetchPlace()
, чтобы получить объектPlace
, иPlace.getPhotoMetadas()
, чтобы получить объектPhotoMetadata
. Поле авторства не поддерживаетсяPlacesClient.findCurrentPlace()
. - Используйте
PhotoMetadata.getAuthorAttributions()
, чтобы получить сведения об авторах.
Получить фото
В этом разделе описывается, как получить фотографию в виде растрового изображения или URI.
Получить фотографию места в виде растрового изображения
В следующем примере показано получение фотографии места в виде растрового изображения.
Котлин
// Define a Place ID. val placeId = "INSERT_PLACE_ID_HERE" // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. val fields = listOf(Place.Field.PHOTO_METADATAS) // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) val placeRequest = FetchPlaceRequest.newInstance(placeId, fields) placesClient.fetchPlace(placeRequest) .addOnSuccessListener { response: FetchPlaceResponse -> val place = response.place // Get the photo metadata. val metada = place.photoMetadatas if (metada == null || metada.isEmpty()) { Log.w(TAG, "No photo metadata.") return@addOnSuccessListener } val photoMetadata = metada.first() // Get the attribution text. val attributions = photoMetadata?.attributions // Create a FetchPhotoRequest. val photoRequest = FetchPhotoRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build() placesClient.fetchPhoto(photoRequest) .addOnSuccessListener { fetchPhotoResponse: FetchPhotoResponse -> val bitmap = fetchPhotoResponse.bitmap imageView.setImageBitmap(bitmap) }.addOnFailureListener { exception: Exception -> if (exception is ApiException) { Log.e(TAG, "Place not found: " + exception.message) val statusCode = exception.statusCode TODO("Handle error with given status code.") } } }
Джава
// Define a Place ID. final String placeId = "INSERT_PLACE_ID_HERE"; // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. final List<Place.Field> fields = Collections.singletonList(Place.Field.PHOTO_METADATAS); // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) final FetchPlaceRequest placeRequest = FetchPlaceRequest.newInstance(placeId, fields); placesClient.fetchPlace(placeRequest).addOnSuccessListener((response) -> { final Place place = response.getPlace(); // Get the photo metadata. final List<PhotoMetadata> metadata = place.getPhotoMetadatas(); if (metadata == null || metadata.isEmpty()) { Log.w(TAG, "No photo metadata."); return; } final PhotoMetadata photoMetadata = metadata.get(0); // Get the attribution text. final String attributions = photoMetadata.getAttributions(); // Create a FetchPhotoRequest. final FetchPhotoRequest photoRequest = FetchPhotoRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build(); placesClient.fetchPhoto(photoRequest).addOnSuccessListener((fetchPhotoResponse) -> { Bitmap bitmap = fetchPhotoResponse.getBitmap(); imageView.setImageBitmap(bitmap); }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { final ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } }); });
Получить URI фотографии места
В следующем примере показано получение URI фотографии места.
// Define a Place ID. final String placeId = "INSERT_PLACE_ID_HERE"; // Specify fields. Requests for photos must always have the PHOTO_METADATAS field. final List<Place.Field> fields = Collections.singletonList(Place.Field.PHOTO_METADATAS); // Get a Place object (this example uses fetchPlace(), but you can also use findCurrentPlace()) final FetchPlaceRequest placeRequest = FetchPlaceRequest.newInstance(placeId, fields); placesClient.fetchPlace(placeRequest).addOnSuccessListener((response) -> { final Place place = response.getPlace(); // Get the photo metadata. final List<PhotoMetadata> metadata = place.getPhotoMetadatas(); if (metadata == null || metadata.isEmpty()) { Log.w(TAG, "No photo metadata."); return; } final PhotoMetadata photoMetadata = metadata.get(0); // Get the attribution text. final String attributions = photoMetadata.getAttributions(); // Create a FetchResolvedPhotoUriRequest. final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) // Optional. .setMaxHeight(300) // Optional. .build(); // Request the photo URI placesClient.fetchResolvedPhotoUri(photoRequest).addOnSuccessListener((fetchResolvedPhotoUriResponse) -> { Uri uri = fetchResolvedPhotoUriResponse.getUri(); RequestOptions requestOptions = new RequestOptions().override(Target.SIZE_ORIGINAL); Glide.with(this).load(uri).apply(requestOptions).into(imageView); }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { final ApiException apiException = (ApiException) exception; Log.e(TAG, "Place not found: " + exception.getMessage()); final int statusCode = apiException.getStatusCode(); // TODO: Handle error with given status code. } }); });
Атрибуции
В большинстве случаев фотографии мест можно использовать без указания авторства или же оно будет включено в изображение как часть изображения. Однако объект метаданных фотографии типа PhotoMetadata
может содержать любой из двух типов дополнительных атрибутов:
- Attributions — строка атрибуции, доступная с помощью
PhotoMetadata.getAttributions()
. - AuthorAttributions — объект
AuthorAttributions
, доступ к которому осуществляетсяPhotoMetadata.getAuthorAttributions()
.
Если возвращенный объект PhotoMetadata
включает в себя любой тип атрибуции, вы должны включить атрибуцию в свое приложение, где бы вы ни отображали изображение. Дополнительную информацию см. в разделе «Отображение авторства» .
Использование и выставление счетов
SKU Places Photo взимается за вызовы fetchPhoto()
. Подробности см. на странице «Использование и выставление счетов» .