# EPA Air Quality System (AQS) API Configuration
# DS-00008 — Environmental Health & Quality of Life Indicators

# ============================================================================
# AUTHENTICATION
# ============================================================================

# Your email address (used for API authentication)
# Register at: aqs.support@epa.gov
# Or: https://aqs.epa.gov/data/api/signup?email=your_email@example.com
AQS_EMAIL=your_email@example.com

# Your AQS API key (provided upon registration)
# This is a unique identifier, not a password
AQS_API_KEY=your_api_key_here

# ============================================================================
# RATE LIMITING
# ============================================================================

# EPA AQS enforces strict rate limits:
# - 10 requests per minute (HARD LIMIT)
# - Account suspension if violated
#
# The update.ts script automatically enforces 6-second delays between requests
# (10 req/min = 1 request per 6 seconds)
#
# Do NOT modify rate limiting logic without understanding consequences.

# ============================================================================
# REGISTRATION INSTRUCTIONS
# ============================================================================

# 1. Email aqs.support@epa.gov requesting API access
#    Subject: "AQS API Access Request"
#    Body: "Please provide API key for email: your_email@example.com"
#
# 2. OR use automated signup:
#    curl "https://aqs.epa.gov/data/api/signup?email=your_email@example.com"
#
# 3. You will receive an API key via email (typically within minutes)
#
# 4. Copy your email and API key to this .env file:
#    - Remove .example extension: mv .env.example .env
#    - Replace your_email@example.com with your actual email
#    - Replace your_api_key_here with your actual API key
#
# 5. NEVER commit .env to git (already in .gitignore)

# ============================================================================
# IMPORTANT NOTES
# ============================================================================

# - API key is FREE and requires no approval (automated)
# - No daily limit (only per-minute limit of 10 requests)
# - Data is public domain (no usage restrictions)
# - Validation lag: 6-12 months for finalized data
# - For real-time data, use AirNow API instead: https://www.airnow.gov/

# ============================================================================
# ENVIRONMENTAL HEALTH CONTEXT
# ============================================================================

# Air quality is a structural determinant of wellbeing.
#
# You cannot "self-care" your way out of breathing toxic air.
#
# PM2.5 exposure reduces life expectancy by months to years in polluted areas.
# Environmental injustice: Low-income communities and communities of color
# are disproportionately exposed to air pollution.
#
# This data enables:
# - Environmental justice research (exposure disparities)
# - Life expectancy modeling (PM2.5 impact on longevity)
# - Policy evaluation (Clean Air Act effectiveness)
# - Health equity analysis (structural determinants of wellbeing)