download-data

You are helping the user download NAIP aerial imagery using geoai.

Input: $@

Follow these steps in order.

Step 1 -- Parse arguments

Extract the bounding box from the first argument (comma-separated minx,miny,maxx,maxy).

Parse optional flags from remaining arguments:

• --year YYYY -> download year (default: most recent available)
• --output DIR -> output directory (default: ./naip_data/)
• --max-items N -> maximum number of items to download (default: 10)

If the input is natural language (e.g. "download NAIP imagery for Knoxville, TN"), extract or infer the bounding box. If you cannot determine the bbox, ask the user for coordinates.

Step 2 -- Validate the bounding box

Confirm the bounding box has 4 numeric values and represents a valid geographic extent:

• minx < maxx and miny < maxy
• Longitude values within -180 to 180
• Latitude values within -90 to 90
• The area is not unreasonably large (warn if the bbox spans more than 1 degree in either direction)

If validation fails, report the issue and ask for corrected coordinates.

Step 3 -- Run the download

python3 -c "
import geoai, os

bbox = (MINX, MINY, MAXX, MAXY)
output_dir = 'OUTPUT_DIR'
os.makedirs(output_dir, exist_ok=True)

result = geoai.download_naip(
    bbox=bbox,
    output_dir=output_dir,
    year=YEAR,
    max_items=MAX_ITEMS,
)
if isinstance(result, list):
    for f in result:
        size_mb = os.path.getsize(f) / (1024 * 1024) if os.path.exists(f) else 0
        print(f'{f} ({size_mb:.1f} MB)')
    print(f'Total files: {len(result)}')
elif isinstance(result, str):
    size_mb = os.path.getsize(result) / (1024 * 1024) if os.path.exists(result) else 0
    print(f'{result} ({size_mb:.1f} MB)')
else:
    print(f'Result: {result}')
"

Replace MINX, MINY, MAXX, MAXY, OUTPUT_DIR, YEAR, and MAX_ITEMS with actual values.

For the year parameter:

• If --year was specified, use that value (e.g. year=2022)
• If not specified, omit the parameter or pass year=None to get the most recent available