Wszystkie określone pasma lub metadane zostaną dodane do obrazu źródłowego z obrazu znalezionego w kolekcji. Jeśli pasma lub metadane są już obecne, zostaną zastąpione. Jeśli nie zostanie znaleziony pasujący obraz, wszystkie nowe lub zaktualizowane pasma zostaną w pełni zamaskowane, a wszystkie nowe lub zaktualizowane metadane będą miały wartość null. Obszar danych wyjściowych będzie taki sam jak obszar obrazu źródłowego.
Dopasowanie jest określane, jeśli obraz źródłowy i obraz w kolekcji mają konkretną właściwość metadanych. Jeśli pasuje więcej niż 1 obraz kolekcji, wybrany obraz jest wybierany losowo. Domyślnie obrazy są dopasowywane na podstawie właściwości metadanych „system:index”.
Ta funkcja łączenia to wygodna metoda dodawania pasm do obrazu docelowego na podstawie określonej wspólnej właściwości metadanych. Ma ona na celu obsługę łączenia kolekcji, które stosują różne metody przetwarzania lub generowania produktów do tych samych obrazów źródłowych. Więcej informacji o bardziej ekspresywnym łączeniu, zwanym „łączeniem”, znajdziesz na stronie https://developers.google.com/earth-engine/guides/joins_intro.
| Wykorzystanie | Zwroty |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Obraz |
| Argument | Typ | Szczegóły |
|---|---|---|
to: input | Obraz | Obraz źródłowy zostanie połączony z pasującym obrazem w kolekcji. |
imageCollection | ImageCollection | Kolekcja obrazów, w której wyszukiwany jest obraz pasujący do źródła. |
linkedBands | Obiekt, domyślnie: null | Nazwa zespołu lub lista nazw zespołów do dodania lub zaktualizowania na podstawie pasującego obrazu. |
linkedProperties | Obiekt, domyślnie: null | Właściwość metadanych lub lista właściwości do dodania lub zaktualizowania na podstawie pasującego obrazu. |
matchPropertyName | Ciąg znaków, domyślnie: „system:index” | Nazwa właściwości metadanych, która ma być używana jako kryterium dopasowania. |