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" or "MultiPolygon" and an array or arrays of coordinates representing the polygon(s) that will comprise the area or areas that want to be captured, e.g.

Polygon

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

MultiPolygon

{
    'type': 'MultiPolygon',
    'coordinates': [
        [
            [
                //some coordinates
            ],
            [
                //some coordinates
            ],
            [
                //some coordinates
            ]
        ],
        [
            [
                //some coordinates
            ],
            [
                //some coordinates
            ],
            [
                //some coordinates
            ]
        ],
        [
            [
                //some coordinates
            ],
            [
                //some coordinates
            ],
            [
                //some coordinates
            ]
        ]
    ]
}

Whether you choose to create a single Polygon or MultiPolygon area the total amount of area, measured in KM2, of all the provided polygons counts towards 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.