PassPrediction for QGIS
Run PassPrediction directly inside QGIS: pass search, image-delivery latency, clear-sky weather, constellation comparison and coverage analysis over your current map extent, with geometry results added as native vector layers. The plugin is free with a PassPrediction account: create one, generate your API key under Account → API, and the plugin runs the same tools as the web app.
What it does for EO planning
- Reads the live capability manifest so the available tools and endpoints always match the web app — no plugin update when a tool changes.
- Drives pass search, latency, clear-sky weather, constellation comparison and coverage analysis over the current QGIS map extent; geometry results (passes, analysis-grid cells, live positions) return as GeoJSON vector layers you can style, join and export like any other QGIS layer.
- Pure Python standard library (urllib / json), no pip dependencies — QGIS-safe and client-side only.
Install in QGIS
- 1Create a free account. Sign up for a free PassPrediction account at https://passprediction.com/register/ (skip this if you already have one), then open Account → API and click Generate API key.
- 2Download the plugin. Download the plugin ZIP from the button on this page.
- 3Install from ZIP. In QGIS open Plugins → Manage and Install Plugins → Install from ZIP, then select the downloaded file.
- 4Enable experimental plugins. If it does not appear, enable Settings → Show experimental plugins, then turn on PassPrediction under Installed.
- 5Connect to the API. Click the PassPrediction toolbar icon to open the panel, leave the server as https://passprediction.com, paste your API key, and click Connect. The plugin checks the key, then fills the tool list; the key is remembered for next time. Without a key it offers links to create a free account and to get your key. See 'Connect to the API' below.
- 6Run a search. Draw or zoom to your area of interest, pick a tool, and run; geometry results are added as a native GeoJSON vector layer.
Connect to the API
The plugin is a thin client of the PassPrediction developer API: every result — pass search, tasking, latency, clear-sky weather, constellation comparison and coverage analysis — is computed server-side and returned over HTTPS as GeoJSON. It performs no orbital computation locally, so a working connection is required. You need two things:
- 1Server URL. Leave the default https://passprediction.com. The plugin calls the developer endpoints under /api/v1/external/ on that host.
- 2API key. The plugin and the API are free, but they need a PassPrediction account. Create one at passprediction.com/register, then open Account → API and Generate or Regenerate your key yourself — the full key is shown once, so copy it right away. Treat it like a password: the plugin sends it as an Authorization: Bearer header and stores it locally in your QGIS settings, never in a project file.
- 3Connect. Open the PassPrediction panel from the toolbar icon, enter the server and key, and click Connect. The plugin checks the key with one authenticated call, then reads the capability manifest so the tool list and endpoints always match the web app. The tools stay disabled until the key is confirmed. The key is remembered for next time.
Results are model outputs derived from public orbital data (TLE) and nominal sensor parameters — estimates for planning, not a satellite operator’s actual capacity or commitment. Accuracy depends on TLE currency: pass geometry is representative, but exact pass dates and times can drift for satellites with stale element sets or that are recently launched or actively manoeuvring — verify timing against the operator before any firm tasking.
Advanced: OGC map services
You can also add PassPrediction as raster layers in QGIS (or any OGC client) via the standards-based endpoints — no plugin required:
- WMS 1.3.0 — https://passprediction.com/api/v1/ogc/wms/
- WMTS 1.0.0 — https://passprediction.com/api/v1/ogc/wmts/
Frequently asked
- Do I need an account to use the QGIS plugin?
- Yes. The plugin and the API are free, but they only work with a PassPrediction account and its API key, sent as an Authorization: Bearer header. The plugin computes nothing locally — every result comes from the developer API — so a key and an internet connection are required.
- How do I get an API key?
- Create a free PassPrediction account, sign in and open Account → API, then click Generate (or Regenerate) to issue your key yourself — keys are self-serve and free. The full key is shown once at that moment, so copy it immediately. Paste it into the plugin's API key field once; it is remembered in your QGIS settings.
- Which API does the plugin call?
- The PassPrediction developer API at https://passprediction.com/api/v1/external/. It reads the public capabilities manifest (tools, endpoints, latest plugin version) and drives whatever the server advertises, so the plugin stays in sync with the web app without an update. Every tool call is authenticated with your API key.
- Which QGIS version does the plugin require?
- QGIS 3.22 or newer. The plugin uses only the Python standard library, so there are no pip dependencies to install.
- Can I use PassPrediction layers without the plugin?
- Yes. PassPrediction also serves OGC WMS 1.3.0 and WMTS 1.0.0 endpoints you can add as raster layers in QGIS or any OGC client.