Overview

last updated: August 09, 2022

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 2 km radius circle is automatically added to your coordinates representing the guaranteed area to be collected.

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.

Flexible Order

A flexible order purchases SkySat capacity at various areas of interest. There are no guarantees on delivery timeframe. The duration is measured from the start date to the end date of the time of interest. The duration must be at least 14 calendar days and must be placed no less than 24 hours prior to the start date of the time of interest.

To create a Flexible Order, at least 24 hours prior to the start of the time of interest:

  1. Select "Flexible Tasking" as your product name.
  2. Set the end date to a date at least 14 days later in the future than the start date.
  3. Set the other required values:
    • The geometry type
    • Your area of interest
    • The order type (image or stereo)
    • An off-nadir angle

You can change the duration of the flexible order by changing the start or end date. The start date can only be changed if the order is pending. The end date can only be changed if the order state is pending or in progress.

To change the date on orders, hover over the date and select the checkmark to change the values of the date-time calendar.

Flexible Order Change Time

You can also change the date in the order detail view when you select it from the orders list:

  1. Hover over the date-time field and select the pencil icon. Flexible Order Change Time Detail 1
  2. Change the date-time. Flexible Order Change Time Detail 2
  3. Confirm by selecting the checkmark icon. Flexible Order Change Time Detail 3

Historical cloud coverage

When you create a flexible order, you introduce the seven-day historical average of cloud coverage. This additional adjustment can increase transparency and improve order delivery. You can filter the data for one month, three months, six months, or one year. Note that not all periods are always available. If you hover over a bar in the Cloud Coverage chart, the seven-day average value appears. The lower the bar, the lower the seven-day average historical cloud cover in the area of your order.

Historical Cloud Cover

Deleting an order geometry

Delete

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 Order

Stereo orders allow you to take two or three captures of the same point in one go.

Monitoring Order

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.

Monitoring Daily
Monitoring Weekly
Monitoring Monthly

Off-nadir angle warnings

Off-nadir angle warnings call out values that may be difficult to schedule or may result in image capture failure. The following conditions cause a warning to appear in the ANGLES dialog box.

Off-nadir angle is higher than 40º

The warning appears when the off-nadir angle value is higher than 40 degrees.

Off-Nadir angle value is higher than 40 degrees

Off-nadir angles range is too small

The warning appears when the range between the minimum and maximum off-nadir angles is lower than 10 degrees.

Off-Nadir angles range is too small

Off-nadir angles that may lead to a processing failure

The warning appears when the off-nadir angle value is higher than 40 degrees and the range between the minimum and maximum off-nadir angles is lower than 10 degrees.

Off-Nadir angles may cause processing error

Order Progress

Customers may check the status of all of their orders in the Order Progress Table or Map views.

Order Progress – Table View

Table View

Order Progress – Map View

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.

Viewport as geo-filter

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.

Table with Flyout

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. For point orders, a 25 sq km box is drawn around your area of interest within the collect.

Order Detail View

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.

Order History

Captures Table

If you want a complete overview of all your captures, you can use the captures table. You can filter it, sort the columns, and change the visibility of columns similar to the Orders Table.

Captures Table

If you click on a row in the captures table, the capture modal shows up. You can paginate through all of your captures.

Capture modal

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)

Order Entry

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.

Email Preferences


Rate this guide: