場所の写真（新規）

プラットフォームを選択: Android iOS ウェブサービス

場所の写真（新規）を使用すると、高画質の写真コンテンツをアプリに追加できます。プレイスフォトを使用すると、プレイス データベースに保存されている何百万もの写真を利用できます。Place Photos は、ビットマップ画像の URI を返します。ビットマップ画像の最大サイズは 4,800 x 4,800 ピクセルです。

注: プレイスの写真（新規）は、Places SDK for Android バージョン 3.4.0 以降で利用できます。詳細については、SDK バージョンを選択するをご覧ください。バージョン 4.0.0 で追加された Kotlin API の使用方法については、リファレンスの概要をご覧ください。

フォトの場所のリクエスト

場所の画像を取得するには:

1. Place Details（新規）を使用して、fetchPlace() を使用して Place オブジェクトを取得します。レスポンスの Place オブジェクトに含めるフィールドのリストに、Place.Field PHOTO_METADATAS フィールドを含めるようにしてください。
2. FetchPlaceResponse の OnSuccessListener で Place.getPhotoMetadas() を呼び出して、レスポンス Place オブジェクトから PhotoMetadata タイプの写真メタデータ オブジェクトを取得します。
3. FetchResolvedPhotoUriRequest オブジェクトを作成してリクエストを行い、写真のメタデータ オブジェクトと、最大高さ、最大幅、またはその両方の値を渡します。
4. PlacesClient.fetchResolvedPhotoUri() を使用して、写真の URI をリクエストします。
5. OnSuccessListener を追加し、FetchResolvedPhotoUriResponse オブジェクトから写真の URI を取得します。

注: PlacesClient の初期化について詳しくは、Places API クライアントを初期化するをご覧ください。

CancellationToken を使用して、任意のリクエストクラス（FetchPlaceRequest など）へのリクエストのキャンセルを試行できます。キャンセルはベスト エフォート ベースで実行されます。キャンセル リクエストが送信されると、レスポンスは返されません。キャンセル トークンを発行しても、特定のリクエストがキャンセルされるとは限りません。また、レスポンスが返されなくても、リクエストに対して料金が請求される場合があります。

必須パラメータ

FetchResolvedPhotoUriRequest に必要なパラメータは次のとおりです。

• 写真のメタデータ

  返される写真のメタデータ オブジェクト。

• 最大高さまたは最大幅

  返される画像の最大高と最大幅（ピクセル単位）を指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のいずれかのサイズが指定サイズより大きい場合は、元のアスペクト比を維持しながら、2 つのサイズのうち小さい方に合わせて画像が拡大されます。最大高と最大幅のプロパティの両方には、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 タイプの写真メタデータ オブジェクトには、次のいずれかのタイプの追加アトリビューションを含めることができます。

• アトリビューション: PhotoMetadata.getAttributions() によってアクセスされるアトリビューション文字列。
• AuthorAttributions: PhotoMetadata.getAuthorAttributions() によってアクセスされる AuthorAttributions オブジェクト。

返された PhotoMetadata オブジェクトにいずれかのタイプのアトリビューションが含まれている場合は、画像を表示するすべての場所にアプリにアトリビューションを含める必要があります。詳細については、アトリビューションの表示をご覧ください。