Annonce : Tous les projets non commerciaux enregistrés pour utiliser Earth Engine avant le 15 avril 2025 doivent vérifier leur éligibilité non commerciale pour conserver leur accès à Earth Engine.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Extrait une région rectangulaire de pixels d'une image dans un tableau ND par bande. Les tableaux sont renvoyés dans une entité conservant les mêmes propriétés que l'image et une géométrie identique à celle utilisée pour échantillonner l'image (ou l'empreinte de l'image si elle n'est pas spécifiée). Chaque bande est échantillonnée dans sa projection d'entrée. Si aucune géométrie n'est spécifiée, elle est échantillonnée à l'aide de son emprise. Pour les bandes scalaires, le tableau de sortie est en 2D. Pour les bandes de tableaux, le tableau de sortie est (2+N)D, où N est le nombre de dimensions de la bande d'origine. Si vous échantillonnez des bandes de tableaux, tous les tableaux doivent comporter le même nombre d'éléments. Si la région échantillonnée d'une bande est entièrement masquée et qu'une valeur de tableau par défaut est spécifiée, cette valeur est utilisée à la place de l'échantillonnage de l'image.
Région dont le cadre de délimitation projeté est utilisé pour échantillonner l'image. La valeur par défaut correspond à l'empreinte dans chaque bande.
properties
Liste, valeur par défaut : null
Propriétés à copier à partir de l'image échantillonnée. Valeur par défaut : toutes les propriétés non système.
defaultValue
Float, valeur par défaut : null
Valeur par défaut utilisée lorsqu'un pixel échantillonné est masqué ou en dehors de l'empreinte d'une bande.
defaultArrayValue
Tableau, valeur par défaut : null
Valeur par défaut utilisée lorsqu'un pixel de tableau échantillonné est masqué ou en dehors de l'empreinte d'une bande.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/26 (UTC)."],[[["`sampleRectangle` extracts a rectangular region of pixels from a specified image into a multidimensional array for each band, preserving the image's original properties."],["The extracted region is defined by a geometry or defaults to the image's footprint, with each band sampled in its native projection."],["Output arrays are 2D for scalar bands and (2+N)D for array bands, where N represents the original band's dimensions, utilizing default values for masked or out-of-bounds pixels if provided."],["Users can customize the properties carried over from the original image and specify default values for masked or out-of-bounds pixel values."]]],["It extracts a rectangular pixel region from an image into an ND array per band, returning a feature with the same properties and geometry as the input. Bands are sampled in their input projection using a specified region or the image footprint. Output arrays are 2D for scalar bands and (2+N)D for array bands. If a sampled region is entirely masked, a specified default value or array is used. Properties from the image can be copied.\n"]]