ee.Geometry.Polygon.convexHull
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Renvoie l'enveloppe convexe de la géométrie donnée. L'enveloppe convexe d'un point unique est le point lui-même, celle de points colinéaires est une ligne, et celle de tout le reste est un polygone. Notez qu'un polygone dégénéré dont tous les sommets se trouvent sur la même ligne génère un segment de ligne.
Utilisation | Renvoie |
---|
Polygon.convexHull(maxError, proj) | Géométrie |
Argument | Type | Détails |
---|
ceci : geometry | Géométrie | Calcule l'enveloppe convexe de cette géométrie. |
maxError | ErrorMargin, valeur par défaut : null | Quantité maximale d'erreur tolérée lors de toute reprojection nécessaire. |
proj | Projection, valeur par défaut : null | Projection 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 Polygon object.
var polygon = ee.Geometry.Polygon(
[[[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423]]]);
// Apply the convexHull method to the Polygon object.
var polygonConvexHull = polygon.convexHull({'maxError': 1});
// Print the result to the console.
print('polygon.convexHull(...) =', polygonConvexHull);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(polygon,
{'color': 'black'},
'Geometry [black]: polygon');
Map.addLayer(polygonConvexHull,
{'color': 'red'},
'Result [red]: polygon.convexHull');
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)
# Define a Polygon object.
polygon = ee.Geometry.Polygon([[
[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423],
]])
# Apply the convexHull method to the Polygon object.
polygon_convex_hull = polygon.convexHull(maxError=1)
# Print the result.
display('polygon.convexHull(...) =', polygon_convex_hull)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(polygon, {'color': 'black'}, 'Geometry [black]: polygon')
m.add_layer(
polygon_convex_hull, {'color': 'red'}, 'Result [red]: polygon.convexHull'
)
m
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).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eReturns the smallest convex Polygon that encloses the given geometry.\u003c/p\u003e\n"],["\u003cp\u003eAccepts an optional \u003ccode\u003emaxError\u003c/code\u003e for reprojection and an optional \u003ccode\u003eproj\u003c/code\u003e for the projection to use.\u003c/p\u003e\n"],["\u003cp\u003eThe convex hull of a point is the point itself, collinear points result in a line, and other geometries result in a Polygon.\u003c/p\u003e\n"],["\u003cp\u003eMay return a degenerate polygon (line segment) if all vertices lie on the same line.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry.Polygon.convexHull\n\nReturns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------|----------|\n| Polygon.convexHull`(`*maxError* `, `*proj*`)` | Geometry |\n\n| Argument | Type | Details |\n|------------------|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `geometry` | Geometry | Calculates the convex hull of this geometry. |\n| `maxError` | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |\n| `proj` | Projection, default: null | The projection in which to perform the operation. If not specified, the operation will be performed in a spherical coordinate system, and linear distances will be in meters on the sphere. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a Polygon object.\nvar polygon = ee.Geometry.Polygon(\n [[[-122.092, 37.424],\n [-122.086, 37.418],\n [-122.079, 37.425],\n [-122.085, 37.423]]]);\n\n// Apply the convexHull method to the Polygon object.\nvar polygonConvexHull = polygon.convexHull({'maxError': 1});\n\n// Print the result to the console.\nprint('polygon.convexHull(...) =', polygonConvexHull);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(polygon,\n {'color': 'black'},\n 'Geometry [black]: polygon');\nMap.addLayer(polygonConvexHull,\n {'color': 'red'},\n 'Result [red]: polygon.convexHull');\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# Define a Polygon object.\npolygon = ee.Geometry.Polygon([[\n [-122.092, 37.424],\n [-122.086, 37.418],\n [-122.079, 37.425],\n [-122.085, 37.423],\n]])\n\n# Apply the convexHull method to the Polygon object.\npolygon_convex_hull = polygon.convexHull(maxError=1)\n\n# Print the result.\ndisplay('polygon.convexHull(...) =', polygon_convex_hull)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(polygon, {'color': 'black'}, 'Geometry [black]: polygon')\nm.add_layer(\n polygon_convex_hull, {'color': 'red'}, 'Result [red]: polygon.convexHull'\n)\nm\n```"]]