ee.Image.linkCollection

소스 이미지를 이미지 컬렉션의 일치하는 이미지에 연결합니다.

지정된 밴드 또는 메타데이터가 컬렉션에서 찾은 이미지의 소스 이미지에 추가되며, 밴드 또는 메타데이터가 이미 있는 경우 덮어쓰게 됩니다. 일치하는 이미지를 찾을 수 없는 경우 새로 추가되거나 업데이트된 밴드는 완전히 마스크 처리되고 새로 추가되거나 업데이트된 메타데이터는 null이 됩니다. 출력 범위는 소스 이미지 범위와 동일합니다.

소스 이미지와 컬렉션의 이미지가 특정 동등한 메타데이터 속성을 갖는 경우 일치하는 것으로 간주됩니다. 일치하는 컬렉션 이미지가 두 개 이상인 경우 선택되는 컬렉션 이미지는 임의로 지정됩니다. 기본적으로 이미지는 'system:index' 메타데이터 속성을 기준으로 일치됩니다.

이 연결 기능은 지정된 공유 메타데이터 속성을 기반으로 타겟 이미지에 밴드를 추가하는 편의 메서드이며 동일한 소스 이미지에 다른 처리/제품 생성을 적용하는 컬렉션 연결을 지원하기 위한 것입니다. '조인'이라고 하는 더 표현력이 풍부한 연결에 관한 자세한 내용은 https://developers.google.com/earth-engine/guides/joins_intro를 참고하세요.

사용	반환 값
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName)	이미지

인수	유형	세부정보
다음과 같은 경우: input	이미지	컬렉션에서 일치하는 이미지가 연결될 소스 이미지입니다.
imageCollection	ImageCollection	소스와 일치하는 이미지를 추출하기 위해 검색된 이미지 컬렉션입니다.
linkedBands	객체, 기본값: null	일치하는 이미지에서 추가하거나 업데이트할 밴드 이름 또는 밴드 이름 목록입니다.
linkedProperties	객체, 기본값: null	일치하는 이미지에서 추가하거나 업데이트할 메타데이터 속성 또는 속성 목록입니다.
matchPropertyName	문자열, 기본값: 'system:index'	일치 기준으로 사용할 메타데이터 속성 이름입니다.