Com a la pàgina d’eclipsis d’Astroletra, la Lluna tapa el Sol, es fa de nit i cauen estels. Animació de crida studio.

Astroletra. Disseny i desenvolupament d’un almanac del cel amb API i dades obertes

Astroletra és un horòscop diari i un almanac del cel en castellà, per a Espanya i Llatinoamèrica. La vam dissenyar i desenvolupar de cap a peus. Calcula el cel amb les efemèrides JPL DE440 i obre les dades amb una API gratuïta i un DOI.

Visita astroletra.com (s’obre en una pestanya nova)

De què va aquest projecte

Astroletra publica cada dia l’horòscop dels dotze signes i un almanac del cel en castellà, pensat per a lectors d’Espanya i de Llatinoamèrica. Al costat de cada lectura hi ha la dada, l’hora de la Lluna, dels eclipsis i dels planetes, calculada i posada a l’hora de cada ciutat.

Ens en vam encarregar de cap a peus, de la marca i el disseny al motor de càlcul, l’API, les dades obertes i el SEO. Els càlculs surten de les efemèrides JPL DE440, del Jet Propulsion Laboratory de la NASA, i les dades són obertes, amb una API gratuïta i un DOI perquè qualsevol les pugui citar i comprovar.

Aquí expliquem com vam resoldre les peces que més feina van donar, el càlcul, l’eclipsi municipi a municipi i les dades obertes. És la mena de projecte que ens agrada, una web on cada dada es pot comprovar.

El projecte

Mercat
Espanya i Llatinoamèrica
Serveis
Disseny i desenvolupament web, marca, SEO, dades obertes i API pública
Idioma de la web
Castellà
Estat
En línia

Com va començar

Astroletra havia de servir alhora per llegir l’horòscop de cada dia i per saber a quina hora passa de veritat cada cosa al cel. Volia arribar a lectors d’Espanya i de Llatinoamèrica, i que la dada sempre es pogués comprovar. La vam començar al novembre.

Què vam decidir

  1. La imatge d’Astroletra

    També vam fer la marca. El logo és una tessel·la que va del blau de Prússia al blau de nit, amb una A de paper i un anell de llum al voltant, com el d’un planeta. Al costat hi ha el nom, en Ibarra Real Nova, una lletra amb aire de capçalera de diari.

    La resta segueix el mateix to, el paper i la tinta d’un diari, el blau de Prússia i un ocre, i un color propi per a cada signe. Volíem que Astroletra semblés un diari ben fet, i no una web d’horòscops com les altres.

    El logo té versions per a fons clar i fosc, i la tessel·la sola fa d’icona al mòbil i a la pestanya del navegador.

  2. La dada i la lectura, cadascuna al seu lloc

    A la portada, la dada i la lectura van per separat. A un costat hi ha el cel d’avui, amb la Lluna, la sortida i la posta i l’hora de cada moment a la ciutat de qui llegeix. A l’altre, els dotze signes per triar el teu.

    Així qui hi entra sap què és càlcul i què és interpretació, i pot canviar la ciutat perquè totes les hores s’hi ajustin.

    El bloc «El dato» de la portada d’Astroletra al mòbil, amb la Lluna i la franja de les hores del dia
    El cel d’avui a la portada d’Astroletra, al mòbil, el 19 de novembre de 2026. Captura de crida studio.
  3. Cada hora, calculada amb les efemèrides JPL DE440

    Les hores de la Lluna, els eclipsis, els planetes retrògrads i les entrades del Sol a cada signe no es copien d’enlloc. Les calcula el motor que vam fer, amb les efemèrides JPL DE440 del Jet Propulsion Laboratory de la NASA, i després es passen a l’hora de cada lloc.

    Les dades donen l’hora local de vuit ciutats, Madrid, Londres, Nova York, Los Angeles, Ciutat de Mèxic, Bogotà, Santiago i Buenos Aires, i la web dona l’hora de cada lluna a Espanya, Mèxic, Colòmbia, el Perú, l’Argentina i Xile.

    De les mateixes dades surten les pàgines de la web, l’API i els fitxers oberts, de manera que tot diu sempre el mateix.

    1. Efemèrides JPL DE440On són la Lluna, el Sol i els planetes a cada moment.
    2. El càlculLes fases, els eclipsis, els retrògrads i les entrades del Sol, amb la seva hora.
    3. L’hora de cada llocCada moment passat a la zona horària de cada ciutat.
    Una sola fontLes pàgines, l’API i els fitxers oberts surten de les mateixes dades.
    Com es calcula cada hora que surt a Astroletra.
  4. L’eclipsi total de l’agost, municipi a municipi

    Per a l’eclipsi total de Sol del 2 d’agost vam fer un cercador amb els 8.132 municipis d’Espanya, amb les dades de l’INE. Cadascú escriu el seu, o fa servir la ubicació, i veu a quina hora comença, quan és total, quant dura i quan acaba.

    La totalitat es veurà en 104 municipis, a més de Ceuta i Melilla. Un mapa marca la franja on serà total, una llista ordena els municipis per la durada i cada província té la seva pàgina. La ubicació es fa servir al mateix telèfon i no en surt.

    El mapa de la franja de l’eclipsi total al sud d’Espanya, a l’ordinador, amb la durada a cada municipi en una llista al costat
    El cercador de municipis de l’eclipsi al mòbil, amb Tarifa triada i les hores d’inici, totalitat, durada i final
    La pàgina de l’eclipsi del 2 d’agost de 2027, amb el mapa de la franja a l’ordinador i Tarifa triada al mòbil, el 19 de novembre de 2026. Captures de crida studio.
  5. Dades obertes amb DOI i una API gratuïta

    Les dades calculades es poden descarregar en CSV, JSON i iCal, amb llicència CC BY 4.0. Són tres anys de cel, amb 75 llunes noves i plenes, 14 eclipsis i 18 períodes retrògrads, i 1.272 entrades del Sol a cada signe al llarg de 106 anys, amb l’hora local de les vuit ciutats.

    Les publiquem a Zenodo amb un DOI que porta sempre a l’última versió, i també a GitHub i Hugging Face, perquè un periodista o un investigador les pugui citar amb un identificador que no canvia.

    Per a dates i zones a mida hi ha una API pública, gratuïta, sense clau ni registre i oberta a qualsevol web, descrita en OpenAPI 3.1. Admet 60 peticions per minut i dates de fins a set dies abans o després d’avui, perquè sigui oberta sense que se’n pugui abusar.

    La pàgina de dades obertes d’Astroletra a l’ordinador, amb la taula dels arxius i les seves descàrregues
    La pàgina de l’API pública del cel al mòbil, amb l’adreça de la petició i les condicions, sense clau i gratuïta
    Les dades obertes a l’ordinador i l’API pública al mòbil, el 19 de novembre de 2026. Captures de crida studio.

Què hi vam fer

Tota la web, del disseny de la primera pàgina a les dades que es poden descarregar.

  • Logo i imatgeLa tessel·la amb la A, el nom i els colors de la marca.
  • Disseny de la webDe la portada a l’última fitxa, en clar i en fosc.
  • DesenvolupamentLes pàgines, el cercador i la navegació.
  • Motor de càlculAmb les efemèrides JPL DE440, per a la Lluna, els eclipsis i els planetes.
  • Eclipsi municipi a municipiEls 8.132 municipis d’Espanya, amb el mapa de la franja.
  • Dades obertesEn CSV, JSON i iCal, a Zenodo amb DOI, GitHub i Hugging Face.
  • API públicaGratuïta i sense clau, descrita en OpenAPI.
  • CalendarisPer subscriure’s a les llunes, els eclipsis i els retrògrads.
  • SEOPerquè cada pàgina es pugui trobar i entendre a Google.

Preguntes sobre el projecte

Feu webs a partir de dades pròpies o calculades?

Sí. Astroletra n’és un exemple, amb pàgines que surten de dades calculades i que qualsevol pot comprovar. Si tens dades que vols convertir en pàgines útils, explica’ns què tens i com les fas servir ara.

Què vol dir publicar dades obertes amb DOI?

Que les dades es poden descarregar i citar amb un identificador permanent. Les d’Astroletra són a Zenodo amb un DOI que porta sempre a l’última versió, amb llicència CC BY 4.0, i la web explica com citar-les.

Una API gratuïta no pot sortir cara?

Pot, si no té límits. La d’Astroletra no demana clau ni registre, però admet 60 peticions per minut i només dates de fins a set dies d’avui, i qui vol les dades de tres anys les baixa en fitxers.

Treballeu amb projectes de fora de Catalunya?

Sí. Astroletra és per a lectors d’Espanya i de Llatinoamèrica, i treballem amb empreses de tot Espanya i de fora, a distància.

Crèdits

Marca, disseny, desenvolupament, càlcul, API, dades obertes i SEO
crida studio
Efemèrides
JPL DE440, del Jet Propulsion Laboratory de la NASA
Municipis
Institut Nacional d’Estadística
Captures d’aquesta pàgina
crida studio, 19 de novembre de 2026

Publicat el Actualitzat el

Tens dades que vols convertir en una web?

Si tens dades pròpies i vols que la gent les pugui consultar, citar o fer servir, explica’ns què tens i et direm per on començaríem.

Responem en menys de 24 hores laborables.