Define an AOI

Guidelines for creating and correcting areas of interest (AOIs).


Overview

An AOI represents an area, such as the boundary of a property, a water body, or a forest. It should be a polygon, that is, a two-dimensional closed shape bounded with straight sides. Multipolygons aren't allowed.

The coordinate system for an AOI is EPSG:4326 (WGS84), and the units are decimal degrees.

Rules for creating polygons:

  • No more than 1000 vertices.
  • The first and last coordinate pairs are identical.

Create an AOI

If you're using the console, you can create an AOI in a number of ways:

  • Search for a location

    Start typing a name of a place in the Search location bar and select a prompt from a drop-down list.

  • Draw a polygon

    Click Draw polygon icon on the top right to draw your AOI.

  • Upload a file

    Click Upload icon in the Search location bar to upload a file with your AOI.

See file formats for different platforms

Platform optionFile formatsGeoJSON object
ConsoleGeoJSON
KML
WKT
GeoJSON Feature
SDKGeoJSON
KML
WKT
Shapefile
GeoJSON Feature
GeoJSON FeatureCollection
APIGeoJSONGeoJSON Feature
GeoJSON FeatureCollection

Fix invalid polygons

  • Don't use a shadock polygon, that is, when a polygon intersects the image footprint in more than one segment, thus creating more polygons.

    Fix shadock polygons in one of the following ways:

    • Modify the size of the polygon, so that it intersects the image footprint in one segment.
    • Split the polygon into more polygons, so that each one intersects the image footprint in one segment.
  • Don't use a sliver polygon, that is, a polygon with a very small area but with a very large perimeter.

  • Don't use a polygon that contains holes, self-intersections, or has an extremely complicated shape with too many vertices. If needed, apply a simplification algorithm — for example, Douglas-Peucker.

invalid aoi