77 lines
3.1 KiB
Plaintext
77 lines
3.1 KiB
Plaintext
# 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)
|