공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
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' | 일치 기준으로 사용할 메타데이터 속성 이름입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eLinks a source image to a matching image within a specified image collection based on a shared metadata property, such as 'system:index'.\u003c/p\u003e\n"],["\u003cp\u003eIf a match is found, it adds or overwrites bands and metadata from the collection image to the source image, otherwise, new bands are masked and metadata is nulled.\u003c/p\u003e\n"],["\u003cp\u003ePrimarily used to link collections with varied processing applied to the same base imagery, providing a streamlined method for band and metadata integration.\u003c/p\u003e\n"],["\u003cp\u003eOffers basic linking functionality; for more complex scenarios requiring joins, refer to the Earth Engine guide on joins.\u003c/p\u003e\n"],["\u003cp\u003eThe output maintains the source image's footprint regardless of the linking outcome.\u003c/p\u003e\n"]]],["The `linkCollection` function links a source image to a matching image from a collection based on a shared metadata property, defaulting to 'system:index'. It adds or overwrites specified bands and metadata from the matched collection image onto the source image. If no match is found, new or updated bands are masked, and metadata is null. The function accepts arguments for the collection, bands, metadata properties to link, and the match property name. The output footprint matches the source image.\n"],null,["# ee.Image.linkCollection\n\nLinks the source image to a matching image from an image collection.\n\n\u003cbr /\u003e\n\nAny specified bands or metadata will be added to the source image from the image found in the collection, and if the bands or metadata are already present they will be overwritten. If a matching image is not found, any new or updated bands will be fully masked and any new or updated metadata will be null. The output footprint will be the same as the source image footprint.\n\nA match is determined if the source image and an image in the collection have a specific equivalent metadata property. If more than one collection image would match, the collection image selected is arbitrary. By default, images are matched on their 'system:index' metadata property.\n\nThis linking function is a convenience method for adding bands to a target image based on a specified shared metadata property and is intended to support linking collections that apply different processing/product generation to the same source imagery. For more expressive linking known as 'joining', see https://developers.google.com/earth-engine/guides/joins_intro.\n\n| Usage | Returns |\n|---------------------------------------------------------------------------------------------------------|---------|\n| Image.linkCollection`(imageCollection, `*linkedBands* `, `*linkedProperties* `, `*matchPropertyName*`)` | Image |\n\n| Argument | Type | Details |\n|---------------------|---------------------------------|-------------------------------------------------------------------------------------|\n| this: `input` | Image | The source image a matching image in the collection will be linked to. |\n| `imageCollection` | ImageCollection | The image collection searched to extract an image matching the source. |\n| `linkedBands` | Object, default: null | A band name or list of band names to add or update from the matching image. |\n| `linkedProperties` | Object, default: null | A metadata property or list of properties to add or update from the matching image. |\n| `matchPropertyName` | String, default: \"system:index\" | The metadata property name to use as a match criteria. |"]]
