Download satellite/raster data from Microsoft Planetary Computer.

Automatically detects collection from natural language queries, handles geocoding for place names, downloads and crops data, generates RGB visualizations.

Parameters

query : str Natural language query describing the data you want. Examples: "sentinel-2 imagery", "landsat", "naip aerial photos", "elevation data", "land cover" aoi : str or list[float] Required. Area of interest as either: - Place name string: "Seattle, WA", "Paris, France", "Central Park, NY" - Bounding box list: [west, south, east, north] in degrees Example: [-122.4, 47.5, -122.3, 47.6] time_range : str or None, optional ISO8601 datetime range. Defaults to last 7 days if not provided. Examples: "2024-01-01/2024-01-31", "2024-06-01/2024-06-30" output_dir : str, optional Directory to save outputs. Defaults to current directory. max_cloud_cover : int, optional Maximum cloud cover percentage for optical data (0-100). Default: 20

Returns

list[TextContent] File paths and metadata

Examples

Download recent Sentinel-2 imagery of Paris: query="sentinel-2 imagery", aoi="Paris, France"

Download Landsat for a specific bbox and time: query="landsat", aoi=[-122.4, 47.5, -122.3, 47.6], time_range="2024-06-01/2024-06-30"

Download NAIP aerial imagery: query="naip aerial photos", aoi="Central Park, NY"

Download vector geometries from Planetary Computer.

Parameters

collection : str Collection ID (e.g., "ms-buildings") aoi : list[float] or str Bounding box [W,S,E,N] or place name string output_dir : str, optional Directory to save outputs

Returns

list[TextContent] File paths and metadata