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 wyjściowy 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ą równoważną 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 zaawansowanym łączeniu, czyli „dołączaniu”, 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, z którym połączony będzie pasujący obraz 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. |