Area order creation

last updated: July 12, 2022

The Planet Tasking API is a REST based API, which can be integrated into any service, regardless of the language used. Below are some examples of how to integrate the most commonly used aspects of the Tasking API Stereo orders creation, editing and cancellation.

The creation, editing and deletion of Area orders follows the same rules as normal orders except, of course, for the geometry.

Area Geometry

The creation of an Area order requires a GeoJSON object with a given type of "Polygon" and an array of coordinates representing the polygon that will comprise the area that you want to be captured, e.g.

Polygon

{
    "type": "Polygon",
    "coordinates": [
        [
            [
                //some coordinates
            ],
            [
                //some coordinates
            ],
            [
                //some coordinates
            ]
        ]
    ]
}

The area, measured in KM2, of the provided polygon should be less than your maximum allowed KM2 for a single Tasking Order.

For assistance in the creation and validation of GeoJSON polygons you can find many resources on the internet, for example https://geojson.io/.

Area order creation

As mentioned, the difference between an area order and a point order is the GeoJSON object that defines the AOI (area of interest) of the order as shown below:

curl --request POST --url 'https://api.planet.com/tasking/v2/orders/' \
    --header 'accept: application/json' \
    --header 'authorization: api-key <YOUR_API_KEY>' \
    --header 'content-type: application/json' \
    --data '{
        'name': 'Area Order 01',
        'geometry': {
            'type': 'Polygon',
            'coordinates': [
                [
                    [
                        -111.02062225341797,
                        39.58637603706183
                    ],
                    [
                        -110.9095573425293,
                        39.58637603706183
                    ],
                    [
                        -110.9095573425293,
                        39.670992062375056
                    ],
                    [
                        -111.02062225341797,
                        39.670992062375056
                    ],
                    [
                        -111.02062225341797,
                        39.58637603706183
                    ]
                ]
            ]
        }
    }

The response is much the same as a standard Order request.


Rate this guide: