Place Photo(新規)を使用すると、質の高い写真コンテンツをアプリケーションに追加できます。プレイスフォトを使用すると、プレイス データベースに保存されている数百万枚の写真にアクセスできます。Place Photos は、ビットマップ画像の URI を返します。ビットマップ画像の最大サイズは 4,800 x 4,800 ピクセルです。
プレイス フォト リクエスト
プレイスの画像を取得するには:
- Place Details(新規)を使用して、
fetchPlace()
を使用してPlace
オブジェクトを取得します。レスポンスのPlace
オブジェクトに含めるフィールドのリストに、Place.Field PHOTO_METADATAS
フィールドを含めてください。 FetchPlaceResponse
のOnSuccessListener
でPlace.getPhotoMetadas()
を呼び出し、レスポンスPlace
オブジェクトからPhotoMetadata
タイプのフォト メタデータ オブジェクトを取得します。FetchResolvedPhotoUriRequest
オブジェクトを作成してリクエストを行い、写真のメタデータ オブジェクトと、最大高さ、最大幅、またはその両方の値を渡します。PlacesClient.fetchResolvedPhotoUri()
を使用して写真の URI をリクエストします。OnSuccessListener
を追加し、FetchResolvedPhotoUriResponse
オブジェクトから写真の URI を取得します。
必須パラメータ
FetchResolvedPhotoUriRequest
の必須パラメータは次のとおりです。
-
写真のメタデータ
返される写真のメタデータ オブジェクト。
-
最大高さまたは最大幅
返される画像の最大高さと幅をピクセル単位で指定します。画像が指定された値よりも小さい場合は、元の画像が返されます。画像の高さまたは幅が大きい場合は、元のアスペクト比に合わせて高さまたは幅のどちらか小さい方と一致するように縮小されます。最大高と最大幅のプロパティのどちらも、1 ~ 4,800 の整数を取ります。最大高さ、最大幅、またはその両方を指定する必要があります。
- 最大高パラメータを設定するには、
FetchResolvedPhotoUriRequest
オブジェクトを作成するときにsetMaxHeight()
メソッドを呼び出します。 - 最大幅パラメータを設定するには、
FetchResolvedPhotoUriRequest
オブジェクトを作成するときにsetMaxWidth()
メソッドを呼び出します。
- 最大高パラメータを設定するには、
プレイスフォトの例
次の例は、プレイスの写真の 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 and author attributions. final String attributions = photoMetadata.getAttributions(); final AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions(); // Create a FetchResolvedPhotoUriRequest. final FetchResolvedPhotoUriRequest photoRequest = FetchResolvedPhotoUriRequest.builder(photoMetadata) .setMaxWidth(500) .setMaxHeight(300) .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
型の写真メタデータ オブジェクトには、次の 2 種類の追加の帰属情報のいずれかを追加できます。
- アトリビューション:
PhotoMetadata.getAttributions()
によってアクセスされるアトリビューション文字列。 - AuthorAttributions:
PhotoMetadata.getAuthorAttributions()
によってアクセスされるAuthorAttributions
オブジェクト。
返された PhotoMetadata
オブジェクトにいずれかのタイプの帰属情報が含まれている場合は、画像を表示するたびにアプリケーションにその帰属情報を含める必要があります。詳細については、アトリビューションを表示するをご覧ください。