Wszystkie wersje The Photographer’s Ephemeris korzystają ze standardowego formatu URL. Możesz tworzyć własne adresy URL (np. za pomocą narzędzia skryptowego lub ręcznie edytując adres w przeglądarce) i swobodnie z nich korzystać – otworzą się normalnie w aplikacji web lub iOS.
Przykład standardowych parametrów URL TPE
Oto przykład:
W tym przykładzie parametry są użyte w następujący sposób:
| Parameter | Value | Usage |
|---|---|---|
| ll | 63.939897,-17.369803 | Czerwona pinezka na mapie. Para współrzędnych szerokości i długości geograficznej w stopniach dziesiętnych. Ujemna długość geograficzna oznacza zachód. |
| center | 63.9586,-17.3145 | Środek mapy. Para współrzędnych szerokości i długości geograficznej w stopniach dziesiętnych. Ujemna długość geograficzna oznacza zachód. |
| z | 9 | Poziom powiększenia. Wartość od 1 do 21 (maksymalna wartość może być niższa przy wybraniu niektórych typów map) |
| spn | 0.64,3.09 | Rozpiętość. Para wartości w stopniach dziesiętnych pokazująca rozpiętość szerokości i długości geograficznej. Odpowiednik poziomu powiększenia. Można użyć jednego albo drugiego. |
| dt | 2017-01-25T17%3A04%3A00.000Z | Data/godzina. Data i godzina w formacie ISO 8601 z dokładnością do milisekund. ‘%3A’ to zakodowana w URL postać znaku ‘:’. Obsługiwany jest też starszy format iOS yyyyMMddHHmmssxx (np. 20170125170400+0000) jako opcja zapasowa. |
| sll | 63.972628,-17.052924 | Drugorzędna lokalizacja pinezki (opcjonalnie). Para współrzędnych szerokości i długości geograficznej w stopniach dziesiętnych. Ujemna długość geograficzna oznacza zachód. |
Przykład z wysokościami budynków
Przykład zaawansowanych parametrów URL TPE
Bardziej zaawansowany przykład zawierający wysokości budynków i rozmiary rzutu:
Oto lista parametrów niewymienionych powyżej:
| Parameter | Value | Usage |
|---|---|---|
| sh | 5.00 | Wysokość obiektu głównego w metrach. np. wysokość aparatu nad ziemią |
| ch | 30.00 | Wysokość obiektu drugorzędnego w metrach. np. wysokość budynku |
| sw | 10 | Rzut budynku w metrach przy głównej pinezce |
| cw | 60 | Rzut budynku w metrach przy drugorzędnej pinezce. |
Parametry URL wyszukiwania wizualnego
Poniższe parametry URL są zarezerwowane do przyszłego użycia w funkcji wyszukiwania wizualnego.
| Parameter | Example | Usage |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azymut, cel wysokości. Cel az/alt rozdzielony przecinkami, po którym następuje tolerancja az/alt, wszystko w stopniach |
| vsaltp | vsaltp=false | Priorytet wysokości. Określa, czy wyszukiwanie ma interpolować wysokość (true, domyślnie) czy azymut (false) |
| vsd | vsd=15768000 | Czas trwania wyszukiwania. Długość okresu wyszukiwania w sekundach, liczona od daty/godziny wybranej w aplikacji (użyj parametru ‘dt’, aby ustawić datę/godzinę). Obecnie uwzględniane są tylko cztery wartości: 15768000 (~6 miesięcy), 31536000 (1 rok), 63072000 (2 lata), 157680000 (5 lat). Inne wartości są ignorowane. |
| vsr | vsr=false | Tryb zakresu. Tryb zakresu (true, domyślnie) albo tryb pojedynczego celu (false). W trybie zakresu wyszukiwanie sprawdza, czy obiekt docelowy przecina granice obszaru az/alt określonego parametrem ‘vsaa’. W trybie pojedynczego celu interpolujemy priorytet |
| vsb | vsb=moon | Obiekt. ‘sun’, ‘moon’ lub ‘gc’ (galactic center). Obiekt zainteresowania. |
| vsa | vsa=-1 | Wyrównanie dysku. -1, 0 lub 1. Dla obiektów o znanej półśrednicy (sun, moon) określa, czy obiekt ma być wyrównany według dolnej krawędzi (-1), środka (0, domyślnie) czy górnej krawędzi (+1) dysku |
Filtry wyszukiwania wizualnego
Filtry wyszukiwania wizualnego można zakodować w URL za pomocą parametru ‘vsf’ w następujący sposób:
vsf=b:[body]|p:[property]|v:[value_range]
gdzie:
- body: sun, moon or gc
- property: az (azimuth), alt (apparent altitude), ill (illuminated fraction), wax (waxing), sd (semidiameter)
- value_range: wartości minimalne i maksymalne rozdzielone przecinkami, np. 90,100 dla azymutu (stopnie), 0.95,1 dla oświetlonej części Księżyca, 0,0 dla wax = false albo 1,1 dla wax = true
Parametr ‘vsf’ może określać wiele warunków filtra, rozdzielając je średnikami, np.
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
Ten przykład wymaga, aby tarcza Księżyca była oświetlona w > 95% oraz aby Słońce znajdowało się między 6 a 0 stopniami poniżej horyzontu (czyli w czasie zmierzchu cywilnego).
Nowość w TPE Web v4
TPE Web v4 wprowadza nakładkę Field of View, która rysuje na mapie kadr widziany przez aparat. Stan nakładki – azymut, ogniskowa, odległość, wybór sprzętu itd. – może być zakodowany w URL i jest automatycznie dołączany do linków udostępniania, gdy nakładka jest aktywna.
Parametry Field of View
Dwie współistniejące grupy parametrów opisują ten sam stan bazowy, odzwierciedlając opcje Freeform / Gear w przełączniku trybu panelu bocznego FOV. Parametry freeform kodują wynikowy stożek w stopniach, dzięki czemu odbiorca może go wyrenderować niezależnie od posiadanego sprzętu. Parametry gear kodują dokładny aparat, obiektyw, ogniskową i telekonwerter, dzięki czemu odbiorca posiadający ten sam sprzęt może odtworzyć dokładną konfigurację.
Gdy nakładka jest aktywna w aplikacji (wybrany jest aparat i obiektyw), obie grupy są emitowane obok siebie. Podczas ręcznego tworzenia URL same parametry freeform wystarczą do narysowania stożka; parametry gear są opcjonalne.
Parametry freeform (niezależne od aparatu)
| Parameter | Example | Usage |
|---|---|---|
| fovb | fovb=137.50 | Kierunek aparatu. Azymut kompasowy, wzdłuż którego skierowany jest aparat, w stopniach (0–360). |
| fovhfov | fovhfov=24.40 | Poziome pole widzenia, w stopniach (0–360). |
| fovvfov | fovvfov=16.50 | Pionowe pole widzenia, w stopniach (0–180). |
| fovd | fovd=420.0 | Odległość do obiektu, w metrach. Miejsce, w którym aparat jest ustawiony na ostrość wzdłuż azymutu. |
| fovo | fovo=l | Orientacja: l dla poziomej, p dla pionowej. |
| fovov | fovov=1 | Widoczność nakładki: 1, aby narysować stożek na mapie, 0, aby ukryć. |
Parametry gear (dokładne odtworzenie sprzętu)
| Parameter | Example | Usage |
|---|---|---|
| fovcam | fovcam=cam-uuid | Identyfikator aktywnego aparatu. Rozpoznawany na podstawie biblioteki aparatów odbiorcy. |
| fovlens | fovlens=lens-uuid | Identyfikator aktywnego obiektywu. Rozpoznawany na podstawie biblioteki obiektywów odbiorcy. |
| fovfl | fovfl=70.0 | Ogniskowa, w milimetrach. Przypinana do zakresu obiektywu po jego rozpoznaniu. |
| fovtc | fovtc=1.4 | Współczynnik telekonwertera: jeden z 1.0, 1.4, 1.7, 2.0, 3.0. |
| fovtcsl | fovtcsl=1.20 | Ręczne nadpisanie straty działek telekonwertera, w działkach (0–10). Opcjonalne ręczne nadpisanie dla niestandardowych telekonwerterów. |
| fovr | fovr=m | Zakres odległości: c (blisko, do 1 km), m (średnio, do 15 km), f (daleko, do ~322 km). Kontroluje maksymalną wartość suwaka odległości do obiektu. |
Przykładowy URL
To umieszcza pinezkę w Boulder w stanie CO o zachodzie słońca 15 czerwca 2026 r., z aparatem skierowanym na południowy wschód i kadrem obejmującym scenę 24,4° × 16,5° w odległości 420 m.
