Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Geometry.MultiPolygon.geodesic
Stay organized with collections
Save and categorize content based on your preferences.
If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.
| Usage | Returns | MultiPolygon.geodesic() | Boolean |
| Argument | Type | Details | this: geometry | Geometry | |
Examples
Code Editor (JavaScript)
// Define a MultiPolygon object.
var multiPolygon = ee.Geometry.MultiPolygon(
[[[[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423]]],
[[[-122.081, 37.417],
[-122.086, 37.421],
[-122.089, 37.416]]]]);
// Apply the geodesic method to the MultiPolygon object.
var multiPolygonGeodesic = multiPolygon.geodesic();
// Print the result to the console.
print('multiPolygon.geodesic(...) =', multiPolygonGeodesic);
// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(multiPolygon,
{'color': 'black'},
'Geometry [black]: multiPolygon');
Python setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
import ee
import geemap.core as geemap
Colab (Python)
# Define a MultiPolygon object.
multipolygon = ee.Geometry.MultiPolygon([
[[
[-122.092, 37.424],
[-122.086, 37.418],
[-122.079, 37.425],
[-122.085, 37.423],
]],
[[[-122.081, 37.417], [-122.086, 37.421], [-122.089, 37.416]]],
])
# Apply the geodesic method to the MultiPolygon object.
multipolygon_geodesic = multipolygon.geodesic()
# Print the result.
display('multipolygon.geodesic(...) =', multipolygon_geodesic)
# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(
multipolygon, {'color': 'black'}, 'Geometry [black]: multipolygon'
)
m
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eMultiPolygon.geodesic()\u003c/code\u003e is a method in Earth Engine that determines whether the edges of a MultiPolygon are rendered as straight lines or curved to follow the Earth's curvature.\u003c/p\u003e\n"],["\u003cp\u003eBy default, edges are straight; setting \u003ccode\u003egeodesic()\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e renders them as curves representing the shortest path on the Earth's surface.\u003c/p\u003e\n"],["\u003cp\u003eThis method returns a Boolean value indicating the current geodesic setting of the MultiPolygon.\u003c/p\u003e\n"],["\u003cp\u003eThe method is demonstrated with code examples in JavaScript and Python, showing how to apply it and visualize the results on a map.\u003c/p\u003e\n"]]],["The `MultiPolygon.geodesic()` method determines edge curvature in a projection. It returns a boolean: `false` indicates straight edges, and `true` signifies curved edges following the Earth's surface. The examples provided in JavaScript and Python define a `MultiPolygon` object, apply the `geodesic()` method, display the boolean result, and visualize the geometry on a map. `Geometry` is an argument that is being used in this context.\n"],null,["# ee.Geometry.MultiPolygon.geodesic\n\nIf false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------|---------|\n| MultiPolygon.geodesic`()` | Boolean |\n\n| Argument | Type | Details |\n|------------------|----------|---------|\n| this: `geometry` | Geometry | |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Define a MultiPolygon object.\nvar multiPolygon = ee.Geometry.MultiPolygon(\n [[[[-122.092, 37.424],\n [-122.086, 37.418],\n [-122.079, 37.425],\n [-122.085, 37.423]]],\n [[[-122.081, 37.417],\n [-122.086, 37.421],\n [-122.089, 37.416]]]]);\n\n// Apply the geodesic method to the MultiPolygon object.\nvar multiPolygonGeodesic = multiPolygon.geodesic();\n\n// Print the result to the console.\nprint('multiPolygon.geodesic(...) =', multiPolygonGeodesic);\n\n// Display relevant geometries on the map.\nMap.setCenter(-122.085, 37.422, 15);\nMap.addLayer(multiPolygon,\n {'color': 'black'},\n 'Geometry [black]: multiPolygon');\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 MultiPolygon object.\nmultipolygon = ee.Geometry.MultiPolygon([\n [[\n [-122.092, 37.424],\n [-122.086, 37.418],\n [-122.079, 37.425],\n [-122.085, 37.423],\n ]],\n [[[-122.081, 37.417], [-122.086, 37.421], [-122.089, 37.416]]],\n])\n\n# Apply the geodesic method to the MultiPolygon object.\nmultipolygon_geodesic = multipolygon.geodesic()\n\n# Print the result.\ndisplay('multipolygon.geodesic(...) =', multipolygon_geodesic)\n\n# Display relevant geometries on the map.\nm = geemap.Map()\nm.set_center(-122.085, 37.422, 15)\nm.add_layer(\n multipolygon, {'color': 'black'}, 'Geometry [black]: multipolygon'\n)\nm\n```"]]