{"id":18647646,"url":"https://github.com/artcom/weather-service","last_synced_at":"2025-11-05T07:30:28.902Z","repository":{"id":40321234,"uuid":"90741077","full_name":"artcom/weather-service","owner":"artcom","description":"A NodeJS service publishing Openweatermap weather data to an MQTT broker","archived":false,"fork":false,"pushed_at":"2023-03-04T02:36:45.000Z","size":999,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":12,"default_branch":"master","last_synced_at":"2024-12-27T12:21:46.314Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/artcom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"publiccode":null,"codemeta":null}},"created_at":"2017-05-09T12:04:25.000Z","updated_at":"2023-02-15T15:06:00.000Z","dependencies_parsed_at":"2024-11-07T06:28:48.178Z","dependency_job_id":"02cf14cf-806c-497b-9fd1-9b66362a5012","html_url":"https://github.com/artcom/weather-service","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artcom%2Fweather-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artcom%2Fweather-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artcom%2Fweather-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/artcom%2Fweather-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/artcom","download_url":"https://codeload.github.com/artcom/weather-service/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239449658,"owners_count":19640560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-11-07T06:27:16.548Z","updated_at":"2025-11-05T07:30:28.855Z","avatar_url":"https://github.com/artcom.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Weather Service\n\nA backend service that retrieves weather data for a given location from the [openweathermap API](https://openweathermap.org/api) at a regular interval and publishes it to an MQTT broker.\n\n### License\n\nThe openweathermap API is licensed under the terms of the [Creative Commons Attribution-ShareAlike 4.0 International licence (CC BY-SA 4.0)](https://creativecommons.org/licenses/by-sa/4.0/).\n\nThe openweathermap data and database are open and licensed by the [Open Data Commons Open Database License (ODbL)](https://opendatacommons.org/licenses/odbl/).\n\n## Provided Data\n\n### `\u003cWEATHER_TOPIC\u003e/current`\n\n```javascript\n{\n  condition: \"wind\" | \"thunderstorm\" | \"rain\" | \"snow\" | \"cloudy\" | \"mixed\" | \"sunny\",\n  temperature: number,  # in degrees celsius\n  humidity: number,     # in percent\n  wind: {\n    speed: number,      # in km/h\n    direction: \"N\" | \"NE\" | \"E\" | \"SE\" | \"S\" | \"SW\" | \"W\" | \"NW\"\n  }\n}\n```\n\n### `\u003cWEATHER_TOPIC\u003e/forecast`\n\nContains forecasts for 7 days where the first entry is for today, the second for tomorrow and so forth.\n\n```javascript\n[\n  {\n    condition: \"wind\" | \"thunderstorm\" | \"rain\" | \"snow\" | \"cloudy\" | \"mixed\" | \"sunny\",\n    low: number,  # in degrees celsius\n    high: number  # in degrees celsius\n  }\n]\n```\n\n## Configuration\n\nThe service needs the following environment variables to be set:\n\n* `TCP_BROKER_URI` to access the broker and the `WEATHER_TOPIC` to publish to\n* `APP_ID` to authenticate with openweathermap\n* `LAT` and `LON` to define the location!\n\n## Local Setup\n\n```bash\nnpm install\n\n// set all environment variables needed\n\nnpm start\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartcom%2Fweather-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fartcom%2Fweather-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fartcom%2Fweather-service/lists"}