Windnavigator API Documentation

compass_payload = {
    "key": "your-api-key",
    "product": "stats",
    "latitude": 36.12361,
    "longitude": -95.37542,
    "height": 250,
}

reanalysis_payload = {
    'key': 'your-api-key',
    'latitude': 39.38832449859204,
    'longitude': -97.63412475585938,
    'dataset': 'era5-100',
    'product': 'reanalysis',
}

import pandas as pd
from io import StringIO

# After getting the response from Global Reanalysis API
if response.status_code == 200:
    # Skip header lines and read CSV data
    csv_data = response.text
    
    # Find where the actual CSV data starts (after the header comments)
    lines = csv_data.split('\n')
    csv_start = 0
    for i, line in enumerate(lines):
        if line.startswith('Date/time'):
            csv_start = i
            break
    
    # Read the CSV data into a pandas DataFrame
    csv_content = '\n'.join(lines[csv_start:])
    df = pd.read_csv(StringIO(csv_content))
    
    # Convert datetime column
    df['Date/time [UTC]'] = pd.to_datetime(df['Date/time [UTC]'])
    
    # Now you can analyze the time series data
    print(f"Data range: {df['Date/time [UTC]'].min()} to {df['Date/time [UTC]'].max()}")
    print(f"Mean wind speed: {df['Speed_100m [m/s]'].mean():.2f} m/s")
    print(f"Total records: {len(df)}")

wrfts_payload = {
            "key": "your-api-key",
            "email": "user@example.com",
            "point_list": [
                "45.55667788,21.33445566",
                "45.55667788,23.33445566",
                "43.55667788,21.33445566",
                "43.55667788,23.33445566"
            ],
            "height": ["100", "150", "200"],
            "start_date": "2023-01",
            "end_date": "2023-12",
            "temp_resolution": "60",
            "name": "Multi-Point Wind Farm Site"
        }

{
            "status": "ok",
            "job_id": 12345
        }

wrg200_payload = {
    "key": "your-api-key",
    "name": "Wind Resource Study",
    "email": "user@example.com",
    "latitude": 36.12361,
    "longitude": -95.37542,
    "height": ["100", "150", "200"]
}

{
            "status": "ok",
            "job_id": 12346
        }

wrg50_payload = {
    "key": "your-api-key",
    "name": "High-Resolution Wind Study",
    "email": "user@example.com",
    "longitude1": -95.5,
    "latitude1": 36.0,
    "longitude2": -95.3,
    "latitude2": 36.2,
    "height": ["80", "100", "120", "150"],
    "elevation": "srtm30m",
    "landcover": "esa2021",
    "sectors": "16"
}

{
    "status": "ok",
    "job_id": 12347
}

download_payload = {
    "key": "your-api-key",
    "email": "user@example.com",
    "job_id": 12345
}

# First request without file_index to see available files
download_payload = {
    "key": "your-api-key",
    "email": "user@example.com",
    "job_id": 12345
}

# If multiple files exist, specify file_index
download_payload_specific = {
    "key": "your-api-key",
    "email": "user@example.com", 
    "job_id": 12345,
    "file_index": 1  # Download second file
}

import requests
import json

def download_job_file(api_key, email, job_id, file_index=None):
    """Download job file with automatic multi-file handling"""
    
    download_url = 'https://ul-renewables.com/api/downloadJobFile'
    
    payload = {
        "key": api_key,
        "email": email,
        "job_id": job_id
    }
    
    # Add file_index if specified
    if file_index is not None:
        payload["file_index"] = file_index
    
    response = requests.post(download_url, json=payload)
    
    if response.status_code == 200:
        # Check if response is JSON (multiple files info) or file download
        try:
            json_response = response.json()
            if json_response.get('status') == 'multiple_files':
                print("Multiple files available:")
                for file_info in json_response['files']:
                    print(f"  Index {file_info['index']}: {file_info['name']}")
                return json_response
        except json.JSONDecodeError:
            # Response is a file download
            filename = f"job_{job_id}_file_{file_index or 0}.zip"
            with open(filename, 'wb') as f:
                f.write(response.content)
            print(f"Downloaded: {filename}")
            return filename
    else:
        print(f"Error: {response.status_code} - {response.text}")
        return None

# Usage example
job_result = download_job_file("your-api-key", "user@example.com", 12345)

# If multiple files, download specific file
if isinstance(job_result, dict) and job_result.get('status') == 'multiple_files':
    download_job_file("your-api-key", "user@example.com", 12345, file_index=0)

import requests
import json

# API Configuration
API_KEY = 'your-api-key-here'
API_URL = 'https://ul-renewables.com/api'

# Common headers
headers = {
    'Content-Type': 'application/json'
}

def make_api_request(payload, request_type):
    """Make API request and handle response"""
    print(f"\n--- {request_type} REQUEST ---")
    print(f"Payload: {json.dumps(payload, indent=2)}")
    
    response = requests.post(API_URL, headers=headers, json=payload)
    
    if response.status_code == 200:
        print(f"✓ Success: {response.status_code}")
        print(f"Response: {response.text[:1000]}")
        return response.json() if response.text else None
    else:
        print(f"✗ Error: {response.status_code} - {response.text}")
        return None

# 1. COMPASS STATS REQUEST
print("="*60)
print("TESTING COMPASS STATS DATA")
print("="*60)

compass_payload = {
    "key": API_KEY,
    "product": "stats",
    "latitude": 36.12361,
    "longitude": -95.37542,
    "height": 250,
}

compass_result = make_api_request(compass_payload, "COMPASS STATS")

# 2. GLOBAL REANALYSIS REQUEST
print("\n" + "="*60)
print("TESTING GLOBAL REANALYSIS DATA")
print("="*60)
print("Available datasets: era5-100, era5-10, merra2-50")

reanalysis_payload = {
    'key': API_KEY,
    'latitude': 39.38832449859204,
    'longitude': -97.63412475585938,
    'dataset': 'era5-100',
    'product': 'reanalysis',
}

reanalysis_result = make_api_request(reanalysis_payload, "GLOBAL REANALYSIS")

# 3. OPTIONAL: Test multiple datasets
print("\n" + "="*60)
print("TESTING MULTIPLE REANALYSIS DATASETS")
print("="*60)

datasets = ['era5-100', 'era5-10', 'merra2-50']
for dataset in datasets:
    multi_payload = {
        'key': API_KEY,
        'latitude': 39.38832449859204,
        'longitude': -97.63412475585938,
        'dataset': dataset,
        'product': 'reanalysis',
    }
    
    print(f"\nTesting dataset: {dataset}")
    result = make_api_request(multi_payload, f"REANALYSIS - {dataset.upper()}")

print("\n" + "="*60)
print("API TESTING COMPLETE")
print("="*60)