お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
Method: projects.locations.filmstripThumbnails.create
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
コレクション内の複数の画像を含む画像のレンダリングに使用できる ID を作成します。
これは GetFilmstripThumbnailPixels と組み合わせて使用します。filmstripThumbnails.create を呼び出すと、式といくつかの出力オプションが提供されます。filmstripThumbnails.create の結果は、その式を評価してオプションを適用した結果の画像を表す ID です。その後、GetFilmstripThumbnailPixels を呼び出して、ImageCollection のすべての要素を縦方向または横方向に連結した画像を取得できます。ID は一定期間（数時間）有効です。
リクエストは、ImageCollection 内のすべての画像にわたって、合計 512*512*100 ピクセルに制限されます。これらの上限を超えるリクエストは、エラーコード 400（BAD_REQUEST）になります。
HTTP リクエスト
POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/filmstripThumbnails
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
parent |
string
必須。フィルムストリップのサムネイルが作成されるロケーションの親（例: 「projects/*」）。
認可には、指定されたリソース parent に対する次の IAM の権限が必要です。
earthengine.filmstripthumbnails.create
|
クエリ パラメータ
| パラメータ |
workloadTag |
string
この計算をトラッキングするためにユーザーが指定したタグ。
|
リクエストの本文
リクエストの本文には FilmstripThumbnail のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された FilmstripThumbnail のインスタンスが含まれます。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/earthengine.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
詳細については、OAuth 2.0 Overview をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eGenerates an ID, usable with \u003ccode\u003eGetFilmstripThumbnailPixels\u003c/code\u003e, to render a single image composed of multiple images from an ImageCollection.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efilmstripThumbnails.create\u003c/code\u003e takes an expression and output options, returning an ID representing the combined image.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eGetFilmstripThumbnailPixels\u003c/code\u003e uses the ID to fetch the image, arranging ImageCollection elements vertically or horizontally.\u003c/p\u003e\n"],["\u003cp\u003eTotal pixel limit across all images is 512*512*100, exceeding this results in a 400 (BAD_REQUEST) error.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific IAM permission (\u003ccode\u003eearthengine.filmstripthumbnails.create\u003c/code\u003e) and one of the listed OAuth scopes for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.filmstripThumbnails.create\n\nCreates an ID that can be used to render an image containing multiple images from a collection.\n\nThis is used in conjunction with `GetFilmstripThumbnailPixels`. A call to `filmstripThumbnails.create` provides an expression and some output options. The result of `filmstripThumbnails.create` is an ID that represents an image that is the result of evaluating that expression and applying those options. Subsequently, calls to `GetFilmstripThumbnailPixels` can be made to get an image showing all of the elements of an ImageCollection, concatenated top-to-bottom or side-to-side. The ID will be valid for a moderate period (a few hours).\n\nThe request is limited to 512\\*512\\*100 pixels in total, across all Images in the ImageCollection. Requests exceeding these limits will result in an error code of 400 (BAD_REQUEST).\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{parent=projects/*/locations/*}/filmstripThumbnails`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent of the location where the filmstrip thumbnail will be created (e.g., \"projects/\\*\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `parent`: - `earthengine.filmstripthumbnails.create` |\n\n### Query parameters\n\n| Parameters ||\n|---------------|-------------------------------------------------------|\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Request body\n\nThe request body contains an instance of [FilmstripThumbnail](/earth-engine/reference/rest/v1/projects.filmstripThumbnails#FilmstripThumbnail).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [FilmstripThumbnail](/earth-engine/reference/rest/v1/projects.filmstripThumbnails#FilmstripThumbnail).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
