ZenithAPI Radar Documentation

Overview

ZenithAPI Radar is a real-time satellite tracking system that provides live visualization of satellites visible from your location. The application combines accurate orbital data with an interactive radar interface to help users track satellites as they pass overhead.

How to Use the Radar Application

Getting Started

1. Enable Location Access - The radar requires your geographic location to calculate satellite positions relative to your position
2. Allow JavaScript - The interactive radar interface requires JavaScript to function
3. Wait for Data Loading - The system fetches satellite data and calculates positions (this may take some time)

Understanding the Radar Interface

Radar Display Elements

The radar screen consists of several key elements:

• Concentric Circles - Three circles representing different elevation levels:
  • Outer circle: 0° elevation (horizon)
  • Middle circle: 30° elevation
  • Inner circle: 60° elevation
• Direction Markers - N, S, E, W indicators showing compass directions
• Radial Lines - Lines at 45° intervals (0°, 45°, 90°, 135°, 180°, 225°, 270°, 315°)
• Scanning Beam - Animated rotating beam that sweeps around the radar
• Satellite Dots - Colored dots representing satellites at their current positions

Satellite Parameters Explained

Each satellite displays several key parameters:

Basic Information

• Name - Official satellite designation (e.g., “ISS (ZARYA)”, “HST”)
• NORAD ID - Unique catalog number assigned by North American Aerospace Defense Command

Positional Data

• Azimuth - Compass direction from observer (0-360°)
  • 0° = North
  • 90° = East
  • 180° = South
  • 270° = West
• Elevation - Height above horizon (0-90°)
  • 0° = Horizon
  • 45° = Mid-sky
  • 90° = Directly overhead (zenith)
• Range - Distance from observer to satellite (in kilometers)

Visibility Status

• Visible - Whether the satellite can be seen
• Observer Daytime - Whether it’s daytime at your location
• Satellite Sunlit - Whether the satellite is illuminated by sunlight

Status Indicators

The application uses visual indicators to show important conditions:

Daylight Status

• 🌙 Moon Icon - Nighttime conditions (optimal for satellite observation)
• ☀️ Sun Icon - Daytime conditions (satellites not visible due to sunlight)

Satellite Illumination

• 🛰️ Bright Satellite - Satellite is sunlit and potentially visible

Understanding Visibility

When Satellites Are Visible

Satellites are most visible when:

1. Nighttime - Sun is below the horizon at your location
2. Satellite Sunlit - Satellite is illuminated by sunlight
3. High Elevation - Satellite is well above the horizon (>10°)
4. Clear Sky - No cloud cover or atmospheric interference

Connection Status

The connection indicator shows:

• 🟢 Connected - Data is being received successfully
• 🟡 Connecting - Attempting to fetch satellite data or experiencing connection issues

This documentation covers the core functionality of ZenithAPI Radar. For API specifications, refer to the API Documentation.