Request Non-overlapping PlanetScope Imagery

[estep]

Hi there,

I’m wondering if there is a parameter in the Processing API to request PlanetScope data that doesn’t overlap? The overlapping swaths in my AOI are increasing my requested area, which I would like to avoid if possible. Thank you!

[chung.horng (Chung)]

Hi @estep ,

Are you trying to avoid ordering overlapping PlanetScope imagery using Third Party Data Import API or requesting PlanetScope data using Processing API which has already been ingested to your BYOC collection?

[estep]

Thanks for your reply. We’re trying to search and order PlanetScope imagery using the Processing API. Here is an example snip of the code:

# Imagery Search

url = "https://services.sentinel-hub.com/api/v1/dataimport/search"

query = {
    "provider": "PLANET",
    "bounds": {
        "geometry": {
  "type": "Polygon",
  "coordinates": [...]
 "data": [
        {
            "itemType": "PSScene",
            "productBundle": "analytic_sr_udm2",
            "dataFilter": {
                "timeRange": {
                    "from": "2022-07-01T00:00:00.000Z",
                    "to": "2022-08-01T00:00:00.000Z"
                },
                "maxCloudCoverage": 10,
                "nativeFilter": {
                    "type": "StringInFilter",
                    "field_name": "quality_category",
                    "config": [
                        "standard"
                    ]
                }
            }
        }
    ]
}

response = oauth.post(url, json=query)
response.raise_for_status()

results = response.json()

 # Imagery Order
payload = {
    "name": "PlanetScope_v2",
    # collectionId is optional. Remove it to create a new collection.
    "collectionId": "8877ac60-5507-4d00-9030-7177c75a7566",
    "input": {
        "provider": "PLANET",
        "planetApiKey": "Planet API Key",
        "bounds": {
             "geometry": {

        "type": "Polygon",
        "coordinates": [...]
},
        "data": [
            {
                "itemType": "PSScene",
                "productBundle": "analytic_sr_udm2",
                "harmonizeTo": "NONE",
                "itemIds": item_ids
            }
        ]
    }
}

[chung.horng (Chung)]

Hi @estep ,

There is no such a parameter which automatically filters out items having overlapping area in search or order requests.

One thing you could make use of is the Product geometry coverage returned from search requests. For example, the following search request returns 3 items acquired on the same date over the AOI with overlapping areas.

curl -X POST https://services.sentinel-hub.com/api/v1/dataimport/search \
 -H 'Content-Type: application/json' \
 -H 'Authorization: Bearer ' \
 -d '{
  "provider": "PLANET",
  "bounds": {
    "bbox": [
      12.44693,
      41.870072,
      12.541001,
      41.917096
    ]
  },
  "data": [
    {
      "itemType": "PSScene",
      "productBundle": "analytic_sr_udm2",
      "dataFilter": {
        "timeRange": {
          "from": "2023-10-02T00:00:00Z",
          "to": "2023-10-02T23:59:59Z"
        },
        "maxCloudCoverage": 100
      }
    }
  ]
}'

Looking at the Product geometry coverage , you’ll see that one of the items completely covers the AOI and the other two only cover the AOI partially. With this info you could order the one having 100% coverage only and skip the others. In case you’d like to filter with much complex condition, you’ll need to do it with tile geometries yourself.

[estep]

Understood. Thank you for your help!