Tutte le versioni di The Photographer’s Ephemeris usano un formato URL standard. Puoi creare i tuoi URL (ad es. tramite uno strumento di scripting o modificando manualmente l’indirizzo nel browser) e usarli liberamente: si apriranno normalmente nell’app web o iOS.
Esempio di parametri URL standard di TPE
Ecco un esempio:
In questo esempio, i parametri vengono usati come segue:
| Parametro | Valore | Utilizzo |
|---|---|---|
| ll | 63.939897,-17.369803 | Posizione del segnaposto rosso sulla mappa. Coppia di coordinate latitudine, longitudine in gradi decimali. La longitudine negativa è ovest. |
| center | 63.9586,-17.3145 | Centro della mappa. Coppia di coordinate latitudine, longitudine in gradi decimali. La longitudine negativa è ovest. |
| z | 9 | Livello di zoom. Valore compreso tra 1 e 21 (il valore massimo può essere inferiore con determinati tipi di mappa selezionati) |
| spn | 0.64,3.09 | Estensione. Coppia di gradi decimali che mostra l’estensione di latitudine e longitudine. Equivalente al livello di zoom. Usa l’uno o l’altro. |
| dt | 2017-01-25T17%3A04%3A00.000Z | Data/ora. Data e ora in formato ISO 8601 con precisione al millisecondo. ‘%3A’ è la forma codificata nell’URL di ‘:’. È accettato anche il formato iOS legacy yyyyMMddHHmmssxx (ad es. 20170125170400+0000) come alternativa. |
| sll | 63.972628,-17.052924 | Posizione del segnaposto secondario (opzionale). Coppia di coordinate latitudine, longitudine in gradi decimali. La longitudine negativa è ovest. |
Esempio con altezze degli edifici
Esempio di parametri URL avanzati di TPE
Un esempio più avanzato che include altezze degli edifici e dimensioni dell’ingombro:
Ecco un elenco dei parametri non menzionati sopra:
| Parametro | Valore | Utilizzo |
|---|---|---|
| sh | 5.00 | Altezza dell’oggetto principale in metri. ad es. l’altezza della fotocamera da terra |
| ch | 30.00 | Altezza dell’oggetto secondario in metri. ad es. l’altezza di un edificio |
| sw | 10 | Ingombro dell’edificio in metri al segnaposto principale |
| cw | 60 | Ingombro dell’edificio in metri al segnaposto secondario. |
Parametri URL di Visual Search
I seguenti parametri URL sono riservati per usi futuri con la funzione Visual Search.
| Parametro | Esempio | Utilizzo |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azimut, obiettivo di altitudine. Obiettivo azimut/altitudine separato da virgole seguito dalla tolleranza azimut/altitudine, tutto in gradi |
| vsaltp | vsaltp=false | Priorità altitudine. Determina se la ricerca interpola per l’altitudine (true, predefinito) o per l’azimut (false) |
| vsd | vsd=15768000 | Durata della ricerca. Durata del periodo di ricerca, in secondi, dalla data/ora selezionata nell’app (usa il parametro ‘dt’ per impostare data/ora). Attualmente sono riconosciuti solo quattro valori: 15768000 (~6 mesi), 31536000 (1 anno), 63072000 (2 anni), 157680000 (5 anni). Gli altri valori vengono ignorati. |
| vsr | vsr=false | Modalità intervallo. Modalità intervallo (true, predefinito) o modalità obiettivo singolo (false). In Modalità intervallo, la ricerca verifica se il corpo target attraversa i limiti della regione az/alt specificata dal parametro ‘vsaa’. In Modalità obiettivo singolo, interpoliamo la priorità |
| vsb | vsb=moon | Corpo. ‘sun’, ‘moon’ o ‘gc’ (centro galattico). Il corpo di interesse. |
| vsa | vsa=-1 | Allineamento del disco. -1, 0 o 1. Per i corpi con semidiametro noto (sun, moon), specifica se il corpo deve essere allineato usando il bordo inferiore (-1), il centro (0, predefinito) o il bordo superiore (+1) del disco |
Filtri di Visual Search
I filtri di Visual Search possono essere codificati nell’URL usando il parametro ‘vsf’, come segue:
vsf=b:[body]|p:[property]|v:[value_range]
dove:
- body: sun, moon o gc
- property: az (azimuth), alt (altezza apparente), ill (frazione illuminata), wax (crescente), sd (semidiametro)
- value_range: valori minimo e massimo separati da virgole, ad es. 90,100 per l’azimut (gradi), 0.95,1 per la frazione illuminata della Luna, 0,0 per wax = false o 1,1 per wax = true
Il parametro ‘vsf’ può specificare più condizioni di filtro usando la separazione con punto e virgola, ad es.
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
L’esempio richiede che il disco della Luna sia illuminato per oltre il 95% e che il Sole sia compreso tra 6 e 0 gradi sotto l’orizzonte (ossia il crepuscolo civile).
Novità in TPE Web v4
TPE Web v4 introduce una sovrapposizione Field of View che disegna sulla mappa la scena inquadrata dalla fotocamera. Lo stato della sovrapposizione — direzione, lunghezza focale, distanza, selezione dell’attrezzatura e così via — può essere codificato nell’URL ed è incluso automaticamente nei link condivisibili quando la sovrapposizione è attiva.
Parametri Field of View
Due gruppi di parametri coesistenti descrivono lo stesso stato sottostante, rispecchiando le opzioni Freeform / Gear nel selettore di modalità del pannello laterale FOV. I parametri freeform codificano il cono risultante in gradi, così che chi riceve il link possa visualizzarlo indipendentemente dall’attrezzatura posseduta. I parametri gear codificano la fotocamera, l’obiettivo, la lunghezza focale e il teleconverter esatti, così che chi riceve il link e possiede la stessa attrezzatura torni alla configurazione precisa.
Quando la sovrapposizione è attiva nell’app (sono selezionate una fotocamera e un obiettivo), entrambi i gruppi vengono emessi fianco a fianco. Quando si costruiscono gli URL manualmente, i soli parametri freeform sono sufficienti per disegnare il cono; i parametri gear sono opzionali.
Parametri freeform (indipendenti dalla fotocamera)
| Parametro | Esempio | Utilizzo |
|---|---|---|
| fovb | fovb=137.50 | Direzione della fotocamera. Rotta della bussola lungo cui è puntata la fotocamera, in gradi (0–360). |
| fovhfov | fovhfov=24.40 | Campo visivo orizzontale, in gradi (0–360). |
| fovvfov | fovvfov=16.50 | Campo visivo verticale, in gradi (0–180). |
| fovd | fovd=420.0 | Distanza del soggetto, in metri. Il punto lungo la direzione su cui è messa a fuoco la fotocamera. |
| fovo | fovo=l | Orientamento: l per orizzontale, p per verticale. |
| fovov | fovov=1 | Sovrapposizione visibile: 1 per disegnare il cono sulla mappa, 0 per nasconderlo. |
Parametri gear (torna all’attrezzatura esatta)
| Parametro | Esempio | Utilizzo |
|---|---|---|
| fovcam | fovcam=cam-uuid | ID del dispositivo della fotocamera attiva. Risolto rispetto alla libreria fotocamere del destinatario. |
| fovlens | fovlens=lens-uuid | ID del dispositivo dell’obiettivo attivo. Risolto rispetto alla libreria obiettivi del destinatario. |
| fovfl | fovfl=70.0 | Lunghezza focale, in millimetri. Vincolata all’intervallo dell’obiettivo quando l’obiettivo viene risolto. |
| fovtc | fovtc=1.4 | Fattore teleconverter: uno tra 1.0, 1.4, 1.7, 2.0, 3.0. |
| fovtcsl | fovtcsl=1.20 | Sostituzione dell’attenuazione dello stop del teleconverter, in stop (0–10). Sostituzione manuale opzionale per teleconverter non standard. |
| fovr | fovr=m | Intervallo di distanza: c (vicino, fino a 1 km), m (medio, fino a 15 km), f (lontano, fino a ~322 km). Controlla il valore massimo del cursore della distanza del soggetto. |
URL di esempio
Questo inserisce un segnaposto a Boulder, CO al tramonto del 15 giugno 2026, con la fotocamera puntata verso sud-est e inquadrando una scena di 24,4° × 16,5° a 420 m di distanza.
