Alle angegebenen Bänder oder Metadaten werden dem Quellbild aus dem Bild in der Sammlung hinzugefügt. Wenn die Bänder oder Metadaten bereits vorhanden sind, werden sie überschrieben. Wenn kein passendes Bild gefunden wird, werden alle neuen oder aktualisierten Bänder vollständig maskiert und alle neuen oder aktualisierten Metadaten sind null. Der Ausgabefootprint entspricht dem Footprint des Quellbilds.
Eine Übereinstimmung wird ermittelt, wenn das Quellbild und ein Bild in der Sammlung eine bestimmte entsprechende Metadateneigenschaft haben. Wenn mehr als ein Sammlungsbild übereinstimmt, wird das ausgewählte Sammlungsbild nach dem Zufallsprinzip bestimmt. Standardmäßig werden Bilder anhand der Metadateneigenschaft „system:index“ abgeglichen.
Diese Verknüpfungsfunktion ist eine praktische Methode zum Hinzufügen von Bändern zu einem Zielbild basierend auf einer angegebenen gemeinsamen Metadateneigenschaft. Sie soll die Verknüpfung von Sammlungen unterstützen, bei denen dieselben Quellbilder unterschiedlich verarbeitet oder Produkte unterschiedlich generiert werden. Weitere Informationen zum ausdrucksstarken Verknüpfen von Daten, dem sogenannten „Joining“, finden Sie unter https://developers.google.com/earth-engine/guides/joins_intro.
| Nutzung | Ausgabe |
|---|---|
Image.linkCollection(imageCollection, linkedBands, linkedProperties, matchPropertyName) | Bild |
| Argument | Typ | Details |
|---|---|---|
So gehts: input | Bild | Das Quellbild, mit dem ein übereinstimmendes Bild in der Sammlung verknüpft wird. |
imageCollection | ImageCollection | Die Bildsammlung, in der nach einem Bild gesucht wird, das mit der Quelle übereinstimmt. |
linkedBands | Objekt, Standardwert: null | Ein Bandname oder eine Liste von Bandnamen, die aus dem entsprechenden Bild hinzugefügt oder aktualisiert werden sollen. |
linkedProperties | Objekt, Standardwert: null | Ein Metadatenattribut oder eine Liste von Attributen, die aus dem übereinstimmenden Bild hinzugefügt oder aktualisiert werden sollen. |
matchPropertyName | String, Standard: „system:index“ | Der Name der Metadateneigenschaft, die als Abgleichskriterium verwendet werden soll. |