ee.Geometry¶

Extended methods for the ee.Geometry class:

eemont.geometry.BBoxFromQuery(query, geocoder='nominatim', **kwargs)[source]¶

Constructs an ee.Geometry describing a bounding box from a query submitted to a geodocer using the geopy package.

Parameters

query (str) – Address, query or structured query to geocode.
geocoder (str, default = 'nominatim') – Geocoder to use. One of ‘nominatim’ or ‘arcgis’. Please visit https://geopy.readthedocs.io/ for more info.
**kwargs – Keywords arguments for geolocator.geocode(). The user_agent argument is mandatory (this argument can be set as user_agent = ‘my-gee-username’ or user_agent = ‘my-gee-app-name’). Please visit https://geopy.readthedocs.io/ for more info.

Returns

Geometry describing a bounding box from the specified query.

Return type

ee.Geometry.Polygon

Examples

>>> import ee, eemont
>>> ee.Initialize()
>>> ee.Geometry.BBoxFromQuery('Seattle',user_agent = 'my-gee-eemont-query')
ee.Geometry({
  "functionInvocationValue": {
    "functionName": "GeometryConstructors.Polygon",
    "arguments": {
      "coordinates": {
        "constantValue": [
          [
            [
              -122.45969600000001,
              47.7341357
            ],
            [
              -122.45969600000001,
              47.4810022
            ],
            [
              -122.224433,
              47.4810022
            ],
            [
              -122.224433,
              47.7341357
            ]
          ]
        ]
      },
      "geodesic": {
        "constantValue": false
      }
    }
  }
})

See also

PointFromQuery: Constructs an ee.Geometry describing a point from a query submitted to a geodocer using the geopy package.
MultiPointFromQuery: Constructs an ee.Geometry describing a multi-point from a query submitted to a geodocer using the geopy package.

eemont.geometry.MultiPointFromQuery(query, geocoder='nominatim', **kwargs)[source]¶

Constructs an ee.Geometry describing a multi-point from a query submitted to a geodocer using the geopy package. This returns all pairs of coordinates retrieved by the query.

Parameters

query (str) – Address, query or structured query to geocode.
geocoder (str, default = 'nominatim') – Geocoder to use. Please visit https://geopy.readthedocs.io/ for more info.
**kwargs – Keywords arguments for geolocator.geocode(). The user_agent argument is mandatory (this argument can be set as user_agent = ‘my-gee-username’ or user_agent = ‘my-gee-app-name’). Please visit https://geopy.readthedocs.io/ for more info.

Returns

Geometry describing a multi-point from the specified query.

Return type

ee.Geometry.MultiPoint

Examples

>>> import ee, eemont
>>> ee.Initialize()
>>> ee.Geometry.MultiPointFromQuery('Mt. Rainier, USA',user_agent = 'my-gee-eemont-query')
ee.Geometry({
  "functionInvocationValue": {
    "functionName": "GeometryConstructors.MultiPoint",
    "arguments": {
      "coordinates": {
        "constantValue": [
          [
            -121.757682,
            46.8521484
          ],
          [
            -76.9649751,
            38.9415
          ],
          [
            -97.78689,
            30.154197
          ],
          [
            -84.130098,
            39.863452
          ]
        ]
      }
    }
  }
})

See also

BBoxFromQuery: Constructs an ee.Geometry describing a bounding box from a query submitted to a geodocer using the geopy package.
PointFromQuery: Constructs an ee.Geometry describing a point from a query submitted to a geodocer using the geopy package.

eemont.geometry.PointFromQuery(query, geocoder='nominatim', **kwargs)[source]¶

Constructs an ee.Geometry describing a point from a query submitted to a geodocer using the geopy package. This returns exactly one pair of coordinates.

Parameters

query (str) – Address, query or structured query to geocode.
geocoder (str, default = 'nominatim') – Geocoder to use. Please visit https://geopy.readthedocs.io/ for more info.
**kwargs – Keywords arguments for geolocator.geocode(). The user_agent argument is mandatory (this argument can be set as user_agent = ‘my-gee-username’ or user_agent = ‘my-gee-app-name’). Please visit https://geopy.readthedocs.io/ for more info.

Returns

Geometry describing a point from the specified query.

Return type

ee.Geometry.Point

Examples

>>> import ee, eemont
>>> ee.Initialize()
>>> ee.Geometry.PointFromQuery('Mt. Rainier, USA',user_agent = 'my-gee-eemont-query')
ee.Geometry({
  "functionInvocationValue": {
    "functionName": "GeometryConstructors.Point",
    "arguments": {
      "coordinates": {
        "constantValue": [
          -121.757682,
          46.8521484
        ]
      }
    }
  }
})