In addition to the REST API features, customers have access to the Tasking Dashboard, a graphical user interface to streamline order submission and management through the API. Customers may also use the Dashboard to preview captures made against their orders.
Order Entry
Users may create point, line string, area, monitoring or stereo orders by inputting various parameters in the order creation windows below:
Point Order
Point orders allow you to capture a specific point - a 5 km x 5 km box will automatically be added around your coordinates.
Line String Order
Line string orders allow you to capture a rectangular area - a 5 km wide strip up to 100 km long can be ordered. Furthermore, the azimuth angle can determine the direction of the capture.
Area Order
Area orders allow you to capture any form of area. If the area is too large to be captured in one go we will tesselate it up into smaller strips.
Deleting an order geometry
In case you want to start over with the definition of your Area Of Interest (AOI), use the top button in the map's toolbar with the trash icon in it. This will delete your current geometry and let you start afresh with respect to the definition of your AOI.
Stereo Order
Stereo orders allow you to take two or three captures of the same point in one go.
Monitoring Order
Monitoring Orders allow you to take the same point over a series of time. We offer days, weeks and months for the temporal resolution that can be configured by you.
Furthermore, you can generate an additional occurrence between ‘now’ and the moment your normal schedule would start.
Order Progress
Customers may check the status of all of their orders in the Order Progress Table or Map views.
Order Progress – Table View
Order Progress – Map View
In the map view, orders will be shown clustered together initially, and when you ‘zoom in’ the clusters will disperse into the actual geometries of the orders. Clicking on an individual order will open up the order flyout on the right with more detailed information.
A user can switch back and forth between the table and the map view using the tab control in the top right. Users can filter by either the current view of the map or a user-drawn geometry. In order to do so, open up the “Draw polygon filter” dialog by pressing the top control in the bottom right corner of the map. After either using “Select viewport” or drawing a polygon in the map, press the ADD AS FILTER button to apply the filter. The same filter will then also be applied to the table view.
To remove the geographic filter, use the Delete option from the dialog or press the close (x) button on the Geometry filter option itself.
Order View
In the Table view, customers can drill deeper into their individual orders to review each order’s configuration and status.
The order detail view can be expanded to display captures made against each of the orders. In addition, each capture’s page also provides a link to the image in Planet Explorer to download the imagery assets.
Some Dashboard limitations to consider:
- Tasking Dashboard is optimized for Desktop browsers only, currently only Chrome and Firefox
Duplicating / Cloning an Order
Users can use an order as a blueprint to create new orders, so that inputs, especially AOIs don't have to be entered repeatedly. All fields except for the TOI will be copied over to the order entry form, to allow a quick new creation.
Order History
The History tab allows users to comprehend the individual events that happened in an order. From creation over editing to fulfillment the information flows on a timeline.
Deeplink
Users can directly open the order creation window through the following url.
https://www.planet.com/tasking/orders/new
Users may prepopulate order fields in the order creation form by providing additional query parameters after order entry url. For example:
https://www.planet.com/tasking/orders/new/?name=order-name&geometry=POINT(13.2275 52.5897)
To access Deeplink, it is important to always start from order entry route /orders/new then append the query parameters.
https://www.planet.com/tasking/orders/new/?name=TestOrder&plNumber=PL-Example&product=One Time Tasking&geometry=POINT(13.2275 52.5897)
Supported parameters
These are the supported parameters that users may use in the Deeplink URL. Note that all fields are optional. However, product specific fields have plNumber as its dependency.
Fields without dependencies.
| Field | Value |
|---|---|
| name | Maximum 80 characters |
| geometry | Geometry in WKT format |
| plNumber | Valid PL-Number |
Fields that depend on plNumber
| Field | Value |
|---|---|
| product | Product name which belongs to given plNumber |
| startTime | Date in YYYYMMDD or YYYY-MM-DD format i.e., 2020-06-30 |
| endTime | Date in YYYYMMDD or YYYY-MM-DD format and must be later than startTime |
| orderType | Specific order type that is allowed for chosen product |
| nStereoPov | Number of stereo collects for orderType STEREO only |
| cloudCoverMax | Cloud cover max value and can not be less than cloudCoverMin value |
| cloudCoverMin | Cloud cover min value and can not be greater than cloudCoverMax value |
| cloudThreshold | Cloud threshold value |
| imagingConops | Only except 'nominal' and 'high_capacity' as value |
| priority | Priority value equal to or within priorityMin and priorityMax range |
| rank | Only except value from 1 to 10 |
| satAzimuthAngleMax | Satellite azimuth angle max value |
| satAzimuthAngleMin | Satellite azimuth angle min value |
| satElevationAngleMax | Satellite elevation angle max value |
| satElevationAngleMin | Satellite elevation angle min value |
| solarAzimuthAngleMax | Solar azimuth angle max value |
| solarAzimuthAngleMin | Solar azimuth angle min value |
| solarZenithAngleMax | Solar zenith angle max value |
| solarZenithAngleMin | Solar zenith angle min value |
| satelliteHwIds | String of satellite ids separated by comma i.e., s1,s2,s3 etc. |
For example:
https://www.planet.com/tasking/orders/new/?name=SFO order&plNumber=PL-Impact&product=One Time Tasking&orderType=IMAGE&geometry=POINT(-122.38627 37.616862)
Example with all supported params
https://www.planet.com/tasking/orders/new/?name=mock_order&plNumber=PL-TEST&product=Basemap&rank=1&priority=1069&orderType=IMAGE&geometry=POINT (-98.934519 19.724712)&cloudCoverMin=0.1&cloudCoverMax=0.5&cloudThreshold=0.7&imagingConops=nominal&satelliteHwIds=s1,s4,s106,s109&satAzimuthAngleMax=360&satElevationAngleMax=90&satElevationAngleMin=60&solarAzimuthAngleMax=360&solarZenithAngleMax=90&solarZenithAngleMin=60
Email notifications
Via the user menu the user can bring up the email notification settings. This allows to set individual settings for receiving notifications via email for the events mentioned above in Order History.
Rate this guide: