# 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.

[Versió web](https://www.crida.studio/recursos/projectes/astroletra/)

Per David Monje, crida studio · Publicat 2026-11-19 · Actualitzat 2026-11-19

![La portada d’astroletra.com en un portàtil i, al costat, la pàgina de l’eclipsi amb Tarifa triada en un mòbil](https://www.crida.studio/recursos/assets/astroletra-dispositius.571aa1a0a00e.webp)

La portada d’astroletra.com a l’ordinador i la pàgina de l’eclipsi del 2 d’agost de 2027 al mòbil, amb Tarifa triada, el 19 de novembre de 2026. Captures de crida studio.

## 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.

[Disseny web a Girona amb WordPress o desenvolupament a mida](https://www.crida.studio/recursos/serveis/disseny-desenvolupament-web/)
[Posicionament web i SEO a Girona](https://www.crida.studio/recursos/serveis/posicionament-seo/)

## Fitxa

| Camp | Dada |
| --- | --- |
| Web | [astroletra.com](https://astroletra.com/) |
| Dades obertes | [DOI 10.5281/zenodo.24132871](https://doi.org/10.5281/zenodo.24132871) |
| API pública | [Documentació de l’API](https://astroletra.com/datos/api/) |
| Eclipsi per municipi | [El cercador dels 8.132 municipis](https://astroletra.com/eclipses/eclipse-solar-total-2-agosto-2027/espana/) |
| Mercat | Espanya i Llatinoamèrica |
| Serveis | [Disseny i desenvolupament web](https://www.crida.studio/recursos/serveis/disseny-desenvolupament-web/), [marca](https://www.crida.studio/recursos/serveis/branding-identitat-visual/), [SEO](https://www.crida.studio/recursos/serveis/posicionament-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

### 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.

El logo d’Astroletra, una tessel·la blava amb una A i un anell, i el nom al costat.

- Paper, #F8F7F4
- Tinta, #17181A
- Blau de Prússia, #13436F
- Ocre, #B8862B

El logo d’Astroletra per a fons fosc i els quatre colors de la marca. Disseny de crida studio.

### 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](https://www.crida.studio/recursos/assets/astroletra-cel-avui-mobil.9fe71f9d4199.webp)

El cel d’avui a la portada d’Astroletra, al mòbil, el 19 de novembre de 2026. Captura de crida studio.

### 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.

- Efemèrides JPL DE440. On són la Lluna, el Sol i els planetes a cada moment.
- El càlcul. Les fases, els eclipsis, els retrògrads i les entrades del Sol, amb la seva hora.
- L’hora de cada lloc. Cada moment passat a la zona horària de cada ciutat.
- Una sola font. Les pàgines, l’API i els fitxers oberts surten de les mateixes dades.

Com es calcula cada hora que surt a Astroletra.

### 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](https://www.crida.studio/recursos/assets/astroletra-eclipsi-mapa-ordinador.90374780f174.webp)

![El cercador de municipis de l’eclipsi al mòbil, amb Tarifa triada i les hores d’inici, totalitat, durada i final](https://www.crida.studio/recursos/assets/astroletra-eclipsi-tarifa-mobil.12b4214dfd62.webp)

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.

### 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](https://www.crida.studio/recursos/assets/astroletra-dades-obertes-ordinador.95c7a3d50d7e.webp)

![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](https://www.crida.studio/recursos/assets/astroletra-api-mobil.85e5453b3475.webp)

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 imatge. La tessel·la amb la A, el nom i els colors de la marca.
- Disseny de la web. De la portada a l’última fitxa, en clar i en fosc.
- Desenvolupament. Les pàgines, el cercador i la navegació.
- Motor de càlcul. Amb les efemèrides JPL DE440, per a la Lluna, els eclipsis i els planetes.
- Eclipsi municipi a municipi. Els 8.132 municipis d’Espanya, amb el mapa de la franja.
- Dades obertes. En CSV, JSON i iCal, a Zenodo amb DOI, GitHub i Hugging Face.
- API pública. Gratuïta i sense clau, descrita en OpenAPI.
- Calendaris. Per subscriure’s a les llunes, els eclipsis i els retrògrads.
- SEO. Perquè 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

## Enllaços

- [Disseny web a Girona amb WordPress o desenvolupament a mida](https://www.crida.studio/recursos/serveis/disseny-desenvolupament-web/)
- [Branding a Girona i identitat visual](https://www.crida.studio/recursos/serveis/branding-identitat-visual/)
- [Posicionament web i SEO a Girona](https://www.crida.studio/recursos/serveis/posicionament-seo/)
- [Què costa una web amb crida studio](https://www.crida.studio/recursos/preus/#grup-web)
- [Web a mida o plantilla. Quina opció et convé?](https://www.crida.studio/recursos/guies/web-a-mida-o-plantilla/)
- [Què comparar abans d’acceptar un pressupost web](https://www.crida.studio/recursos/guies/comparar-pressupostos-disseny-web/)
- [David Monje, fundador i director de crida studio](https://www.crida.studio/recursos/autor/david-monje/)
- [Següent projecte. L’experiència de David Monje al màrqueting de TECNIC](https://www.crida.studio/recursos/autor/david-monje/experiencia-bioproces/)
- [Tots els projectes](https://www.crida.studio/recursos/projectes/)

## 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.

[Parlem-ne](https://www.crida.studio/#contact)
