공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Image.getThumbURL
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 이미지의 썸네일 URL을 가져옵니다.
썸네일 URL을 반환합니다. 콜백이 지정된 경우 undefined를 반환합니다.
| 사용 | 반환 값 |
|---|
Image.getThumbURL(params, callback) | 객체|문자열 |
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: image | 이미지 | 이미지 인스턴스입니다. |
params | 객체 | ee.data.getMapId와 동일한 매개변수와 선택적으로 다음이 추가됩니다.
dimensions (WIDTHxHEIGHT 형식의 숫자 또는 숫자 쌍) 렌더링할 썸네일의 최대 크기(픽셀)입니다. 하나의 숫자만 전달되면 최댓값으로 사용되고 다른 측정기준은 비례 조정으로 계산됩니다. |
region 렌더링할 이미지의 지리 공간적 영역입니다. ee.Geometry, GeoJSON 또는 위도/경도 포인트 배열 (E,S,W,N)일 수 있습니다. 설정하지 않으면 기본값은 경계 이미지입니다. |
format (문자열) 'png' 또는 'jpg'입니다. |
|
callback | 함수(선택사항) | 선택적 콜백입니다. 제공되지 않으면 호출이 동기적으로 이루어집니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eThe \u003ccode\u003eImage.getThumbURL\u003c/code\u003e function retrieves a thumbnail URL for a given image, offering options to customize dimensions, region, and format.\u003c/p\u003e\n"],["\u003cp\u003eThis function accepts parameters similar to \u003ccode\u003eee.data.getMapId\u003c/code\u003e to specify the desired thumbnail characteristics.\u003c/p\u003e\n"],["\u003cp\u003eUsers can provide a callback function for asynchronous execution or receive the URL directly in a synchronous call.\u003c/p\u003e\n"],["\u003cp\u003eThe thumbnail size can be controlled by specifying dimensions, with proportional scaling applied if only one dimension is given.\u003c/p\u003e\n"],["\u003cp\u003eThe region of the image to be included in the thumbnail can be defined using various geometry formats, defaulting to the image bounds if not specified.\u003c/p\u003e\n"]]],[],null,["# ee.Image.getThumbURL\n\n\u003cbr /\u003e\n\nGet a thumbnail URL for this image.\n\n\u003cbr /\u003e\n\nReturns a thumbnail URL, or undefined if a callback was specified.\n\n| Usage | Returns |\n|-------------------------------------------|----------------|\n| Image.getThumbURL`(params, `*callback*`)` | Object\\|String |\n\n| Argument | Type | Details |\n|---------------|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The Image instance. |\n| `params` | Object | Parameters identical to ee.data.getMapId, plus, optionally: |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ` dimensions ` (a number or pair of numbers in format WIDTHxHEIGHT) Maximum dimensions of the thumbnail to render, in pixels. If only one number is passed, it is used as the maximum, and the other dimension is computed by proportional scaling. | | ` region ` Geospatial region of the image to render, it may be an ee.Geometry, GeoJSON, or an array of lat/lon points (E,S,W,N). If not set the default is the bounds image. | | ` format ` (string) Either 'png' or 'jpg'. | |\n| `callback` | Function, optional | An optional callback. If not supplied, the call is made synchronously. |"]]
