Object Detection Monitoring

Ordering and downloading object detection data is in limited release and is not currently available to all accounts.

This example shows an MGP Monitor for object detections. The monitor looks for an imagery match within the specified Area of Interest (AOI) and date range. Additional filters may also be applied. Once a match is found, an order is automatically placed for the object detections GeoJSON file. The source image can optionally be ordered and delivered as a GeoTIFF for an additional charge. See Object Detection Ordering for settings descriptions.

Note that since Object Detection uses the Raster Analytics API to generate the source image, the monitor should be triggered when the image is ingested into Raster Analytics. To limit the monitor to only these events, include a filter that matches on the collection cloud-optimized-archive. See the Discovery/Catalog Source Guide for more information.

"match_criteria": {
  "collection": {
    "eq": "cloud-optimized-archive"
  }
}

To maximize detections you may also want to set limits on cloud cover:

"eo:cloud_cover": {
    "lt": 10
}

Example

{
    "description": "WM Vehicle Detection",
    "aoi_geojson": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    -105.000298,
                    39.911555
                ],
                [
                    -105.000298,
                    39.914018
                ],
                [
                    -105.003495,
                    39.914018
                ],
                [
                    -105.003495,
                    39.911555
                ],
                [
                    -105.000298,
                    39.911555
                ]
            ]
        ]
    },
    "order_templates": [
        {
            "pipeline": "insights/object-detection",
            "template": {
                "settings": {
                    "image": false,
                    "mask": false,
                    "inputs": {
                        "type": "FeatureCollection",
                        "features": [
                            {
                                "type": "Feature",
                                "geometry": "$._aoi_intersection",
                                "properties": {
                                    "image": "$.id",
                                    "model": "Vehicle"
                                }
                            }
                        ]
                    }
                },
                "output_configs": [
                    {
                        "type":"amazon_s3",
                        "bucket":"s3-bucket-name",
                        "prefix": "s3-prefix-name"
                    }
                ],
                "notifications": [
                    {
                        "level": "INITIAL_FINAL",
                        "target": "myemail@email.com",
                        "type": "email"
                    }
                ]
            }
        }
    ],
    "match_criteria": {
        "eo:cloud_cover": {
            "lt": 10
        },
        "collection": {
          "eq": "cloud-optimized-archive"
        }
    },
    "monitor_notifications": [
        {
            "target": "user@example.com",
            "type": "email"
        }
    ],
    "source": "discovery/catalog"
}