Overview

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, area, or stereo orders by inputting various parameters in the order creation windows below:

Point Order

Area Order

Stereo Order

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

  • Users are automatically logged out from Tasking Dashboard after 24 > hours.

Deeplink

Users may prepopulate order fields in the order creation window by providing additional parameters in the URL. For example:


https://www.planet.com/tasking/orders/new/#/name/order-name/geometry/POINT(13.2275 52.5897)

Users can directly access the order creation window through the following url.


https://www.planet.com/tasking/orders/new

To access Deeplink, users shall construct the url by first adding a hash followed by adding pairs of field and value.


https://www.planet.com/tasking/orders/new/#/${field}/${value}/${field2}/${value2}/...

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 depends on plNumber

Field Value
product Product name which belongs to given plNumber
startTime Date in YYYY-MM-DD format i.e., 2020-06-30
endTime Date in 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

Please note that product and orderType values are case sensitive.

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)