ee.Geometry.difference
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Gibt das Ergebnis der Subtraktion der „right“-Geometrie von der „left“-Geometrie zurück.
Nutzung | Ausgabe |
---|
Geometry.difference(right, maxError, proj) | Geometrie |
Argument | Typ | Details |
---|
So gehts: left | Geometrie | Die Geometrie, die als linker Operand des Vorgangs verwendet wird. |
right | Geometrie | Die Geometrie, die als rechter Operand des Vorgangs verwendet wird. |
maxError | ErrorMargin, Standardwert: null | Die maximale Fehlergröße, die bei einer erforderlichen Rückprojektion toleriert wird. |
proj | Projektion, Standardwert: null | Die Projektion, in der der Vorgang ausgeführt werden soll. Wenn nichts angegeben ist, wird der Vorgang in einem sphärischen Koordinatensystem ausgeführt und lineare Entfernungen werden in Metern auf der Kugel angegeben. |
Beispiele
Code-Editor (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.BBox(-122.085, 37.415, -122.075, 37.425);
// Apply the difference method to the Geometry object.
var geometryDifference = geometry.difference({'right': inputGeom, 'maxError': 1});
// Print the result to the console.
print('geometry.difference(...) =', geometryDifference);
// 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(geometryDifference,
{'color': 'red'},
'Result [red]: geometry.difference');
Python einrichten
Informationen zur Python API und zur Verwendung von geemap
für die interaktive Entwicklung finden Sie auf der Seite
Python-Umgebung.
import ee
import geemap.core as geemap
Colab (Python)
# Define a Geometry object.
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.
input_geom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425)
# Apply the difference method to the Geometry object.
geometry_difference = geometry.difference(right=input_geom, maxError=1)
# Print the result.
display('geometry.difference(...) =', geometry_difference)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(geometry, {'color': 'black'}, 'Geometry [black]: geometry')
m.add_layer(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')
m.add_layer(
geometry_difference, {'color': 'red'}, 'Result [red]: geometry.difference'
)
m
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003e\u003ccode\u003edifference()\u003c/code\u003e returns a Geometry representing the portion of the first geometry that does not intersect with the second geometry.\u003c/p\u003e\n"],["\u003cp\u003eIt accepts a 'right' Geometry to subtract and optional \u003ccode\u003emaxError\u003c/code\u003e and \u003ccode\u003eproj\u003c/code\u003e parameters for reprojection control.\u003c/p\u003e\n"],["\u003cp\u003eThe operation is performed in spherical coordinates with distances in meters on the sphere unless a projection is specified.\u003c/p\u003e\n"],["\u003cp\u003eThis method is useful for creating new geometries by removing overlapping areas between existing ones.\u003c/p\u003e\n"]]],["The `Geometry.difference()` method subtracts a 'right' geometry from a 'left' geometry, returning the result as a new geometry. It accepts the `right` geometry, an optional `maxError` for reprojection tolerance, and an optional `proj` for the operation's projection. If `proj` is not defined the method will use the spherical coordinate system. Example code shows the difference operation using defined geometries and displays the result.\n"],null,["# ee.Geometry.difference\n\nReturns the result of subtracting the 'right' geometry from the 'left' geometry.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------------------------------------------|----------|\n| Geometry.difference`(right, `*maxError* `, `*proj*`)` | Geometry |\n\n| Argument | Type | Details |\n|--------------|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `left` | Geometry | The geometry used as the left operand of the operation. |\n| `right` | Geometry | The geometry used as the right operand of the operation. |\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 Geometry object.\nvar geometry = ee.Geometry({\n 'type': 'Polygon',\n 'coordinates':\n [[[-122.081, 37.417],\n [-122.086, 37.421],\n [-122.084, 37.418],\n [-122.089, 37.416]]]\n});\n\n// Define other inputs.\nvar inputGeom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425);\n\n// Apply the difference method to the Geometry object.\nvar geometryDifference = geometry.difference({'right': inputGeom, 'maxError': 1});\n\n// Print the result to the console.\nprint('geometry.difference(...) =', geometryDifference);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(geometry,\n {'color': 'black'},\n 'Geometry [black]: geometry');\nMap.addLayer(inputGeom,\n {'color': 'blue'},\n 'Parameter [blue]: inputGeom');\nMap.addLayer(geometryDifference,\n {'color': 'red'},\n 'Result [red]: geometry.difference');\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 Geometry object.\ngeometry = ee.Geometry({\n 'type': 'Polygon',\n 'coordinates': [[\n [-122.081, 37.417],\n [-122.086, 37.421],\n [-122.084, 37.418],\n [-122.089, 37.416],\n ]],\n})\n\n# Define other inputs.\ninput_geom = ee.Geometry.BBox(-122.085, 37.415, -122.075, 37.425)\n\n# Apply the difference method to the Geometry object.\ngeometry_difference = geometry.difference(right=input_geom, maxError=1)\n\n# Print the result.\ndisplay('geometry.difference(...) =', geometry_difference)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(geometry, {'color': 'black'}, 'Geometry [black]: geometry')\nm.add_layer(input_geom, {'color': 'blue'}, 'Parameter [blue]: input_geom')\nm.add_layer(\n geometry_difference, {'color': 'red'}, 'Result [red]: geometry.difference'\n)\nm\n```"]]