Method: places.photos.getMedia

写真の参照文字列を使用してフォトメディアを取得します。

HTTP リクエスト

GET https://places.googleapis.com/v1/{name=places/*/photos/*/media}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。フォトメディアのリソース名。形式は places/{placeId}/photos/{photo_reference}/media です。

プレイス オブジェクトの photos.name フィールドで返される写真のリソース名は places/{placeId}/photos/{photo_reference} の形式です。写真メディアのリソース名を取得するには、写真リソースの末尾に /media を追加する必要があります。

クエリ パラメータ

パラメータ
maxWidthPx

integer

省略可。画像の最大幅をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のサイズが大きい場合は、元のアスペクト比に合わせて、2 つのサイズのどちらか小さい方に合わせて拡大縮小されます。maxHeightPx プロパティと maxWidthPx プロパティはどちらも、1 ~ 4, 800 の整数を取ります。値が許容範囲内にない場合は、INVALID_ARGUMENT エラーが返されます。

maxHeightPx または maxWidthPx の少なくとも 1 つを指定する必要があります。maxHeightPx と maxWidthPx のどちらも指定されていない場合は、INVALID_ARGUMENT エラーが返されます。

maxHeightPx

integer

省略可。画像の高さの最大値をピクセル単位で指定します。画像が指定された値より小さい場合は、元の画像が返されます。画像のサイズが大きい場合は、元のアスペクト比に合わせて、2 つのサイズのどちらか小さい方に合わせて拡大縮小されます。maxHeightPx プロパティと maxWidthPx プロパティはどちらも、1 ~ 4, 800 の整数を取ります。値が許容範囲内にない場合は、INVALID_ARGUMENT エラーが返されます。

maxHeightPx または maxWidthPx の少なくとも 1 つを指定する必要があります。maxHeightPx と maxWidthPx のどちらも指定されていない場合は、INVALID_ARGUMENT エラーが返されます。

skipHttpRedirect

boolean

省略可。設定した場合、デフォルトの HTTP リダイレクト動作をスキップし、テキスト形式(HTTP ユースケースの JSON 形式など)のレスポンスをレンダリングします。設定しない場合、呼び出しを画像メディアにリダイレクトするために HTTP リダイレクトが実行されます。このオプションは、HTTP 以外のリクエストでは無視されます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

Places API の写真メディア。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "name": string,
  "photoUri": string
}
フィールド
name

string

フォトメディアのリソース名。形式は places/{placeId}/photos/{photo_reference}/media です。

photoUri

string

写真のレンダリングに使用できる有効期間の短い URI。