Area order creation

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 KM², of the provided polygon should be less than your maximum allowed KM² 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: