'썸네일' 이미지를 렌더링하는 데 사용할 수 있는 ID를 만듭니다.
GetThumbnailPixels와 함께 사용됩니다. thumbnails.create 호출은 표현식과 일부 출력 옵션을 제공합니다. thumbnails.create의 결과는 해당 표현식을 평가하고 이러한 옵션을 적용한 결과인 이미지를 나타내는 ID입니다. 그런 다음 GetThumbnailPixels를 호출하여 결과 이미지 전체의 이미지 데이터를 가져올 수 있습니다. ID는 몇 시간 동안 유효합니다.
이 엔드포인트 쌍의 가장 일반적인 사용 사례는 thumbnails.create에 대한 POST를 통해 복잡한 표현식을 제공한 다음 GetThumbnailPixels에 대한 GET을 통해 계산된 이미지를 가져오는 것입니다. 이 두 부분으로 구성된 프로세스를 사용하면 ComputePixels보다 더 많은 상황에서 사용할 수 있습니다. 특히: - 인코딩된 이미지 바이트를 가져오려면 ComputePixels의 결과를 래핑 해제해야 합니다. GetThumbnailPixels의 결과는 브라우저에서 직접 표시할 수 있습니다. - ComputePixels는 적절한 범위의 OAuth 토큰을 사용하여 승인된 사용자만 호출할 수 있습니다. thumbnails.create에도 동일한 제한사항이 적용되지만 GetThumbnailPixels는 API 키가 포함된 URL로 호출할 수 있으므로 이를 호출하는 URL을 더 광범위하게 사용할 수 있습니다.
표현식 평가 결과는 요청된 이미지 형식에 대한 몇 가지 합리적인 요구사항을 충족해야 합니다. 특히 JPEG 또는 PNG 형식의 경우 출력 밴드가 1개 또는 3개여야 하며 0~255 범위를 벗어나는 클립 값이 있어야 합니다.
'썸네일'이라는 설명은 계산된 이미지의 크기에 대한 제한을 의미하지 않습니다. ComputePixels와 동일한 제한사항이 thumbnails.create/GetThumbnailPixels에도 적용됩니다. 요청은 요청당 비압축 데이터 48MB로 제한되며, 이는 요청 크기(픽셀), 요청된 이미지 밴드 수, 각 밴드의 픽셀당 바이트 수를 곱하여 계산됩니다. 요청은 둘 중 하나의 크기가 최대 32,000픽셀, 최대 1,024개 밴드로 제한됩니다. 이 한도를 초과하는 요청은 400 (BAD_REQUEST) 오류 코드를 발생시킵니다.
HTTP 요청
POST https://earthengine.googleapis.com/v1beta/{parent=projects/*/locations/*}/thumbnails
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
parent |
필수입니다. 썸네일 컬렉션의 상위 요소입니다 (예: 'projects/*')를 사용합니다. 승인을 처리하려면 지정된 리소스
|
쿼리 매개변수
| 매개변수 | |
|---|---|
workloadTag |
사용자가 이 계산을 추적하기 위해 제공한 태그입니다. |
요청 본문
요청 본문에 Thumbnail의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Thumbnail의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/earthenginehttps://www.googleapis.com/auth/earthengine.readonlyhttps://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/cloud-platform.read-only
자세한 내용은 OAuth 2.0 Overview를 참고하세요.