{"id":36702082,"url":"https://github.com/noi-techpark/webcomp-meteo-generic","last_synced_at":"2026-01-12T11:39:11.522Z","repository":{"id":52546125,"uuid":"300230879","full_name":"noi-techpark/webcomp-meteo-generic","owner":"noi-techpark","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-12T13:30:29.000Z","size":1287,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-12T14:32:13.353Z","etag":null,"topics":["component","web"],"latest_commit_sha":null,"homepage":"https://webcomponents.opendatahub.bz.it/webcomponent/8ed52ba6-ce1d-45c8-83bb-062d688b4326","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/noi-techpark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-10-01T09:59:12.000Z","updated_at":"2025-02-12T13:21:36.000Z","dependencies_parsed_at":"2023-11-28T11:32:00.613Z","dependency_job_id":"7875a52d-5af8-44c0-ae65-6367dc95aa39","html_url":"https://github.com/noi-techpark/webcomp-meteo-generic","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":"noi-techpark/webcomp-boilerplate","purl":"pkg:github/noi-techpark/webcomp-meteo-generic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noi-techpark%2Fwebcomp-meteo-generic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noi-techpark%2Fwebcomp-meteo-generic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noi-techpark%2Fwebcomp-meteo-generic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noi-techpark%2Fwebcomp-meteo-generic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noi-techpark","download_url":"https://codeload.github.com/noi-techpark/webcomp-meteo-generic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noi-techpark%2Fwebcomp-meteo-generic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["component","web"],"created_at":"2026-01-12T11:39:10.728Z","updated_at":"2026-01-12T11:39:11.517Z","avatar_url":"https://github.com/noi-techpark.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: NOI Techpark \u003cdigital@noi.bz.it\u003e\n\nSPDX-License-Identifier: CC0-1.0\n--\u003e\n\n# Generic Meteorology \n\n[![REUSE Compliance](https://github.com/noi-techpark/webcomp-meteo-generic/actions/workflows/reuse.yml/badge.svg)](https://github.com/noi-techpark/odh-docs/wiki/REUSE#badges)\n[![REUSE status](https://api.reuse.software/badge/github.com/noi-techpark/webcomp-meteo-generic)](https://api.reuse.software/info/github.com/noi-techpark/webcomp-meteo-generic)\n[![CI/CD](https://github.com/noi-techpark/webcomp-meteo-generic/actions/workflows/main.yml/badge.svg)](https://github.com/noi-techpark/webcomp-meteo-generic/actions/workflows/main.yml)\n\nAll the meteorological features in one component.\n\nDo you want to see it in action? Go to our [web component store](https://webcomponents.opendatahub.com/webcomponent/8ed52ba6-ce1d-45c8-83bb-062d688b4326)!\n\n- [Generic Meteorology](#generic-meteorology)\n  - [Usage](#usage)\n    - [Attributes](#attributes)\n      - [width](#width)\n      - [height](#height)\n      - [fontFamily](#fontfamily)\n      - [language](#language)\n      - [mapAttribution](#mapattribution)\n      - [currentLocation](#currentlocation)\n      - [tiles-url](#tiles-url)\n      - [enabledStations](#enabledstations)\n      - [visibleParameters](#visibleparameters)\n      - [visibleTabs](#visibletabs)\n      - [startingTab](#startingtab)\n    - [Prerequisites](#prerequisites)\n    - [Source code](#source-code)\n    - [.env](#env)\n    - [Dependencies](#dependencies)\n    - [Build](#build)\n  - [Docker environment](#docker-environment)\n    - [Installation](#installation)\n    - [Dependenices](#dependenices)\n    - [Start and stop the containers](#start-and-stop-the-containers)\n    - [Running commands inside the container](#running-commands-inside-the-container)\n  - [Information](#information)\n    - [Support](#support)\n    - [Contributing](#contributing)\n    - [Documentation](#documentation)\n    - [Boilerplate](#boilerplate)\n    - [License](#license)\n\n\n## Usage\n\nInclude the web component script file `dist/odh-meteo-generic.js` in your HTML and define the web component like this:\n```html\n\u003codh-meteo-generic\n    width=\"100%\"\n    height=\"800px\"\n    fontFamily=\"Arial\"\n    language=\"it\"\n    mapAttribution=\"\u0026copy; \u003ca href='https://openstreetmap.org/copyright'\u003eOpenStreetMap contributors\u003c/a\u003e\"\n    currentLocation='{ \"lat\": 46.31, \"lng\": 11.26 }'\n    tiles-url=\"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png\"\n    enabledStations=\"3C461DDEDCE84E25BB8125B0E051344C,00390SF\"\n    visibleParameters='[\"air-temperature\",\"temperature\",\"precipitation\"]'\u003e\n\u003c/odh-meteo-generic\u003e\n```\n\n### Attributes\n\n#### width\n\nGive a fixed width to the component. Works only from desktop up. You can use `px` or `%` as unit size.\n\nExamples: `width=\"100%\"`\n\n#### height\n\nGive a fixed height to the component. Works only from desktop up. You can use `px` or `%` as unit size.\n\nExample: `height=\"500px\"`\n\n#### fontFamily\n\nSet the typeface.\n\nExample: `fontFamily=\"Arial\"`\n\n#### language\n\nSet the default and starting language. Possible values are \"en\" or \"de\" or \"it\"\n\nExample: `language=\"en\"`\n\n#### mapAttribution\n\nSet the acknowledgement for the map tiles provider.\n\nExample: `mapAttribution=\"\u0026copy; \u003ca href='https://openstreetmap.org/copyright'\u003eOpenStreetMap contributors\u003c/a\u003e\"`\n\n#### currentLocation\n\nSet the starting point position on the map.\n\nExample: `currentLocation='{ \"lat\": 46.31, \"lng\": 11.26 }'`\n\n#### tiles-url\n\nSet the URL of the API that provides the tiles.\n\nExample: `tiles-url=\"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png\"`\n\n#### enabledStations\n\nSet the stations that the map will show. It's a CSV like field. The parameter accepts both `Id` and `scode` values.\n\nExample: `\"3C461DDEDCE84E25BB8125B0E051344C,00390SF\"`\n\n#### visibleParameters\n\nSet the visible parameters in the station details tab.\n\nExample: `'[\"air-temperature\",\"temperature\",\"precipitation\"]'`\n\n#### visibleTabs\n\nSet the visible tabs in the menu. The default value is:\n```js\n[\"map\", \"forecasts\", \"video\", \"onTheMountains\", \"byArea\"]\n```\nWith all the tabs enabled.\n\nexample: `visibleTabs='[\"video\", \"onTheMountains\", \"byArea\"]'`\n\n#### startingTab\n\nSet the initial tab that the user will see. You can choose one between those values:\n`\"map\", \"forecasts\", \"video\", \"onTheMountains\", \"byArea\"`\n\nexample: `startingTab=\"onTheMountains\"`\n\n\n\nThese instructions will get you a copy of the project up and running\non your local machine for development and testing purposes.\n\n### Prerequisites\n\nTo build the project, the following prerequisites must be met:\n\n- Node 14.15.4 / NPM 8.1.2\n\nFor a ready to use Docker environment with all prerequisites already installed\nand prepared, you can check out the [Docker environment](#docker-environment)\nsection.\n\n### Source code\n\nGet a copy of the repository:\n\n```bash\ngit clone git@github.com:noi-techpark/webcomp-meteo-generic.git\n```\n\nChange directory:\n\n```bash\ncd webcomp-meteo-generic/\n```\n\n### .env\n\nCreate a `.env` file in the main directory.\nFill it with this content:\n\n```\nHEREMAPS_API_KEY=YourKey\n```\n\nReplace `YourKey` with your API token to use the tiles and the search bar.\n\n### Dependencies\n\nDownload all dependencies:\n\n```bash\nnpm install\n```\n\n### Build\n\nBuild and start the project:\n\n```bash\nnpm run start\n```\n\nThe application will be served and can be accessed at [http://localhost:8080](http://localhost:8080).\n\n\u003c!-- ## Tests and linting\n\nThe tests and the linting can be executed with the following commands:\n\n```bash\nnpm run test\nnpm run lint\n``` --\u003e\n\n## Deployment\n\nTo create the distributable files, execute the following command:\n\n```bash\nnpm run build\n```\n\n## Docker environment\n\nFor the project a Docker environment is already prepared and ready to use with all necessary prerequisites.\n\nThese Docker containers are the same as used by the continuous integration servers.\n\n### Installation\n\nInstall [Docker](https://docs.docker.com/install/) (with Docker Compose) locally on your machine.\n\n### Dependenices\n\nFirst, install all dependencies:\n\n```bash\ndocker-compose run --rm app /bin/bash -c \"npm install\"\n```\n\n### Start and stop the containers\n\nBefore start working you have to start the Docker containers:\n\n```\ndocker-compose up --build --detach\n```\n\nAfter finished working you can stop the Docker containers:\n\n```\ndocker-compose stop\n```\n\n### Running commands inside the container\n\nWhen the containers are running, you can execute any command inside the\nenvironment. Just replace the dots `...` in the following example with the\ncommand you wish to execute:\n\n```bash\ndocker-compose run --rm app /bin/bash -c \"...\"\n```\n\nSome examples are:\n\n```bash\ndocker-compose run --rm app /bin/bash -c \"npm run start\"\n```\n\n## Information\n\n### Support\n\nToDo: For support, please contact [help@opendatahub.com](mailto:help@opendatahub.com).\n\n### Contributing\n\nIf you'd like to contribute, please follow the following instructions:\n\n- Fork the repository.\n\n- Checkout a topic branch from the `development` branch.\n\n- Make sure the tests are passing.\n\n- Create a pull request against the `development` branch.\n\nA more detailed description can be found here: [https://github.com/noi-techpark/documentation/blob/master/contributors.md](https://github.com/noi-techpark/documentation/blob/master/contributors.md).\n\n### Documentation\n\nMore documentation can be found at [https://opendatahub.readthedocs.io/en/latest/index.html](https://opendatahub.readthedocs.io/en/latest/index.html).\n\n### Boilerplate\n\nThe project uses this boilerplate: [https://github.com/noi-techpark/webcomp-boilerplate](https://github.com/noi-techpark/webcomp-boilerplate).\n\n### License\n\nThe code in this project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3 license. See the [LICENSE.md](LICENSE.md) file for more information.\n\n### REUSE\n\nThis project is [REUSE](https://reuse.software) compliant, more information about the usage of REUSE in NOI Techpark repositories can be found [here](https://github.com/noi-techpark/odh-docs/wiki/Guidelines-for-developers-and-licenses#guidelines-for-contributors-and-new-developers).\n\nSince the CI for this project checks for REUSE compliance you might find it useful to use a pre-commit hook checking for REUSE compliance locally. The [pre-commit-config](.pre-commit-config.yaml) file in the repository root is already configured to check for REUSE compliance with help of the [pre-commit](https://pre-commit.com) tool.\n\nInstall the tool by running:\n```bash\npip install pre-commit\n```\nThen install the pre-commit hook via the config file by running:\n```bash\npre-commit install\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoi-techpark%2Fwebcomp-meteo-generic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoi-techpark%2Fwebcomp-meteo-generic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoi-techpark%2Fwebcomp-meteo-generic/lists"}