The following queries indicate means to query the results with specific filters.
REGION-BASED FILTERING¶
A user can filter the collection of results by bounding box regions using the bounding box filter. This filters the items in a specific collection of results by those that are detected within a specified bounding box {min Longitude , min Latitude , max Longitude , max Latitude}
Example:
curl --header "Authorization: api-key ${PL_API_KEY}" https://api.planet.com/analytics/collections/886b4dbb-b878-4f6b-b000-0d96cbf71d4d/items\?bbbox\=121.771088,31.209278,121.907043,31.309062
TIME-BASED FILTERING¶
A user can filter the collections of results by bounded time windows or unbounded time windows. Here are a few examples:
Example:
curl --header "Authorization: api-key ${PL_API_KEY}" https://api.planet.com/analytics/collections/886b4dbb-b878-4f6b-b000-0d96cbf71d4d/items\?datetime\=2019-01-18T02:08:40.761735Z
LIST RESULTS¶
A user can paginate through results for a subscription. Results are returned in descending creation order. Result IDs act as cursors when paginating backwards or forwards. To get older pages of results, use the before query parameter with the id of the oldest (last) result in a page of results. When returning to the API to query for newly created results, use the ‘after’ query parameter with the id of the newest (first) result in a page. Results have a created field that can be stored and used later for sorting to determine the oldest or newest result from a previous query.
We are continually working to improve our technical documentation and support. Please help by sharing your experience with us.