ee.Geometry.MultiLineString.area
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפונקציה מחזירה את השטח של הצורה הגיאומטרית. השטח של נקודות ושל מחרוזות קו הוא 0, והשטח של צורות גיאומטריות מרובות הוא סכום השטחים של הרכיבים שלהן (שטחים חופפים נספרים כמה פעמים).
שימוש | החזרות |
---|
MultiLineString.area(maxError, proj) | מספר ממשי (float) |
ארגומנט | סוג | פרטים |
---|
זה: geometry | גיאומטריה | קלט הגיאומטריה. |
maxError | ErrorMargin, ברירת מחדל: null | הכמות המקסימלית של שגיאות שמותרות כשמבצעים הקרנה מחדש. |
proj | תחזית, ברירת מחדל: null | אם מציינים יחידות, התוצאה תהיה ביחידות של מערכת הקואורדינטות של ההטלה הזו. אחרת, הוא יהיה במטרים רבועים. |
דוגמאות
עורך הקוד (JavaScript)
// Define a MultiLineString object.
var multiLineString = ee.Geometry.MultiLineString(
[[[-122.088, 37.418], [-122.086, 37.422], [-122.082, 37.418]],
[[-122.087, 37.416], [-122.083, 37.416], [-122.082, 37.419]]]);
// Apply the area method to the MultiLineString object.
var multiLineStringArea = multiLineString.area({'maxError': 1});
// Print the result to the console.
print('multiLineString.area(...) =', multiLineStringArea);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(multiLineString,
{'color': 'black'},
'Geometry [black]: multiLineString');
הגדרת Python
מידע על Python API ועל שימוש ב-geemap
לפיתוח אינטראקטיבי מופיע בדף
Python Environment.
import ee
import geemap.core as geemap
Colab (Python)
# Define a MultiLineString object.
multilinestring = ee.Geometry.MultiLineString([
[[-122.088, 37.418], [-122.086, 37.422], [-122.082, 37.418]],
[[-122.087, 37.416], [-122.083, 37.416], [-122.082, 37.419]],
])
# Apply the area method to the MultiLineString object.
multilinestring_area = multilinestring.area(maxError=1)
# Print the result.
display('multilinestring.area(...) =', multilinestring_area)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(
multilinestring, {'color': 'black'}, 'Geometry [black]: multilinestring'
)
m
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eCalculates the area of a given geometry, with the area of points and line strings being 0.\u003c/p\u003e\n"],["\u003cp\u003eFor multi-geometries, the total area is the sum of their component areas, including any overlaps.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003earea()\u003c/code\u003e method can accept optional \u003ccode\u003emaxError\u003c/code\u003e and \u003ccode\u003eproj\u003c/code\u003e parameters for reprojection and unit specification.\u003c/p\u003e\n"],["\u003cp\u003eReturned area is in square meters by default, but can be in the units of the provided projection if specified.\u003c/p\u003e\n"]]],["The `area()` method calculates the area of a geometry. Points and line strings have an area of 0. For multi-geometries, it sums the areas of their components, counting intersecting areas multiple times. `maxError` sets the tolerance for reprojection errors, and `proj` defines the output projection units (defaults to square meters). The method is demonstrated using a `MultiLineString` object, in both JavaScript and Python, showing how to compute and display its area and geometry.\n"],null,["# ee.Geometry.MultiLineString.area\n\nReturns the area of the geometry. Area of points and line strings is 0 and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------------------------------------|---------|\n| MultiLineString.area`(`*maxError* `, `*proj*`)` | Float |\n\n| Argument | Type | Details |\n|------------------|----------------------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| this: `geometry` | Geometry | The geometry input. |\n| `maxError` | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |\n| `proj` | Projection, default: null | If specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a MultiLineString object.\nvar multiLineString = ee.Geometry.MultiLineString(\n [[[-122.088, 37.418], [-122.086, 37.422], [-122.082, 37.418]],\n [[-122.087, 37.416], [-122.083, 37.416], [-122.082, 37.419]]]);\n\n// Apply the area method to the MultiLineString object.\nvar multiLineStringArea = multiLineString.area({'maxError': 1});\n\n// Print the result to the console.\nprint('multiLineString.area(...) =', multiLineStringArea);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(multiLineString,\n {'color': 'black'},\n 'Geometry [black]: multiLineString');\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 MultiLineString object.\nmultilinestring = ee.Geometry.MultiLineString([\n [[-122.088, 37.418], [-122.086, 37.422], [-122.082, 37.418]],\n [[-122.087, 37.416], [-122.083, 37.416], [-122.082, 37.419]],\n])\n\n# Apply the area method to the MultiLineString object.\nmultilinestring_area = multilinestring.area(maxError=1)\n\n# Print the result.\ndisplay('multilinestring.area(...) =', multilinestring_area)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(\n multilinestring, {'color': 'black'}, 'Geometry [black]: multilinestring'\n)\nm\n```"]]