Method __init__

python/ee/geometry.py:37–152

Creates a geometry. Note that a creating a Geometry from a ComputedObject cannot have have any overrides from the arguments proj, geodesic, or evenOdd. Args: geo_json: The GeoJSON object describing the geometry or a computed object to be reinterpred as a Geometry. Support

(
      self,
      geo_json: dict[str, Any] | computedobject.ComputedObject | Geometry,
      proj: Any | None = None,
      geodesic: bool | None = None,
      evenOdd: bool | None = None,  # pylint: disable=g-bad-name
  )

  @_utils.accept_opt_prefix('opt_proj', 'opt_geodesic', 'opt_evenOdd')
  def __init__(
      self,
      geo_json: dict[str, Any] | computedobject.ComputedObject | Geometry,
      proj: Any | None = None,
      geodesic: bool | None = None,
      evenOdd: bool | None = None,  # pylint: disable=g-bad-name
  ):
    """Creates a geometry.

    Note that a creating a Geometry from a ComputedObject cannot have have any
    overrides from the arguments proj, geodesic, or evenOdd.

    Args:
      geo_json: The GeoJSON object describing the geometry or a computed object
        to be reinterpred 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 geodesic is not specified, it will be
        used as geodesic.
      proj: An optional projection specification, either as an ee.Projection, as
        a CRS ID code or as a WKT string. If specified, overrides any CRS found
        in the geo_json parameter. If unspecified and the geo_json does not
        declare a CRS, defaults to "EPSG:4326" (x=longitude, y=latitude).
      geodesic: 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.
      evenOdd: 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.

    Raises:
      EEException: if the given geometry isn't valid.
    """
    self.initialize()

    # pylint: disable-next=protected-access
    has_resolved_geometry_type = getattr(geo_json, '_type', None) is not None
    computed = isinstance(geo_json, computedobject.ComputedObject) and not (
        isinstance(geo_json, Geometry) and has_resolved_geometry_type
    )
    options = proj is not None or geodesic is not None or evenOdd is not None
    if computed:
      if options:
        raise ee_exception.EEException(
            'Setting the CRS or geodesic on a computed Geometry is not '
            'supported. Use Geometry.transform().')
      else:
        super().__init__(geo_json.func, geo_json.args, geo_json.varName)
        return

    # Below here we're working with a GeoJSON literal.
    if isinstance(geo_json, Geometry):
      geo_json = geo_json.encode()

    if not Geometry._isValidGeometry(geo_json):