Alle Versionen von TPE (The Photographer’s Ephemeris) verwenden ein standardisiertes URL-Format. Du kannst deine eigenen URLs erstellen (z. B. mit einem Skript-Tool oder indem du die Adresse in deinem Browser manuell bearbeitest) und sie frei verwenden – sie öffnen sich wie gewohnt in der Web- oder iOS-App.
Standardbeispiel
Hier ein Beispiel:
In diesem Beispiel werden die Parameter wie folgt verwendet:
| Parameter | Wert | Verwendung |
|---|---|---|
| ll | 63.939897,-17.369803 | Position der roten Markierung. Breiten- und Längengrad-Paar in Dezimalgraden. Negative Längengrade stehen für Westen. |
| center | 63.9586,-17.3145 | Kartenmitte. Breiten- und Längengrad-Paar in Dezimalgraden. Negative Längengrade stehen für Westen. |
| z | 9 | Zoomstufe. Wert zwischen 0 und 21 (der Maximalwert kann bei bestimmten Kartentypen geringer sein). |
| spn | 0.64,3.09 | Spanne. Dezimalgrad-Paar, das die Breiten- und Längenspanne angibt. Entspricht der Zoomstufe. Verwende eines von beiden. |
| dt | 2017-01-25T17%3A04%3A00.000Z | Datum/Uhrzeit. Datum und Uhrzeit im ISO‑8601‑Format mit Millisekunden‑Präzision. ‘%3A’ ist die URL‑kodierte Form von ‘:’ |
| sll | 63.972628,-17.052924 | Sekundäre Markierungsposition (optional). Breiten- und Längengrad-Paar in Dezimalgraden. Negative Längengrade stehen für Westen. |
Beispiel mit Gebäudehöhen
Erweitertes Beispiel
Ein erweitertes Beispiel, das Gebäudehöhen und Grundflächen größen enthält:
Hier ist eine Liste der weiter oben nicht genannten Parameter:
| Parameter | Wert | Verwendung |
|---|---|---|
| sh | 5.00 | Höhe des primären Objekts in Metern. z. B. die Höhe der Kamera über dem Boden |
| ch | 30.00 | Höhe des sekundären Objekts in Metern. z. B. die Höhe eines Gebäudes |
| sw | 10 | Gebäudegrundfläche in Metern an der primären Markierung |
| cw | 60 | Gebäudegrundfläche in Metern an der sekundären Markierung |
URL‑Parameter für Visual Search
Die folgenden URL‑Parameter sind für die zukünftige Verwendung mit der Visual Search‑Funktion reserviert.
| Parameter | Beispiel | Verwendung |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azimut-/Höhen‑Ziel. Komma‑getrenntes az/alt‑Ziel, gefolgt von az/alt‑Toleranz, alles in Grad |
| vsaltp | vsaltp=false | Höhenpriorität. Bestimmt, ob die Suche für die Höhe (true, Standard) oder den Azimut (false) interpoliert |
| vsd | vsd=15811200 | Suchdauer. Länge des Suchzeitraums in Sekunden, bezogen auf das in der App ausgewählte Datum/Uhrzeit (verwende den ‘dt’‑Parameter, um Datum/Uhrzeit festzulegen) |
| vsr | vsr=false | Bereichsmodus. Bereichsmodus (true, Standard) oder Einzelzielmodus (false). Im Bereichsmodus prüft die Suche, ob der Zielkörper die Grenzen der mit dem ‘vsaa’‑Parameter angegebenen az/alt‑Region überschreitet. Im Einzelzielmodus interpolieren wir die Priorität. |
| vsb | vsb=moon | Körper. ‘sun’, ‘moon’ oder ‘gc’ (galactic center). Der zu betrachtende Körper. |
| vsa | vsa=-1 | Scheiben‑Ausrichtung. -1, 0 oder 1. Für Körper mit bekanntem Semidurchmesser (sun, moon) gibt an, ob der Körper anhand des unteren Rands (-1), der Mitte (0, Standard) oder des oberen Rands (+1) der Scheibe ausgerichtet werden soll |
Visual Search‑Filter
Visual Search‑Filter können in der URL mit dem ‘vsf’‑Parameter kodiert werden, wie folgt:
vsf=b:[body]|p:[property]|v:[value_range]
wobei:
- body: sun, moon oder gc
- property: az (azimut), alt (scheinbare Höhe), ill (beleuchteter Anteil), wax (waxing), sd (semidiameter)
- value_range: komma‑getrennte minimale und maximale Werte, z. B. 90,100 für Azimut (Grad), 0.95,1 für den beleuchteten Anteil des Mondes, 0,0 für waxing = false oder 1,1 für waxing = true
Der ‘vsf’‑Parameter kann mehrere Filterbedingungen mittels Semikolon getrennt angeben, z. B.:
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
Das Beispiel verlangt, dass die Mondscheibe > 95% beleuchtet ist und die Sonne zwischen 6 und 0 Grad unter dem Horizont liegt (d. h. bürgerliche Dämmerung).
