All versions of The Photographer’s Ephemeris use a standard form of URL. You can construct your own URLs (e.g. via a scripting tool or by manually editing the address in your browser) and use them freely – they’ll open in the web or iOS app as normal.
Ejemplo estándar
Aquí hay un ejemplo:
En este ejemplo, los parámetros se usan de la siguiente manera:
| Parámetro | Valor | Uso |
|---|---|---|
| ll | 63.939897,-17.369803 | Ubicación del pin rojo. Par de coordenadas latitud,longitud en grados decimales. La longitud negativa indica oeste. |
| center | 63.9586,-17.3145 | Centro del mapa. Par de coordenadas latitud,longitud en grados decimales. La longitud negativa indica oeste. |
| z | 9 | Nivel de zoom. Valor entre 0 y 21 (el valor máximo puede ser menor con ciertos tipos de mapa seleccionados) |
| spn | 0.64,3.09 | Extensión. Par en grados decimales que muestra la extensión de latitud y longitud. Equivalente al nivel de zoom. Use cualquiera de los dos. |
| 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 ‘:’ |
| sll | 63.972628,-17.052924 | Ubicación del pin secundario (opcional). Par de coordenadas latitud,longitud en grados decimales. La longitud negativa indica oeste. |
Ejemplo con alturas de edificios
Ejemplo avanzado
Un ejemplo más avanzado que incluye alturas de edificios y tamaños de la huella:
Aquí hay una lista de los parámetros no mencionados arriba:
| Parámetro | Valor | Uso |
|---|---|---|
| sh | 5.00 | Altura del objeto principal en metros. p. ej., la altura de la cámara sobre el suelo |
| ch | 30.00 | Altura del objeto secundario en metros. p. ej., 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 para Búsqueda visual
Los siguientes parámetros de URL están reservados para uso futuro con la función Búsqueda visual.
| Parámetro | Ejemplo | Uso |
|---|---|---|
| vsaa | vsaa=124.52,4.12,2,1 | Azimut, Altitud objetivo. Az/alt objetivo separados por comas seguidos de la tolerancia az/alt, todos en grados |
| vsaltp | vsaltp=false | Prioridad de altitud. Determina si la búsqueda interpola por altitud (true, por defecto) o por azimut (false) |
| vsd | vsd=15811200 | Duración de la búsqueda. Duración del periodo de búsqueda, en segundos, a partir de la fecha/hora seleccionada en la app (use el parámetro ‘dt’ para establecer fecha/hora) |
| vsr | vsr=false | Modo de rango. Modo de rango (true, por defecto) o modo de objetivo único (false). En Modo de Rango, 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 Modo de Objetivo Único, interpolamos la prioridad |
| vsb | vsb=moon | Cuerpo. ‘sun’, ‘moon’, o ‘gc’ (galactic center). El cuerpo de interés. |
| vsa | vsa=-1 | Alineación del disco. -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, por defecto) o la parte superior (+1) del disco |
Filtros de Búsqueda visual
Los filtros de Búsqueda visual pueden codificarse en la URL usando el parámetro ‘vsf’, como sigue:
vsf=b:[body]|p:[property]|v:[value_range]
donde:
- body: sun, moon or gc
- property: az (azimuth), alt (apparent altitude), ill (illuminated fraction), wax (waxing), sd (semidiameter)
- value_range: rango mínimo y máximo separados por comas, p. ej. 90,100 para azimut (grados), 0.95,1 para la fracción iluminada de la Luna, 0,0 para waxing = false o 1,1 para waxing = true
El parámetro ‘vsf’ puede especificar múltiples condiciones de filtro usando separación por punto y coma, p. ej.,
vsf=b:moon|p:ill|v:0.95,1;b:sun|p:alt|v:-6,0
El ejemplo requiere que el disco de la Luna esté > 95% iluminado y que el Sol esté entre 6 y 0 grados bajo el horizonte (es decir, crepúsculo civil).
