Alle Versionen von The Photographer’s Ephemeris verwenden ein Standard-URL-Format. Du kannst eigene URLs (z. B. mit einem Skripting-Tool oder indem du die Adresse in deinem Browser manuell bearbeitest) erstellen und frei verwenden – sie werden wie gewohnt in der Web- oder iOS-App geöffnet.
Beispiel für Standard-TPE-URL-Parameter
Hier ist ein Beispiel:
In diesem Beispiel werden die Parameter wie folgt verwendet:
| Parameter | Wert | Verwendung |
|---|---|---|
| ll | 63.939897,-17.369803 | Roter Karten-Pin-Standort. Koordinatenpaar aus Breite und Länge in Dezimalgrad. Negative Länge bedeutet westlich. |
| center | 63.9586,-17.3145 | Kartenmitte. Koordinatenpaar aus Breite und Länge in Dezimalgrad. Negative Länge bedeutet westlich. |
| z | 9 | Zoomstufe. Wert zwischen 1 und 21 (der Maximalwert kann bei bestimmten ausgewählten Kartentypen niedriger sein) |
| spn | 0.64,3.09 | Spannweite. Dezimalgrad-Paar, das die Breiten- und Längenspanne zeigt. Entspricht der Zoomstufe. Verwende entweder dieses oder jene. |
| dt | 2017-01-25T17%3A04%3A00.000Z | Datum/Uhrzeit. Datum und Uhrzeit im ISO-8601-Format mit Millisekundenpräzision. ‘%3A’ ist die URL-codierte Form von ‘:’. Die ältere iOS-Form yyyyMMddHHmmssxx (z. B. 20170125170400+0000) wird ebenfalls als Fallback akzeptiert. |
| sll | 63.972628,-17.052924 | Position des sekundären Pins (optional). Koordinatenpaar aus Breite und Länge in Dezimalgrad. Negative Länge bedeutet westlich. |
Beispiel mit Gebäudehöhen
Beispiel für erweiterte TPE-URL-Parameter
Ein fortgeschritteneres Beispiel, das Gebäudehöhen und Gebäudeflächen umfasst:
Hier ist eine Liste der oben nicht erwähnten 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äudefläche in Metern am primären Pin |
| cw | 60 | Gebäudefläche in Metern am sekundären Pin. |
URL-Parameter für die Visuelle Suche
Die folgenden URL-Parameter sind für die zukünftige Verwendung mit der Funktion „Visuelle Suche“ reserviert.
| Parameter | Beispiel | Verwendung |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azimut, Höhenwinkel-Ziel. Durch Kommas getrenntes Azimut-/Höhenwinkel-Ziel, gefolgt von Azimut-/Höhenwinkel-Toleranz, alles in Grad |
| vsaltp | vsaltp=false | Priorität der Höhe. Legt fest, ob die Suche für die Höhe (true, Standard) oder den Azimut (false) interpoliert |
| vsd | vsd=15768000 | Suchdauer. Länge des Suchzeitraums in Sekunden ab dem in der App ausgewählten Datum/Uhrzeit (verwende den Parameter ‘dt’, um Datum/Uhrzeit festzulegen). Derzeit werden nur vier Werte berücksichtigt: 15768000 (~6 Monate), 31536000 (1 Jahr), 63072000 (2 Jahre), 157680000 (5 Jahre). Andere Werte werden ignoriert. |
| vsr | vsr=false | Bereichsmodus. Bereichsmodus (true, Standard) oder Einzelzielmodus (false). Im Bereichsmodus prüft die Suche, ob der Zielkörper die Grenzen des mit dem Parameter ‘vsaa’ angegebenen Azimut-/Höhenwinkelbereichs überschreitet. Im Einzelzielmodus interpolieren wir die Priorität |
| vsb | vsb=moon | Körper. ‘sun’, ‘moon’ oder ‘gc’ (galactic center). Der relevante Himmelskörper. |
| vsa | vsa=-1 | Scheibenausrichtung. -1, 0 oder 1. Für Körper mit bekannter Halbmesswinkelgröße (Sonne, Mond) wird festgelegt, ob der Körper über die Unterkante (-1), die Mitte (0, Standard) oder die Oberkante (+1) der Scheibe ausgerichtet werden soll |
Filter für die Visuelle Suche
Filter für die Visuelle Suche können mithilfe des Parameters ‘vsf’ wie folgt in der URL codiert werden:
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 (zunehmend), sd (Halbmesswinkel)
- value_range: durch Kommas getrennte Mindest- und Höchstwerte, 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 Parameter ‘vsf’ kann mehrere Filterbedingungen mithilfe von Semikolon-Trennung angeben, z. B.
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
Das Beispiel erfordert, dass die Mondscheibe zu mehr als 95 % beleuchtet ist und dass die Sonne zwischen 6 und 0 Grad unter dem Horizont liegt (also in der bürgerlichen Dämmerung).
Neu in TPE Web v4
TPE Web v4 führt eine Field-of-View-Überlagerung ein, die die gerahmte Szene der Kamera auf der Karte darstellt. Der Status der Überlagerung – Ausrichtung, Brennweite, Entfernung, Geräteauswahl und so weiter – kann in der URL codiert werden und wird automatisch in freigebbare Links aufgenommen, wenn die Überlagerung aktiv ist.
Field-of-View-Parameter
Zwei nebeneinander bestehende Parametergruppen beschreiben denselben zugrunde liegenden Zustand und spiegeln die Optionen Freeform / Gear im Modus-Umschalter der FOV-Seitenleiste wider. Die Freeform-Parameter codieren den resultierenden Kegel in Grad, sodass ein Empfänger ihn unabhängig von der verwendeten Ausrüstung darstellen kann. Die Gear-Parameter codieren die exakte Kamera, das Objektiv, die Brennweite und den Telekonverter, sodass ein Empfänger mit derselben Ausrüstung zur genauen Konfiguration zurückgelangt.
Wenn die Überlagerung in der App aktiv ist (eine Kamera und ein Objektiv sind ausgewählt), werden beide Gruppen nebeneinander ausgegeben. Wenn du URLs manuell zusammenstellst, reichen die Freeform-Parameter allein aus, um den Kegel darzustellen; die Gear-Parameter sind optional.
Freeform-Parameter (kameraunabhängig)
| Parameter | Beispiel | Verwendung |
|---|---|---|
| fovb | fovb=137.50 | Kamerarichtung. Himmelsrichtung, in die die Kamera zeigt, in Grad (0–360). |
| fovhfov | fovhfov=24.40 | Horizontales Sichtfeld, in Grad (0–360). |
| fovvfov | fovvfov=16.50 | Vertikales Sichtfeld, in Grad (0–180). |
| fovd | fovd=420.0 | Motiventfernung, in Metern. Dort, wo die Kamera entlang der Blickrichtung fokussiert ist. |
| fovo | fovo=l | Ausrichtung: l für Querformat, p für Hochformat. |
| fovov | fovov=1 | Überlagerung sichtbar: 1, um den Kegel auf der Karte darzustellen, 0, um ihn auszublenden. |
Gear-Parameter (exakte Ausrüstung wird beibehalten)
| Parameter | Beispiel | Verwendung |
|---|---|---|
| fovcam | fovcam=cam-uuid | ID des aktiven Kamerageräts. Wird mit der Kamerabibliothek des Empfängers abgeglichen. |
| fovlens | fovlens=lens-uuid | ID des aktiven Objektivgeräts. Wird mit der Objektivbibliothek des Empfängers abgeglichen. |
| fovfl | fovfl=70.0 | Brennweite, in Millimetern. Wird auf den Bereich des Objektivs begrenzt, wenn das Objektiv aufgelöst wird. |
| fovtc | fovtc=1.4 | Telekonverter-Faktor: einer von 1.0, 1.4, 1.7, 2.0, 3.0. |
| fovtcsl | fovtcsl=1.20 | Telekonverter-Stop-Loss-Override, in Blendenstufen (0–10). Optionale manuelle Überschreibung für nicht standardisierte Telekonverter. |
| fovr | fovr=m | Entfernungsbereich: c (nah, bis 1 km), m (mittel, bis 15 km), f (fern, bis ~322 km). Steuert das Maximum des Entfernungsreglers. |
Beispiel-URL
Dadurch wird in Boulder, CO bei Sonnenuntergang am 15. Juni 2026 ein Pin gesetzt, wobei die Kamera nach Südosten zeigt und eine Szene von 24,4° × 16,5° in 420 m Entfernung rahmt.
