ee.Geometry.Polygon.serialize

  • The serialize() method returns a serialized (string) representation of a given Earth Engine Geometry object, such as a Polygon.

  • This method can be used to convert a Geometry object into a format suitable for storage or transmission.

  • An optional legacy argument can be provided to enable legacy formatting if needed.

  • Examples in JavaScript and Python demonstrate using serialize() with a Polygon Geometry.

Returns the serialized representation of this object.

UsageReturns
Polygon.serialize(legacy)String
ArgumentTypeDetails
this: geometryGeometryThe Geometry instance.
legacyBoolean, optionalEnables legacy format.

Examples

Code Editor (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 serialize method to the Polygon object.
var polygonSerialize = polygon.serialize();

// Print the result to the console.
print('polygon.serialize(...) =', polygonSerialize);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(polygon,
             {'color': 'black'},
             'Geometry [black]: polygon');

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 Polygon object.
polygon = ee.Geometry.Polygon([[
    [-122.092, 37.424],
    [-122.086, 37.418],
    [-122.079, 37.425],
    [-122.085, 37.423],
]])

# Apply the serialize method to the Polygon object.
polygon_serialize = polygon.serialize()

# Print the result.
display('polygon.serialize(...) =', polygon_serialize)

# 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