공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
Method: projects.thumbnails.create
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
'썸네일' 이미지를 렌더링하는 데 사용할 수 있는 ID를 만듭니다.
thumbnails.getPixels와 함께 사용됩니다. thumbnails.create 호출은 표현식과 일부 출력 옵션을 제공합니다. thumbnails.create의 결과는 해당 표현식을 평가하고 이러한 옵션을 적용한 결과인 이미지를 나타내는 ID입니다. 그런 다음 thumbnails.getPixels를 호출하여 결과 이미지 전체의 이미지 데이터를 가져올 수 있습니다. ID는 몇 시간 동안 유효합니다.
이 엔드포인트 쌍의 가장 일반적인 사용 사례는 thumbnails.create에 대한 POST를 통해 복잡한 표현식을 제공한 다음 thumbnails.getPixels에 대한 GET을 통해 계산된 이미지를 가져오는 것입니다. 이 두 부분으로 구성된 프로세스를 사용하면 ComputePixels보다 더 많은 상황에서 사용할 수 있습니다. 특히: - 인코딩된 이미지 바이트를 가져오려면 ComputePixels의 결과를 래핑 해제해야 합니다. thumbnails.getPixels의 결과는 브라우저에서 직접 표시할 수 있습니다. - ComputePixels는 적절한 범위의 OAuth 토큰을 사용하여 승인된 사용자만 호출할 수 있습니다. thumbnails.create에도 동일한 제한사항이 적용되지만 thumbnails.getPixels는 API 키가 포함된 URL로 호출할 수 있으므로 이를 호출하는 URL을 더 광범위하게 사용할 수 있습니다.
표현식 평가 결과는 요청된 이미지 형식에 대한 몇 가지 합리적인 요구사항을 충족해야 합니다. 특히 JPEG 또는 PNG 형식의 경우 출력 밴드가 1개 또는 3개여야 하며 0~255 범위를 벗어나는 클립 값이 있어야 합니다.
'썸네일'이라는 설명은 계산된 이미지의 크기에 대한 제한을 의미하지 않습니다. ComputePixels와 동일한 제한사항이 thumbnails.create/thumbnails.getPixels에도 적용됩니다. 요청은 요청당 비압축 데이터 48MB로 제한되며, 이는 요청 크기(픽셀), 요청된 이미지 밴드 수, 각 밴드의 픽셀당 바이트 수를 곱하여 계산됩니다. 요청은 둘 중 하나의 크기가 최대 32,000픽셀, 최대 1,024개 밴드로 제한됩니다. 이 한도를 초과하는 요청은 400 (BAD_REQUEST) 오류 코드를 발생시킵니다.
HTTP 요청
POST https://earthengine.googleapis.com/v1/{parent=projects/*}/thumbnails
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
parent |
string
필수입니다. 썸네일 컬렉션의 상위 요소입니다 (예: 'projects/*')를 사용합니다.
승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.
earthengine.thumbnails.create
|
쿼리 매개변수
| 매개변수 |
workloadTag |
string
사용자가 이 계산을 추적하기 위해 제공한 태그입니다.
|
요청 본문
요청 본문에 Thumbnail의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Thumbnail의 인스턴스가 포함됩니다.
승인 범위
다음 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를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003e\u003ccode\u003ethumbnails.create\u003c/code\u003e generates an ID representing an image created from a provided expression and output options, which can then be used with \u003ccode\u003ethumbnails.getPixels\u003c/code\u003e to retrieve the image data.\u003c/p\u003e\n"],["\u003cp\u003eThis two-step approach enables broader usage scenarios, including direct browser display and API key-based access for \u003ccode\u003ethumbnails.getPixels\u003c/code\u003e, compared to \u003ccode\u003eComputePixels\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eWhile called "thumbnail," the generated images are subject to the same size and format constraints as \u003ccode\u003eComputePixels\u003c/code\u003e, including limits on dimensions, bands, and data size.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for \u003ccode\u003ethumbnails.create\u003c/code\u003e requires specific IAM permissions, while \u003ccode\u003ethumbnails.getPixels\u003c/code\u003e can be invoked with an API key for wider accessibility.\u003c/p\u003e\n"],["\u003cp\u003eThe resulting image format must meet certain requirements, such as having one or three output bands and clipping values for JPEG or PNG formats.\u003c/p\u003e\n"]]],["`thumbnails.create` generates an ID representing an image derived from an expression and output options. `thumbnails.getPixels`, using this ID, retrieves the image data. This two-part process allows for broader use compared to `ComputePixels` as `thumbnails.getPixels` can use an API key in the URL, while both methods are limited to 48MB of uncompressed data per request. Valid output formats such as JPEG or PNG must follow output band constraints and value ranges.\n"],null,["# Method: projects.thumbnails.create\n\nCreates an ID that can be used to render a \"thumbnail\" image.\n\nThis is used in conjunction with `thumbnails.getPixels`. A call to `thumbnails.create` provides an expression and some output options. The result of `thumbnails.create` is an ID that represents an image that is the result of evaluating that expression and applying those options. Subsequently, calls to `thumbnails.getPixels` can be made to get the image data for the entire resulting image. The ID will be valid for a moderate period (a few hours).\n\nThe most common use case for this pair of endpoints is to provide a complex expression via a POST to `thumbnails.create`, and then fetch the computed image via a GET to `thumbnails.getPixels`. This two-part process allows for use in more situations than `ComputePixels`. In particular: - the result of `ComputePixels` needs to be unwrapped to get the encoded image bytes. The result of `thumbnails.getPixels` can be displayed directly by a browser. - `ComputePixels` can only be called by an authorised user, using a properly-scoped OAuth token. `thumbnails.create` has the same restriction, but `thumbnails.getPixels` can be invoked with a URL containing an API key, so URLs invoking it can be used more broadly.\n\nThe result of evaluating the expression has to meet some reasonable requirements for the requested image format. In particular, JPEG or PNG format requires that there be one or three output bands, and clips values that are outside the 0-255 range.\n\nThe description \"thumbnail\" does not imply a restriction on the size of the computed image: the same restrictions as `ComputePixels` apply to `thumbnails.create`/`thumbnails.getPixels`. Requests are limited to 48MB in uncompressed data per request, computed as the product of the request dimensions in pixels, the number of image bands requested, and the number of bytes per pixel for each band. Requests are also limited to at most 32K pixels in either dimension and at most 1024 bands. 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/*}/thumbnails`\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 thumbnail collection (e.g., \"projects/\\*\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `parent`: - `earthengine.thumbnails.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 [Thumbnail](/earth-engine/reference/rest/v1/projects.locations.thumbnails#Thumbnail).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Thumbnail](/earth-engine/reference/rest/v1/projects.locations.thumbnails#Thumbnail).\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)."]]
