Written By: KiyoWx & StarflightWx
Last Updated: Feb 27th, 2026

Placefile Configurations

---

The placefiles.jsonc configuration file defines how AtmosphericX generates, caches, and distributes dynamic GRLevelX compatible placefile layers for radar and mapping software.

Key functions include:

• The placefile_settings section controls a global cache duration, which determines how long placefiles are stored before being regenerated, balancing performance with near real-time accuracy.
• Each data layer including events, tracking, discussions, live streams, and PulsePoint. This can be individually enabled or disabled, allowing you to control which endpoints are publicly exposed.
• Every layer also includes optional geographic filtering settings, which can restrict output by radius using configurable units (miles or kilometers), ensuring that only data within a defined distance is included in the generated placefile.

Configuration Map

placefiles.jsonc
├── placefiles:hash
└── placefile_settings
    ├── cache_duration
    ├── events
    │   ├── enabled
    │   └── filters
    │       ├── enabled
    │       ├── filter_units
    │       └── filter_by_radius
    │
    ├── tracking
    │   ├── enabled
    │   └── filters
    │       ├── enabled
    │       ├── filter_units
    │       └── filter_by_radius
    │
    ├── discussions
    │   ├── enabled
    │   └── filters
    │       ├── enabled
    │       ├── filter_units
    │       └── filter_by_radius
    │
    ├── streams
    │   ├── enabled
    │   └── filters
    │       ├── enabled
    │       ├── filter_units
    │       └── filter_by_radius
    │
    └── pulsepoint
        ├── enabled
        └── filters
            ├── enabled
            ├── filter_units
            └── filter_by_radius