ee.Geometry
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée une géométrie.
Utilisation | Renvoie |
---|
ee.Geometry(geoJson, proj, geodesic, evenOdd) | Géométrie |
Argument | Type | Détails |
---|
geoJson | Objet | Objet GeoJSON décrivant la géométrie ou ComputedObject à réinterpréter en tant que géométrie. Accepte les spécifications CRS conformément à la spécification GeoJSON, mais n'autorise que les CRS nommés (et non "associés"). Si ce champ inclut un champ "géodésique" et que opt_geodesic n'est pas spécifié, il sera utilisé comme opt_geodesic. |
proj | Projection (facultatif) | Spécification de projection facultative, sous forme de code d'ID de CRS ou de chaîne WKT. Si spécifié, remplace tout CRS trouvé dans le paramètre geoJson. Si aucune valeur n'est spécifiée et que le fichier GeoJSON ne déclare pas de CRS, la valeur par défaut est "EPSG:4326" (x=longitude, y=latitude). |
geodesic | Booléen, facultatif | Indique si les segments de ligne doivent être interprétés comme des géodésiques sphériques. Si la valeur est "false", cela indique que les segments de ligne doivent être interprétés comme des lignes planes dans le CRS spécifié. Si elle est absente, la valeur par défaut est "true" si le CRS est géographique (y compris EPSG:4326 par défaut) ou "false" si le CRS est projeté. |
evenOdd | Booléen, facultatif | Si la valeur est "true", les intérieurs des polygones seront déterminés par la règle pair/impair, selon laquelle un point se trouve à l'intérieur s'il traverse un nombre impair d'arêtes pour atteindre un point à l'infini. Sinon, les polygones utilisent la règle de gauche à l'intérieur, où les intérieurs se trouvent sur le côté gauche des bords de la coque lorsque les sommets sont parcourus dans l'ordre donné. Si aucune valeur n'est spécifiée, la valeur par défaut est "true". |
Exemples
Éditeur de code (JavaScript)
// A GeoJSON object for a triangular polygon.
var geojsonObject = {
"type": "Polygon",
"coordinates": [
[
[
-122.085,
37.423
],
[
-122.092,
37.424
],
[
-122.085,
37.418
],
[
-122.085,
37.423
]
]
]
};
print('ee.Geometry accepts a GeoJSON object', ee.Geometry(geojsonObject));
// GeoJSON strings need to be converted to an object.
var geojsonString = JSON.stringify(geojsonObject);
print('A GeoJSON string needs to be converted to an object',
ee.Geometry(JSON.parse(geojsonString)));
// Use ee.Geometry to cast computed geometry objects into the ee.Geometry
// class to access their methods. In the following example an ee.Geometry
// object is stored as a ee.Feature property. When it is retrieved with the
// .get() function, a computed geometry object is returned. Cast the computed
// object as a ee.Geometry to get the geometry's bounds, for instance.
var feature = ee.Feature(null, {geom: ee.Geometry(geojsonObject)});
print('Cast computed geometry objects to ee.Geometry class',
ee.Geometry(feature.get('geom')).bounds());
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)
import json
# A GeoJSON object for a triangular polygon.
geojson_object = {
'type': 'Polygon',
'coordinates': [
[
[
-122.085,
37.423
],
[
-122.092,
37.424
],
[
-122.085,
37.418
],
[
-122.085,
37.423
]
]
]
}
print(
'ee.Geometry accepts a GeoJSON object:',
ee.Geometry(geojson_object).getInfo()
)
# GeoJSON strings need to be converted to an object.
geojson_string = json.dumps(geojson_object)
print('A GeoJSON string needs to be converted to an object:',
ee.Geometry(json.loads(geojson_string)).getInfo())
# Use ee.Geometry to cast computed geometry objects into the ee.Geometry
# class to access their methods. In the following example an ee.Geometry
# object is stored as a ee.Feature property. When it is retrieved with the
# .get() function, a computed geometry object is returned. Cast the computed
# object as a ee.Geometry to get the geometry's bounds, for instance.
feature = ee.Feature(None, {'geom': ee.Geometry(geojson_object)})
print('Cast computed geometry objects to ee.Geometry class:',
ee.Geometry(feature.get('geom')).bounds().getInfo())
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\u003eCreates a geometry from a GeoJSON object, optionally specifying projection, geodesic handling, and polygon winding rule.\u003c/p\u003e\n"],["\u003cp\u003eAccepts GeoJSON objects or strings (which must be parsed into objects).\u003c/p\u003e\n"],["\u003cp\u003eEnables casting of computed geometry objects (like those in Feature properties) to the \u003ccode\u003eee.Geometry\u003c/code\u003e class for method access.\u003c/p\u003e\n"],["\u003cp\u003eSupports both JavaScript and Python environments within Google Earth Engine.\u003c/p\u003e\n"]]],[],null,["# ee.Geometry\n\n\u003cbr /\u003e\n\nCreates a geometry.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------------------------|----------|\n| `ee.Geometry(geoJson, `*proj* `, `*geodesic* `, `*evenOdd*`)` | Geometry |\n\n| Argument | Type | Details |\n|------------|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `geoJson` | Object | The GeoJSON object describing the geometry or a ComputedObject to be reinterpreted as a Geometry. Supports CRS specifications as per the GeoJSON spec, but only allows named (rather than \"linked\" CRSs). If this includes a 'geodesic' field, and opt_geodesic is not specified, it will be used as opt_geodesic. |\n| `proj` | Projection, optional | An optional projection specification, either as a CRS ID code or as a WKT string. If specified, overrides any CRS found in the geoJson parameter. If unspecified and the geoJson does not declare a CRS, defaults to \"EPSG:4326\" (x=longitude, y=latitude). |\n| `geodesic` | Boolean, optional | Whether line segments should be interpreted as spherical geodesics. If false, indicates that line segments should be interpreted as planar lines in the specified CRS. If absent, defaults to true if the CRS is geographic (including the default EPSG:4326), or to false if the CRS is projected. |\n| `evenOdd` | Boolean, optional | If true, polygon interiors will be determined by the even/odd rule, where a point is inside if it crosses an odd number of edges to reach a point at infinity. Otherwise polygons use the left- inside rule, where interiors are on the left side of the shell's edges when walking the vertices in the given order. If unspecified, defaults to true. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A GeoJSON object for a triangular polygon.\nvar geojsonObject = {\n \"type\": \"Polygon\",\n \"coordinates\": [\n [\n [\n -122.085,\n 37.423\n ],\n [\n -122.092,\n 37.424\n ],\n [\n -122.085,\n 37.418\n ],\n [\n -122.085,\n 37.423\n ]\n ]\n ]\n};\nprint('ee.Geometry accepts a GeoJSON object', ee.Geometry(geojsonObject));\n\n// GeoJSON strings need to be converted to an object.\nvar geojsonString = JSON.stringify(geojsonObject);\nprint('A GeoJSON string needs to be converted to an object',\n ee.Geometry(JSON.parse(geojsonString)));\n\n// Use ee.Geometry to cast computed geometry objects into the ee.Geometry\n// class to access their methods. In the following example an ee.Geometry\n// object is stored as a ee.Feature property. When it is retrieved with the\n// .get() function, a computed geometry object is returned. Cast the computed\n// object as a ee.Geometry to get the geometry's bounds, for instance.\nvar feature = ee.Feature(null, {geom: ee.Geometry(geojsonObject)});\nprint('Cast computed geometry objects to ee.Geometry class',\n ee.Geometry(feature.get('geom')).bounds());\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\nimport json\n\n# A GeoJSON object for a triangular polygon.\ngeojson_object = {\n 'type': 'Polygon',\n 'coordinates': [\n [\n [\n -122.085,\n 37.423\n ],\n [\n -122.092,\n 37.424\n ],\n [\n -122.085,\n 37.418\n ],\n [\n -122.085,\n 37.423\n ]\n ]\n ]\n}\nprint(\n 'ee.Geometry accepts a GeoJSON object:',\n ee.Geometry(geojson_object).getInfo()\n)\n\n# GeoJSON strings need to be converted to an object.\ngeojson_string = json.dumps(geojson_object)\nprint('A GeoJSON string needs to be converted to an object:',\n ee.Geometry(json.loads(geojson_string)).getInfo())\n\n# Use ee.Geometry to cast computed geometry objects into the ee.Geometry\n# class to access their methods. In the following example an ee.Geometry\n# object is stored as a ee.Feature property. When it is retrieved with the\n# .get() function, a computed geometry object is returned. Cast the computed\n# object as a ee.Geometry to get the geometry's bounds, for instance.\nfeature = ee.Feature(None, {'geom': ee.Geometry(geojson_object)})\nprint('Cast computed geometry objects to ee.Geometry class:',\n ee.Geometry(feature.get('geom')).bounds().getInfo())\n```"]]