공지사항: 2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해 비상업용 자격 요건을 인증해야 합니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Earth Engine 할당량

할당량 유형

Earth Engine 플랫폼에는 리소스가 사용자 간에 공정하게 분배되도록 여러 할당량 제한이 적용되어 있습니다. Earth Engine에는 다양한 유형의 리소스 (계산, 스토리지 등)가 있으므로 다양한 유형의 할당량 한도가 있습니다.

다양한 할당량 유형의 주요 차이점은 조정 가능 여부입니다. 일부 할당량 유형의 경우 사용자별 또는 프로젝트별로 한도를 변경할 수 있지만, 다른 유형은 변경할 수 없는 시스템 전체 한도입니다.

조정 가능한 할당량 한도

다음 한도는 프로젝트별로 조정될 수 있습니다. 추가 할당량을 요청하는 방법은 도움말 페이지를 참고하세요.

할당량 유형	기본값 (프로젝트별)
최대 동시 요청 수(표준 엔드포인트)	동시 요청 40개
최대 동시 요청 수(대량 엔드포인트)	동시 요청 40개
최대 요청률 (프로젝트별)	100회/초 (6,000회/분)
최대 요청 속도 (계정당)	100회/초 (6,000회/분)
평균 동시 일괄 작업	2개 작업 (평균)
최대 애셋 저장공간	250GB
최대 애셋 수	10,000
일일 Earth Engine 컴퓨팅 시간(EECU-time)(초)	무제한

동시 대화형 요청

각 프로젝트는 할당량 한도까지 대화형 요청을 동시에 할 수 있습니다. 한도를 초과하면 Earth Engine에서 'HTTP 429: Too Many Requests' 오류를 반환합니다. 일반적으로 이러한 오류는 지수 백오프로 요청을 래핑하여 성공할 때까지 쿼리를 재시도하는 Earth Engine 클라이언트 라이브러리에 의해 처리됩니다. Earth Engine 클라이언트 라이브러리는 요청을 최대 5회까지 재시도합니다.

이러한 429 오류를 방지하려면 가능한 경우 중복 쿼리를 방지하기 위해 memcache를 사용하는 등 애플리케이션의 캐싱을 사용 설정하는 것이 좋습니다. 쿼리를 자동으로 재시도하지 않는 이전 버전의 Earth Engine 클라이언트 라이브러리를 사용하거나 5번의 재시도 후에도 쿼리가 완료되지 않는 경우 요청에 지수 백오프를 구현해야 할 수 있습니다.

요청 비율 (QPS)

Earth Engine은 동시 실행 한도 외에도 프로젝트 및 사용자 수준에서 대화형 요청의 비율을 제한합니다. 이러한 설정은 Cloud Console에서 조정할 수 있습니다.

동시 일괄 작업

일괄 작업은 대화형 요청보다 더 많은 리소스를 사용하므로 동시 로드 수가 제한됩니다.

Earth Engine을 비상업적으로 사용하는 경우 할당량 상향이 부여되지 않는 한 동시에 실행할 수 있는 최대 일괄 작업 수는 기본값으로 설정됩니다.

Earth Engine을 상업적으로 사용하는 경우 동시에 실행할 수 있는 최대 배치 작업 수는 요금제에 따라 결정되지만 프로젝트별 배치 작업 동시 실행 수 한도를 설정하여 더 낮출 수도 있습니다. 기본적으로 프로젝트의 배치 작업 동시 실행 제한은 프로젝트의 결제 계정에 구성된 요금제에서 허용하는 최댓값으로 설정됩니다. 프로젝트의 이 한도를 보거나 업데이트하려면 명령줄 도구 문서를 참고하세요.

애셋 스토리지 할당량

각 Earth Engine 애셋에는 바이트 단위로 측정되는 해당 데이터 저장소 크기가 있습니다. 애셋은 Cloud 프로젝트 또는 개인 (기존 애셋)이 소유할 수 있으며, 각 애셋은 소유자의 전체 스토리지 및 애셋 수에 대한 Earth Engine 한도에 포함됩니다.

EECU 시간/일

비용을 관리하려면 프로젝트가 Earth Engine에서 하루에 사용할 수 있는 EECU 시간의 양을 제한하면 됩니다. 기본적으로 이 할당량은 무제한입니다. 할당량 관리자는 earthengine.googleapis.com/daily_eecu_usage_time 할당량 측정항목을 필터링하여 Cloud 콘솔에서 이 한도를 설정할 수 있습니다. 이 할당량이 설정되면 프로젝트의 모든 사용자의 성공적인 Earth Engine 요청에서 사용된 EECU 시간이 누적됩니다. 할당량이 초과되면 다음 날 할당량이 재설정되거나 한도가 증가할 때까지 요청이 실패합니다. 이 할당량 설정에 관한 자세한 내용은 비용 관리 가이드를 참고하세요.

사용자 시트

Earth Engine을 상업적으로 사용하는 경우 각 구독 등급에는 사용자 시트가 포함되어 있으며, 추가 시트를 구매할 수도 있습니다.

서비스 관리자는 지정된 결제 주기 내에서 코드 편집기 사용자 수를 수용할 수 있는 시트 수를 구매해야 합니다.

FAQ

Q: 라이선스에 포함되는 사용자는 누구인가요?
A: 코드 편집기를 사용하여 Earth Engine 컴퓨팅 사용량을 실행하는 고유한 실제 사용자 (지도 타일 보기, 컴퓨팅 쿼리 전송 등)만 시트 한도에 포함됩니다.

Q: 사용자가 매달 변경되면 어떻게 되나요?
A: 시트는 특정 개인에게 할당되지 않으며 명명된 슬롯이 아닙니다. 특정 월의 개수를 초과하지 않는 한 개별 사용자 ID는 중요하지 않습니다.

Q: 서비스 계정은 어떻게 되나요?
A: 서비스 계정은 사용자 수에서 제외됩니다. 이러한 사용자는 컴퓨팅을 실행하는 실제 사용자로 간주되지 않습니다.

Q: Python을 통해 Earth Engine에 액세스하는 사용자는 어떻게 되나요?
A: Python API를 통해서만 Earth Engine에 액세스하고 코드 편집기를 사용하지 않는 사용자는 시트 사용량에 포함되지 않습니다. 시트 수는 Code Editor 사용량과 관련이 있습니다.

Q: 좌석은 어디에서 집계되나요?
A: 시트 수는 결제 계정 수준에서 적용됩니다. 코드 편집기를 사용하는 조직의 모든 실제 사용자는 결제 계정의 총 시트 수에 포함됩니다.

Q: 시트 한도를 초과하면 어떻게 되나요?
A: Google에서는 일관된 위반을 모니터링하고 청구 계정 수준에서 한도를 적용합니다.

Q: 사용 가능한 라이선스 수를 늘리거나 줄이려면 어떻게 해야 하나요?
A: 자세한 내용은 Earth Engine 가격 책정 페이지를 참고하세요.

고정 할당량 한도

이러한 유형의 할당량 한도는 플랫폼 수준에서 설정되므로 사용자별 또는 프로젝트별로 조정할 수 없습니다. 시간이 지나도 크게 변경되지 않을 가능성이 높습니다.

계산 시간

요청 유형에 따라 최대 기간이 다르며, 자세한 내용은 처리 환경 문서를 참고하세요.

시간 초과 오류를 해결하는 데 도움이 필요하면 디버깅 가이드를 참고하세요.

요청별 메모리 사용량

'사용자 메모리 한도 초과'로 인해 요청이 실패하면 허용된 메모리 사용량 내에서 Earth Engine이 대답을 계산할 수 없음을 의미합니다. EE 컴퓨팅 플랫폼에는 사용할 수 있는 RAM의 양이 제한되어 있으며 시스템의 안정성을 유지하기 위해 각 요청은 특정 양만 사용할 수 있습니다. 사용 가능한 최대 메모리 양은 요청 유형에 따라 달라지지만 (예: 지도 타일보다 배치 작업에 더 많은 메모리) 이는 시스템 전체 제한입니다.

메모리 오류를 수정하는 데 도움이 필요하면 디버깅 가이드를 참고하세요.

집계

Earth Engine 요청을 처리할 때 계산 집약적인 것으로 알려진 특정 유형의 하위 계산을 분리합니다. 이러한 하위 계산을 '집계'라고 하며 EE 시스템에서 특별히 처리됩니다. 집계 결과는 재계산을 방지하기 위해 캐시됩니다.

동시 집계

제어되지 않는 계산 팬아웃을 방지하기 위해 개별 사용자가 동시에 실행할 수 있는 집계 수가 제한되며 이는 변경할 수 없습니다. '동시 집계가 너무 많음'으로 인해 요청이 실패하는 경우 요청자가 동시에 실행되는 집계가 너무 많았다는 의미입니다.

동시 집계 오류를 해결하는 데 도움이 필요하면 디버깅 가이드를 참고하세요.

대규모 집계 결과

'계산된 값이 너무 큼' 오류로 요청이 실패하면 집계에서 캐시에 맞지 않는 너무 큰 결과가 반환된 것입니다. 계산된 결과의 크기 제한은 100MiB이며 이는 시스템 전체 제한입니다.

표 가져오기 한도

표 업로드 한도는 표 데이터 가져오기 가이드에 설명되어 있습니다.

요청 페이로드 크기

Earth Engine에 대한 단일 쿼리는 크기가 10MB로 제한됩니다. 이 한도는 일반적으로 셰이프 파일이나 GeoJSON 구조와 같이 쿼리에 인라인된 대량의 추가 데이터가 쿼리에 직접 포함된 경우에만 초과됩니다. 대신 이러한 객체를 업로드하여 FeatureCollection 애셋으로 변환하고 애셋 ID로 참조해야 합니다.

태스크 큐 길이

예약 대기 중인 태스크 (READY 상태)는 '태스크 큐'를 형성합니다. 각 프로젝트의 대기열은 최대 3,000개의 작업을 지원합니다. 즉, READY 상태의 작업이 3,000개를 초과할 수 없습니다.

BigQuery 래스터 함수 할당량 한도

ST_REGIONSTATS SQL 함수를 사용하는 경우와 같이 BigQuery에서 Earth Engine을 호출하는 경우 다음 할당량이 적용됩니다.

할당량 유형	기본값 (프로젝트별)
일일 BigQuery 슬롯 시간	1,260,000 슬롯초 (350슬롯시간)

일일 BigQuery 슬롯 시간

일일 BigQuery 슬롯 시간 할당량은 특정 프로젝트에 대해 특정 날짜에 BigQuery 래스터 함수가 Earth Engine에서 사용할 수 있는 슬롯 시간의 양을 제한할 수 있는 맞춤 할당량입니다. 일일 할당량은 실패한 쿼리를 포함한 모든 쿼리의 총 시간을 누적합니다. earthengine.googleapis.com/bigquery_slot_usage_time 측정항목 아래의 Cloud 콘솔에서 할당량을 확인할 수 있으며, 할당량 관리자가 값을 위아래로 조정할 수 있습니다. 기본값보다 큰 값으로 늘리려면 할당량 상향 요청을 만드세요. 이 요청은 자동으로 승인됩니다. 변경사항은 10분 이내에 적용됩니다.

이 할당량을 초과하면 BigQuery에서 다음과 같은 오류 메시지를 반환합니다.

From Earth Engine: Custom quota exceeded: Your usage exceeded the custom quota for'earthengine.googleapis.com/bigquery_slot_usage_time', which is adjustable by your administrator in the Google Cloud console: https://console.cloud.google.com/quotas/?project=_.

할당량을 초과하면 다음 날 할당량이 재설정되거나 관리자가 한도를 늘릴 때까지 ST_REGIONSTATS 호출이 실패합니다.