Todas las versiones de The Photographer’s Ephemeris usan un formato estándar de URL. Puedes crear tus propias URL (por ejemplo, mediante una herramienta de scripting o editando manualmente la dirección en tu navegador) y usarlas libremente: se abrirán en la app web o iOS como de costumbre.
Ejemplo estándar de parámetros de URL de TPE
Aquí tienes un ejemplo:
En este ejemplo, los parámetros se usan así:
| Parameter | Value | Usage |
|---|---|---|
| ll | 63.939897,-17.369803 | Ubicación del pin rojo del mapa. Par de coordenadas de latitud y longitud en grados decimales. La longitud negativa es oeste. |
| center | 63.9586,-17.3145 | Centro del mapa. Par de coordenadas de latitud y longitud en grados decimales. La longitud negativa es oeste. |
| z | 9 | Nivel de zoom. Valor entre 1 y 21 (el valor máximo puede ser menor con determinados tipos de mapa seleccionados) |
| spn | 0.64,3.09 | Extensión. Par de grados decimales que muestra la extensión de latitud y longitud. Equivalente al nivel de zoom. Usa uno u otro. |
| dt | 2017-01-25T17%3A04%3A00.000Z | Fecha/hora. Fecha y hora en formato ISO 8601 con precisión de milisegundos. ‘%3A’ es la forma codificada en URL de ‘:’. También se acepta como alternativa el formato heredado de iOS yyyyMMddHHmmssxx (por ejemplo, 20170125170400+0000). |
| sll | 63.972628,-17.052924 | Ubicación del pin secundario (opcional). Par de coordenadas de latitud y longitud en grados decimales. La longitud negativa es oeste. |
Ejemplo con alturas de edificios
Ejemplo avanzado de parámetros de URL de TPE
Un ejemplo más avanzado que incluye alturas de edificios y tamaños de huella:
Aquí tienes una lista de los parámetros no mencionados arriba:
| Parameter | Value | Usage |
|---|---|---|
| sh | 5.00 | Altura del objeto principal en metros. por ejemplo, la altura de la cámara sobre el suelo |
| ch | 30.00 | Altura del objeto secundario en metros. por ejemplo, la altura de un edificio |
| sw | 10 | Huella del edificio en metros en el pin principal |
| cw | 60 | Huella del edificio en metros en el pin secundario. |
Parámetros de URL de Visual Search
Los siguientes parámetros de URL están reservados para uso futuro con la función Visual Search.
| Parameter | Example | Usage |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azimuth, Altitude Target. objetivo az/alt separado por comas seguido de la tolerancia az/alt, todo en grados |
| vsaltp | vsaltp=false | Altitude Priority. determina si la búsqueda interpola para la altitud (true, valor predeterminado) o el azimut (false) |
| vsd | vsd=15768000 | Search Duration. duración del período de búsqueda, en segundos, a partir de la fecha/hora seleccionada en la app (usa el parámetro ‘dt’ para establecer la fecha/hora). Actualmente solo se admiten cuatro valores: 15768000 (~6 meses), 31536000 (1 año), 63072000 (2 años), 157680000 (5 años). Los demás valores se ignoran. |
| vsr | vsr=false | Range Mode. modo de rango (true, valor predeterminado) o modo de objetivo único (false). En Range Mode, la búsqueda comprueba si el cuerpo objetivo cruza los límites de la región az/alt especificada por el parámetro ‘vsaa’. En Single Target Mode, interpolamos la prioridad |
| vsb | vsb=moon | Body. ‘sun’, ‘moon’ o ‘gc’ (centro galáctico). El cuerpo de interés. |
| vsa | vsa=-1 | Disk Alignment. -1, 0 o 1. Para cuerpos con semidiámetro conocido (sun, moon), especifica si el cuerpo debe alinearse usando la parte inferior (-1), el centro (0, predeterminado) o la parte superior (+1) del disco |
Filtros de Visual Search
Los filtros de Visual Search se pueden codificar en la URL usando el parámetro ‘vsf’, de la siguiente manera:
vsf=b:[body]|p:[property]|v:[value_range]
donde:
- body: sun, moon o gc
- property: az (azimuth), alt (apparent altitude), ill (illuminated fraction), wax (waxing), sd (semidiameter)
- value_range: valores mínimo y máximo separados por comas, por ejemplo 90,100 para azimuth (degrees), 0.95,1 para la fracción iluminada de la Moon, 0,0 para waxing = false o 1,1 para waxing = true
El parámetro ‘vsf’ puede especificar varias condiciones de filtro usando separación por punto y coma, por ejemplo:
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
El ejemplo requiere que el disco de la Moon esté iluminado en más de un 95% y que el Sun esté entre 6 y 0 grados por debajo del horizonte (es decir, crepúsculo civil).
Nuevo en TPE Web v4
TPE Web v4 introduce una superposición Field of View que dibuja la escena encuadrada de la cámara sobre el mapa. El estado de la superposición — rumbo, distancia focal, distancia, selección de equipo, etc. — se puede codificar en la URL y se incluye automáticamente en los enlaces compartibles cuando la superposición está activa.
Parámetros de Field of View
Dos grupos coexistentes de parámetros describen el mismo estado subyacente, reflejando las opciones Freeform / Gear en el conmutador de modo del panel lateral de FOV. Los parámetros freeform codifican el cono resultante en grados para que un destinatario pueda representarlo independientemente del equipo que tenga. Los parámetros gear codifican la cámara, el objetivo, la distancia focal y el teleconvertidor exactos para que un destinatario que tenga el mismo equipo pueda volver a la configuración precisa.
Cuando la superposición está activa en la app (se ha seleccionado una cámara y un objetivo), ambos grupos se emiten en paralelo. Al construir URL a mano, basta con los parámetros freeform por sí solos para dibujar el cono; los parámetros gear son opcionales.
Parámetros freeform (independientes de la cámara)
| Parameter | Example | Usage |
|---|---|---|
| fovb | fovb=137.50 | Rumbo de la cámara. rumbo de brújula hacia el que apunta la cámara, en grados (0–360). |
| fovhfov | fovhfov=24.40 | Campo de visión horizontal, en grados (0–360). |
| fovvfov | fovvfov=16.50 | Campo de visión vertical, en grados (0–180). |
| fovd | fovd=420.0 | Distancia al sujeto, en metros. Donde la cámara está enfocada a lo largo del rumbo. |
| fovo | fovo=l | Orientación: l para horizontal, p para vertical. |
| fovov | fovov=1 | Superposición visible: 1 para dibujar el cono en el mapa, 0 para ocultarlo. |
Parámetros gear (round-trips exact gear)
| Parameter | Example | Usage |
|---|---|---|
| fovcam | fovcam=cam-uuid | ID del dispositivo de cámara activo. se resuelve frente a la biblioteca de cámaras del destinatario. |
| fovlens | fovlens=lens-uuid | ID del dispositivo de objetivo activo. se resuelve frente a la biblioteca de objetivos del destinatario. |
| fovfl | fovfl=70.0 | Distancia focal, en milímetros. Se ajusta al rango del objetivo cuando se resuelve el objetivo. |
| fovtc | fovtc=1.4 | Factor del teleconvertidor: uno de 1.0, 1.4, 1.7, 2.0, 3.0. |
| fovtcsl | fovtcsl=1.20 | Anulación manual de la pérdida de pasos del teleconvertidor, en pasos (0–10). Anulación manual opcional para teleconvertidores no estándar. |
| fovr | fovr=m | Rango de distancia: c (cerca, hasta 1 km), m (medio, hasta 15 km), f (lejos, hasta ~322 km). Controla el máximo del control deslizante de distancia al sujeto. |
URL de ejemplo
Esto coloca un pin en Boulder, CO al atardecer del 15 de junio de 2026, con la cámara apuntando al sureste y enmarcando una escena de 24,4° × 16,5° a 420 m de distancia.
