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
on the top right to draw your AOI.
Upload a file
Click
in the Search location bar to upload a file with your AOI.
See file formats for different platforms
Platform option | File formats | GeoJSON object |
---|---|---|
Console | GeoJSON KML WKT | GeoJSON Feature |
SDK | GeoJSON KML WKT Shapefile | GeoJSON Feature GeoJSON FeatureCollection |
API | GeoJSON | GeoJSON 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.