🔑 Request a Free API Key

Register below to receive an instant API key for downloading GUC Lab public datasets via wget, curl, or Python scripts.

💻 How to Download Datasets via Command-Line

You can download datasets directly to your Linux / macOS terminal, workstation, or HPC cluster using wget or curl.

1. Single File Download (wget)

wget "https://urbanclimate.tse.ens.isct.ac.jp/api/v1/download/public/AHE/AH4GUC/present/AHE_SSP3_2010_01_00HR_UTC.tif?api_key=YOUR_API_KEY" -O AHE_SSP3_2010_01_00HR_UTC.tif

2. Explore Available Files via API Catalog (JSON)

curl -H "X-API-Key: YOUR_API_KEY" "https://urbanclimate.tse.ens.isct.ac.jp/api/v1/catalog/public?subfolder=AHE/AH4GUC/present"

3. Batch Download Hourly Heat Flux Datasets (Bash Script)

#!/bin/bash
API_KEY="YOUR_API_KEY"
BASE_URL="https://urbanclimate.tse.ens.isct.ac.jp/api/v1/download/public/AHE/AH4GUC/present"

# Download all 24 hourly GeoTIFFs for January 2010 (UTC)
for hr in $(seq -w 0 23); do
    FILENAME="AHE_SSP3_2010_01_${hr}HR_UTC.tif"
    echo "Downloading ${FILENAME}..."
    wget -c "${BASE_URL}/${FILENAME}?api_key=${API_KEY}" -O "${FILENAME}"
done