ee.Geometry.closestPoint

Renvoie le point de l'entrée de droite le plus proche de l'entrée de gauche. Si l'une des entrées est vide, la valeur "null" est renvoyée. Si les deux entrées sont illimitées, un point arbitraire est renvoyé. Si une entrée est illimitée, un point arbitraire de l'entrée limitée est renvoyé.

UtilisationRenvoie
Geometry.closestPoint(right, maxError, proj)Objet
ArgumentTypeDétails
ceci : leftGéométrieGéométrie utilisée comme opérande de gauche de l'opération.
rightGéométrieGéométrie utilisée comme opérande de droite de l'opération.
maxErrorErrorMargin, valeur par défaut : nullQuantité maximale d'erreur tolérée lors de toute reprojection nécessaire.
projProjection, valeur par défaut : nullProjection dans laquelle effectuer l'opération. Si elle n'est pas spécifiée, l'opération sera effectuée dans un système de coordonnées sphériques et les distances linéaires seront exprimées en mètres sur la sphère.

Exemples

Éditeur de code (JavaScript)

// Define a Geometry object.
var geometry = ee.Geometry({
  'type': 'Polygon',
  'coordinates':
    [[[-122.081, 37.417],
      [-122.086, 37.421],
      [-122.084, 37.418],
      [-122.089, 37.416]]]
});

// Define other inputs.
var inputGeom = ee.Geometry.Polygon(
        [[[-122.068, 37.418],
          [-122.068, 37.416],
          [-122.064, 37.416],
          [-122.064, 37.418]]]);

// Apply the closestPoints method to the Geometry objects.
var closestPoints = ee.Dictionary(geometry.closestPoints({'right': inputGeom, 'maxError': 1}));

// Print the result to the console.
print('geometry.closestPoints(...) =', closestPoints);

// There is also a one-sided API for convenience.
var closestPointOnInputGeom = geometry.closestPoint({'right': inputGeom, 'maxError': 1});
print('geometry.closestPoint(...) =', closestPointOnInputGeom);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(geometry,
             {'color': 'black'},
             'Geometry [black]: geometry');
Map.addLayer(inputGeom,
             {'color': 'blue'},
             'Parameter [blue]: inputGeom');
Map.addLayer(closestPoints.getGeometry('left'),
             {'color': 'red'},
             'Result [red]: closestPointOnLeft');
Map.addLayer(closestPoints.getGeometry('right'),
             {'color': 'red'},
             'Result [red]: closestPointOnRight');