Earth Engine은 공유 컴퓨팅 리소스를 보호하고 모든 사용자에게 안정적인 성능을 보장하기 위해
비상업적 할당량 등급을 도입합니다. 모든 비상업용 프로젝트는
2026년 4월 27일까지 할당량 등급을 선택해야 하며, 선택하지 않으면 커뮤니티 등급이 기본적으로 사용됩니다. 등급 할당량은 등급 선택 날짜와 관계없이
2026년 4월 27일에 모든 프로젝트에 적용됩니다.
자세히 알아보기
ee.Number.byte
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
입력 값을 부호 없는 8비트 정수로 변환합니다.
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: input | 숫자 | 입력 값입니다. |
예
코드 편집기 (JavaScript)
// Cast a number to unsigned 8-bit integer: [0, 255].
var number = ee.Number(100);
print('Number:', number);
var byteNumber = number.byte();
print('Number cast to byte:', byteNumber);
/**
* Casting numbers to byte that are outside of its range and precision can
* modify the resulting value, note the behavior of the following scenarios.
*/
// A floating point number cast to byte loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToByte = float.byte();
print('Floating point value cast to byte:', floatToByte);
// A number greater than byte range max cast to byte becomes byte range max.
var BYTE_MAX = 255;
var outOfRangeHi = ee.Number(BYTE_MAX + 12345);
print('Greater than byte max:', outOfRangeHi);
var outOfRangeHiToByte = outOfRangeHi.byte();
print('Greater than byte max cast to byte becomes byte max:', outOfRangeHiToByte);
// A number greater than byte range min cast to byte becomes byte range min.
var BYTE_MIN = 0;
var outOfRangeLo = ee.Number(BYTE_MIN - 12345);
print('Less than byte min:', outOfRangeLo);
var outOfRangeLoToByte = outOfRangeLo.byte();
print('Less than byte min cast to byte becomes byte min:', outOfRangeLoToByte);
Python 설정
Python API 및 geemap를 사용한 대화형 개발에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
# Cast a number to unsigned 8-bit integer: [0, 255].
number = ee.Number(100)
display('Number:', number)
byte_number = number.byte()
display('Number cast to byte:', byte_number)
"""Casting numbers to byte that are outside of its range and precision can
modify the resulting value, note the behavior of the following scenarios.
"""
# A floating point number cast to byte loses decimal precision.
float_number = ee.Number(1.7)
display('Floating point value:', float_number)
float_to_byte = float_number.byte()
display('Floating point value cast to byte:', float_to_byte)
# A number greater than byte range max cast to byte becomes byte range max.
BYTE_MAX = 255
out_of_range_hi = ee.Number(BYTE_MAX + 12345)
display('Greater than byte max:', out_of_range_hi)
out_of_range_hi_to_byte = out_of_range_hi.byte()
display('Greater than byte max cast to byte becomes byte max:',
out_of_range_hi_to_byte)
# A number greater than byte range min cast to byte becomes byte range min.
BYTE_MIN = 0
out_of_range_lo = ee.Number(BYTE_MIN - 12345)
display('Less than byte min:', out_of_range_lo)
out_of_range_lo_to_byte = out_of_range_lo.byte()
display('Less than byte min cast to byte becomes byte min:',
out_of_range_lo_to_byte)
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-10-30(UTC)
[null,null,["최종 업데이트: 2025-10-30(UTC)"],[],["The `byte()` method casts a number to an unsigned 8-bit integer, ranging from 0 to 255. Floating-point numbers lose decimal precision when cast. Numbers exceeding the byte range maximum (255) are capped at 255, and those below the minimum (0) become 0. The input value is cast to this range, modifying its value if outside of 0-255.\n"]]