Toutes les versions de The Photographer’s Ephemeris utilisent un format d’URL standard. Vous pouvez créer vos propres URL (par exemple à l’aide d’un outil de script ou en modifiant manuellement l’adresse dans votre navigateur) et les utiliser librement : elles s’ouvriront dans l’application web ou iOS comme d’habitude.
Exemple de paramètres d’URL TPE standard
Voici un exemple :
Dans cet exemple, les paramètres sont utilisés comme suit :
| Paramètre | Valeur | Utilisation |
|---|---|---|
| ll | 63.939897,-17.369803 | Emplacement de l’épingle rouge. Paire de coordonnées latitude, longitude en degrés décimaux. Une longitude négative indique l’ouest. |
| center | 63.9586,-17.3145 | Centre de la carte. Paire de coordonnées latitude, longitude en degrés décimaux. Une longitude négative indique l’ouest. |
| z | 9 | Niveau de zoom. Valeur comprise entre 1 et 21 (la valeur maximale peut être inférieure selon certains types de carte sélectionnés) |
| spn | 0.64,3.09 | Étendue. Paire de degrés décimaux indiquant l’étendue en latitude et longitude. Équivalent au niveau de zoom. Utilisez l’un ou l’autre. |
| dt | 2017-01-25T17%3A04%3A00.000Z | Date/heure. Date et heure au format ISO 8601, avec précision à la milliseconde. « %3A » est la forme encodée dans l’URL de « : ». L’ancien format iOS yyyyMMddHHmmssxx (par ex. 20170125170400+0000) est également accepté en solution de repli. |
| sll | 63.972628,-17.052924 | Emplacement de l’épingle secondaire (facultatif). Paire de coordonnées latitude, longitude en degrés décimaux. Une longitude négative indique l’ouest. |
Exemple avec les hauteurs de bâtiment
Exemple de paramètres d’URL TPE avancés
Voici un exemple plus avancé incluant les hauteurs de bâtiment et les dimensions d’emprise :
Voici la liste des paramètres non mentionnés ci-dessus :
| Paramètre | Valeur | Utilisation |
|---|---|---|
| sh | 5.00 | Hauteur de l’objet principal en mètres. par ex. la hauteur de l’appareil photo au-dessus du sol |
| ch | 30.00 | Hauteur de l’objet secondaire en mètres. par ex. la hauteur d’un bâtiment |
| sw | 10 | Emprise du bâtiment en mètres à l’épingle principale |
| cw | 60 | Emprise du bâtiment en mètres à l’épingle secondaire. |
Paramètres d’URL de recherche visuelle
Les paramètres d’URL suivants sont réservés à une utilisation future avec la fonction de recherche visuelle.
| Paramètre | Exemple | Utilisation |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azimut, cible d’altitude. Cible azimut/altitude séparée par des virgules, suivie de la tolérance azimut/altitude, le tout en degrés |
| vsaltp | vsaltp=false | Priorité à l’altitude. Détermine si la recherche interpole pour l’altitude (true, par défaut) ou l’azimut (false) |
| vsd | vsd=15768000 | Durée de recherche. Durée de la période de recherche, en secondes, à partir de la date/heure sélectionnée dans l’application (utilisez le paramètre dt pour définir la date/heure). À ce jour, seules quatre valeurs sont prises en compte : 15768000 (~6 mois), 31536000 (1 an), 63072000 (2 ans), 157680000 (5 ans). Les autres valeurs sont ignorées. |
| vsr | vsr=false | Mode plage. Mode plage (true, par défaut) ou mode cible unique (false). En mode plage, la recherche vérifie si le corps cible franchit les limites de la région azimut/altitude spécifiée par le paramètre vsaa. En mode cible unique, nous interpolons la priorité |
| vsb | vsb=moon | Corps. sun, moon ou gc (centre galactique). Le corps d’intérêt. |
| vsa | vsa=-1 | Alignement du disque. -1, 0 ou 1. Pour les corps dont le demi-diamètre est connu (sun, moon), indique si le corps doit être aligné à l’aide du bas (-1), du centre (0, par défaut) ou du haut (+1) du disque |
Filtres de recherche visuelle
Les filtres de recherche visuelle peuvent être encodés dans l’URL à l’aide du paramètre vsf, comme suit :
vsf=b:[body]|p:[property]|v:[value_range]
où :
- body : sun, moon ou gc
- property : az (azimut), alt (altitude apparente), ill (fraction éclairée), wax (croissant), sd (demi-diamètre)
- value_range : valeurs minimale et maximale séparées par des virgules, par ex. 90,100 pour l’azimut (degrés), 0.95,1 pour la fraction éclairée de la Lune, 0,0 pour wax = false ou 1,1 pour wax = true
Le paramètre vsf peut spécifier plusieurs conditions de filtre en les séparant par des points-virgules, par ex. :
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
L’exemple exige que le disque de la Lune soit éclairé à plus de 95 % et que le Soleil se trouve entre 6 et 0 degrés sous l’horizon (c’est-à-dire pendant le crépuscule civil).
Nouveau dans TPE Web v4
TPE Web v4 introduit une superposition Field of View qui trace sur la carte la scène encadrée par l’appareil photo. L’état de cette superposition — direction, focale, distance, sélection du matériel, etc. — peut être encodé dans l’URL et est automatiquement inclus dans les liens partageables lorsque la superposition est active.
Paramètres Field of View
Deux groupes de paramètres coexistants décrivent le même état sous-jacent, en miroir des options Freeform / Gear dans le sélecteur de mode du panneau latéral FOV. Les paramètres freeform encodent le cône résultant en degrés afin qu’un destinataire puisse le restituer quel que soit le matériel qu’il possède. Les paramètres gear encodent exactement l’appareil photo, l’objectif, la focale et le téléconvertisseur afin qu’un destinataire possédant le même matériel puisse revenir à la configuration précise.
Lorsque la superposition est active dans l’application (un appareil photo et un objectif sont sélectionnés), les deux groupes sont émis côte à côte. Lors de la construction manuelle d’URL, les seuls paramètres freeform suffisent pour dessiner le cône ; les paramètres gear sont facultatifs.
Paramètres freeform (indépendants de l’appareil photo)
| Paramètre | Exemple | Utilisation |
|---|---|---|
| fovb | fovb=137.50 | Direction de l’appareil photo. Cap suivi par l’appareil photo, en degrés (0–360). |
| fovhfov | fovhfov=24.40 | Champ de vision horizontal, en degrés (0–360). |
| fovvfov | fovvfov=16.50 | Champ de vision vertical, en degrés (0–180). |
| fovd | fovd=420.0 | Distance du sujet, en mètres. Point visé par l’appareil photo le long de la direction. |
| fovo | fovo=l | Orientation : l pour paysage, p pour portrait. |
| fovov | fovov=1 | Superposition visible : 1 pour dessiner le cône sur la carte, 0 pour le masquer. |
Paramètres gear (retour exact du matériel)
| Paramètre | Exemple | Utilisation |
|---|---|---|
| fovcam | fovcam=cam-uuid | ID de l’appareil photo actif. Résolu par rapport à la bibliothèque d’appareils photo du destinataire. |
| fovlens | fovlens=lens-uuid | ID de l’objectif actif. Résolu par rapport à la bibliothèque d’objectifs du destinataire. |
| fovfl | fovfl=70.0 | Focale, en millimètres. Limitée à la plage de l’objectif lorsque celui-ci est résolu. |
| fovtc | fovtc=1.4 | Facteur de téléconvertisseur : une valeur parmi 1.0, 1.4, 1.7, 2.0, 3.0. |
| fovtcsl | fovtcsl=1.20 | Correction de perte de diaphragme du téléconvertisseur, en diaphragmes (0–10). Remplacement manuel facultatif pour les téléconvertisseurs non standard. |
| fovr | fovr=m | Plage de distance : c (courte, jusqu’à 1 km), m (moyenne, jusqu’à 15 km), f (longue, jusqu’à ~322 km). Contrôle le maximum du curseur de distance du sujet. |
Exemple d’URL
Cela place une épingle à Boulder, dans le Colorado, au coucher du soleil le 15 juin 2026, avec l’appareil photo orienté vers le sud-est et cadrant une scène de 24,4° × 16,5° à 420 m de distance.
