Le bande o i metadati specificati verranno aggiunti all'immagine di origine dall'immagine trovata nella raccolta e, se le bande o i metadati sono già presenti, verranno sovrascritti. Se non viene trovata un'immagine corrispondente, le nuove bande o quelle aggiornate verranno completamente mascherate e i nuovi metadati o quelli aggiornati saranno nulli. L'impronta dell'output sarà la stessa dell'impronta dell'immagine di origine.
Una corrispondenza viene determinata se l'immagine di origine e un'immagine nella raccolta hanno una proprietà di metadati equivalente specifica. Se corrispondono più immagini della raccolta, quella selezionata è arbitraria. Per impostazione predefinita, le immagini vengono abbinate in base alla proprietà dei metadati "system:index".
Questa funzione di collegamento è un metodo pratico per aggiungere bande a un'immagine di destinazione in base a una proprietà di metadati condivisa specificata ed è pensata per supportare il collegamento di raccolte che applicano un'elaborazione/generazione di prodotti diversa alla stessa immagine di origine. Per un collegamento più espressivo noto come "unione", consulta la pagina https://developers.google.com/earth-engine/guides/joins_intro.
| Utilizzo | Resi |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Immagine |
| Argomento | Tipo | Dettagli |
|---|---|---|
questo: input | Immagine | L'immagine di origine a cui verrà collegata un'immagine corrispondente nella raccolta. |
imageCollection | ImageCollection | La raccolta di immagini in cui è stata eseguita la ricerca per estrarre un'immagine corrispondente all'origine. |
linkedBands | Oggetto, valore predefinito: null | Il nome di una band o un elenco di nomi di band da aggiungere o aggiornare dall'immagine corrispondente. |
linkedProperties | Oggetto, valore predefinito: null | Una proprietà dei metadati o un elenco di proprietà da aggiungere o aggiornare dall'immagine corrispondente. |
matchPropertyName | Stringa, valore predefinito: "system:index" | Il nome della proprietà dei metadati da utilizzare come criterio di corrispondenza. |