Información sobre la API
Documentación
Este es un servicio web ligero el cual provee un camino de fácil acceso a los datos e información mostrados en esta web.
Los datos de esta aplicación hacen uso del servicio web de la Agencia Estatal de Meteorología - AEMET. Gobierno de España, que autoriza el uso de la información y reproducción citando a © AEMET como autora de la misma.
Se ha desarrollado una interface REST con la que puedes obtener los datos elaborados por © AEMET en formato JSON.
API versión 2
Objetivo
El objetivo de esta versión es mostrar la misma información mostrada en esta web respecto al grupo de páginas con información meteorológica. La información es servida en formato JSON.
Estes conjunto de datos pueden ser usados para crear aplicaciones web SPA . Especialmente indicado para aquellas personas que se están formando en tecnologías JavaScript y su uso en el front-end actual. Puede hacer uso de librerías o frameworks como React, Vue o Angular con este fin.
Si haces uso de esta API con estos fines, no es obligatorio, pero si es de agradecer nombrarla y/o referenciarla mediante algún link.
A continuación podrás encontrar el listado de comandos:
Ayudanos
Si encuentras un error tanto en la documentación como en los datos meteorológicos, geográficos, códigos de respuesta o de cualquier otro carácter al usar la API, te agradecemos que nos avises contactando con nosotros.
Para nosotros es importante que la información ofrecida sea útil y se encuentre actualizada.
¡Muchas gracias! :-)
Información nacional
https://www.el-tiempo.net/api/json/v2/home
Lista de provincias
https://www.el-tiempo.net/api/json/v2/provincias
Lista de municipios Eliminado
https://www.el-tiempo.net/api/json/v2/municipios
Información geográfica y meteorológica de una provincia
Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v2/provincias/[CODPROV]
Un ejemplo:
https://www.el-tiempo.net/api/json/v2/provincias/01
Lista de municipios de una provincia
Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v2/provincias/[CODPROV]/municipios
Un ejemplo:
https://www.el-tiempo.net/api/json/v2/provincias/01/municipios
Información geográfica y meteorológica de un municipio
El [ID] son los primeros cinco dígitos del dato CODIGOINE que podrás encontrar, por ejemplo, en el comando anterior. Debes sustituir el [ID] por los cincos primeros dígitos del CODIGOINE.
Los dos primeros dígitos del CODIGOINE son los dos dígitos que representan CODPROV (id o código de provincia). Deben coincidir para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v2/provincias/[CODPROV]/municipios/[ID]
Un ejemplo de la construcción de este comando:
https://www.el-tiempo.net/api/json/v2/provincias/01/municipios/01001
API versión 1 Deprecated
Aviso
Esta versión de la API está en estado deprecada y será completamente desactivada el 31 de diciembre de 2023. Por favor, si estás haciendo usa de ella, comienza la migración a la versión 2 de la API, más reciente que esta.
Objetivo
El objetivo de esta versión es tener un conjunto de datos en formato JSON con los que poder interactuar mediante otros programas o interfaces y poder utilizar la información para diferentes fines.
Estes conjunto de datos también pueden ser usados para crear aplicaciones web SPA . Especialmente indicado para aquellas personas que se están formando en tecnologías JavaScript y su uso en el front-end actual.
Si haces uso de esta API con estos fines, no es obligatorio, pero si es de agradecer nombrarla y/o referenciarla mediante algún link.
A continuación podrás encontrar el listado de comandos:
Lista de provincias
https://www.el-tiempo.net/api/json/v1/provincias
Lista de municipios Eliminado
https://www.el-tiempo.net/api/json/v1/municipios
Información de una provincia
Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]
Un ejemplo:
https://www.el-tiempo.net/api/json/v1/provincias/01
Lista de municipios de una provincia
Debes usar CODPROV (id o código de provincia). Deben coincidir con un código de provincia para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]/municipios
Un ejemplo:
https://www.el-tiempo.net/api/json/v1/provincias/01/municipios
Información de un municipio
El [ID] son los primeros cinco dígitos del dato CODIGOINE que podrás encontrar, por ejemplo, en el comando anterior. Debes sustituir el [ID] por los cincos primeros dígitos del CODIGOINE.
Los dos primeros dígitos del CODIGOINE son los dos dígitos que representan CODPROV (id o código de provincia). Deben coincidir para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]/municipios/[ID]
Un ejemplo de la construcción de este comando:
https://www.el-tiempo.net/api/json/v1/provincias/01/municipios/01001
Información del tiempo de un municipio
Al igual que en el comando anterior, el [ID] son los cinco primeros dígitos del dato CODIGOINE que podrás encontrar, por ejemplo, en el comando anterior. Debes sustituir el [ID] por los cincos primeros dígitos del CODIGOINE.
Los dos primeros dígitos del CODIGOINE son los dos dígitos que representan CODPROV (id o código de provincia). Deben coincidir para ejecutar el comando con éxito.
https://www.el-tiempo.net/api/json/v1/provincias/[CODPROV]/municipios/[ID]/weather
Un ejemplo:
https://www.el-tiempo.net/api/json/v1/provincias/01/municipios/01001/weather
Recomendaciones sobre la API
La API de este sitio siempre ha existido, e intentaremos que siga siendo así por mucho tiempo, completamente abierta y con un objetivo de uso puramente pedagógico.
Ya sea para crear experimentos y/o usada en docencia para la realización de ejercicios en el campo de la tecnología y desarrollo de aplicaciones y web.
Es por eso que el uso de esta API para un entorno de producción no sea la más adecuada si tienes que hacer un uso intensivo de la información meteorológica. Es muy probable que este pequeño proyecto no sea capaz de asumir un número elevado de peticiones. Por este motivo es muy recomendable que si haces uso de la API aquí expuesta y tu proyecto está creciendo, migres a otra API que tenga un mayor soporte para un gran número de llamadas.
En cualquier caso no dejes de probar, usar y testear la API de elTiempo.net y su documentación. Y si te gusta este proyecto, no dejes de mencionarlo en tus blogs, artículos y/o redes.
.jpg)