ee.FeatureCollection.distance

Produit une image DOUBLE où chaque pixel correspond à la distance en mètres entre le centre du pixel et le point, la LineString ou la limite polygonale les plus proches de la collection.

Notez que la distance est également mesurée à l'intérieur des polygones. Les pixels qui ne se trouvent pas à moins de "searchRadius" mètres d'une géométrie seront masqués.

Les distances sont calculées sur une sphère. Il existe donc une petite erreur proportionnelle à la différence de latitude entre chaque pixel et la géométrie la plus proche.

UtilisationRenvoie
FeatureCollection.distance(searchRadius, maxError)Image
ArgumentTypeDétails
ceci : featuresFeatureCollectionCollection d'entités à partir de laquelle obtenir les entités utilisées pour calculer les distances entre les pixels.
searchRadiusFloat, valeur par défaut : 100 000Distance maximale en mètres à partir de chaque pixel pour rechercher les bords. Les pixels seront masqués, sauf s'il existe des bords à cette distance.
maxErrorFloat, valeur par défaut : 100Erreur de reprojection maximale en mètres, utilisée uniquement si les polylignes d'entrée nécessitent une reprojection. Si la valeur "0" est fournie, cette opération échouera si une projection est requise.

Exemples

Éditeur de code (JavaScript)

// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
             .filter('country_lg == "Belgium"');

// Generate an image of distance to nearest power plant.
var distance = fc.distance({searchRadius: 50000, maxError: 50});

// Display the image and FeatureCollection on the map.
Map.setCenter(4.56, 50.78, 7);
Map.addLayer(distance, {max: 50000}, 'Distance to power plants');
Map.addLayer(fc, {color: 'red'}, 'Power plants');

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

import ee
import geemap.core as geemap

Colab (Python)

# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
    'country_lg == "Belgium"'
)

# Generate an image of distance to nearest power plant.
distance = fc.distance(searchRadius=50000, maxError=50)

# Display the image and FeatureCollection on the map.
m = geemap.Map()
m.set_center(4.56, 50.78, 7)
m.add_layer(distance, {'max': 50000}, 'Distance to power plants')
m.add_layer(fc, {'color': 'red'}, 'Power plants')
m