Ground station contention and GSaaS scheduling
Ground station as a service (GSaaS) networks rent antenna time at shared sites. When several satellites on the same band are above a station's mask at once, they compete for its antennas, and the pass you want can be taken or cut short. Knowing how contested a pass will be before you book it is the difference between a plan and a hope.
What drives contention
| Factor | Why it matters |
|---|---|
| Satellites in view on your band | Each one is a candidate for the same antennas during your pass |
| Antennas on your band | More antennas spread the same demand thinner |
| Separation angle | Two satellites close together in the sky, on overlapping downlinks, cannot both be served |
| Who actually uses the site | Licences, filings and announcements say which satellites use which station |
Estimate your share of each pass
The Satellite demand model prices one pass of your satellite over each station that receives its band:
| Output | Meaning |
|---|---|
p_free | Your minute-weighted share of the station's antennas on your band over the pass. 1 means no contention. An index for ranking, not a calibrated probability. |
num_links_p50, p90, p99 | How many links the station could be serving on your band during the pass, at the median and busiest moments |
sats_in_view | Competitors above the mask during the pass |
evidence_share | How much of that competition the public evidence confirms |
curl --fail-with-body -sS -G \
-H "x-api-key: $CONSTELLATION_API_KEY" \
"https://api.constellation.space/predictions" \
--data-urlencode "model_family=demand" \
--data-urlencode "satellite_id=sat-1" \
--data-urlencode "target_at=$(date -u -v+1H +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u -d '+1 hour' +%Y-%m-%dT%H:%M:%SZ)"
Leave out ground_station_id and you get one item for every station on your band that the satellite passes over. What moves p_free is in What p_free measures.
The model does not book antennas or see other customers' bookings: no provider exposes them. It estimates contention from orbit geometry, band rules and public evidence.
Plan around busy passes
- Choose the station. For each pass, pick the station where your satellite competes with the fewest others on its band.
- Flag before booking. Treat a pass whose
p_freefalls below a level you set as one to back up. - Swap before the cancel deadline. The
rain-fade-swaptemplate names a backup pass and the last moment to act. For a pass booked with a GSaaS provider, the workflow results carry the provider's cancel deadline. See the results protocol. - For station owners. The
antenna-capacitytemplate sums sellable minutes and expected GB per antenna per UTC day.
Common questions
What is ground station as a service?
GSaaS is a model where an operator rents antenna time on a provider ground network by the pass or by the minute instead of building its own stations. Many satellites share each site, so access depends on who else is in view.
Can Constellation see other customers bookings on a ground network?
No. No provider exposes them. The Satellite demand model estimates contention from orbit geometry, band rules and public evidence of which satellites use which station.
Does the demand model need my telemetry?
No. It reads your satellite, its downlink radio and your stations from the network config, and the orbit from your TLE or the orbit catalog.