{"id":21295892,"url":"https://github.com/kamaradclimber/vigieau","last_synced_at":"2025-07-04T16:05:09.028Z","repository":{"id":181429365,"uuid":"666758552","full_name":"kamaradclimber/vigieau","owner":"kamaradclimber","description":"A custom integration for home-assistant on the Vigieau dataset","archived":false,"fork":false,"pushed_at":"2025-06-17T07:05:44.000Z","size":299,"stargazers_count":23,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-17T08:20:47.671Z","etag":null,"topics":["hacktoberfest","hacs-integration","home-assistant","open-data","water"],"latest_commit_sha":null,"homepage":"","language":"Python","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/kamaradclimber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"zenodo":null}},"created_at":"2023-07-15T13:32:56.000Z","updated_at":"2025-06-17T07:05:33.000Z","dependencies_parsed_at":"2023-10-01T14:15:13.583Z","dependency_job_id":"2d2354ae-383f-4e9f-97a1-dabfa77cd5d4","html_url":"https://github.com/kamaradclimber/vigieau","commit_stats":{"total_commits":51,"total_committers":4,"mean_commits":12.75,"dds":0.1568627450980392,"last_synced_commit":"84d9c274f2f89f48051e4e1936e5ba699e556d30"},"previous_names":["kamaradclimber/vigieau"],"tags_count":49,"template":false,"template_full_name":null,"purl":"pkg:github/kamaradclimber/vigieau","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fvigieau","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fvigieau/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fvigieau/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fvigieau/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kamaradclimber","download_url":"https://codeload.github.com/kamaradclimber/vigieau/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kamaradclimber%2Fvigieau/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263572406,"owners_count":23482408,"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":["hacktoberfest","hacs-integration","home-assistant","open-data","water"],"created_at":"2024-11-21T14:09:30.094Z","updated_at":"2025-07-04T16:05:08.982Z","avatar_url":"https://github.com/kamaradclimber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vigieau for home-assistant\n\nComponent to expose water restrictions in France through Vigieau api. See https://vigieau.gouv.fr/ for web access.\n\nThis integration share location via a 3rd party (government) website (as the website does).\n\nData is based on the [vigieau](https://www.data.gouv.fr/fr/datasets/donnee-secheresse-vigieau/) dataset. It's really great to have access to such data.\n\n![downloads](https://img.shields.io/badge/dynamic/json?color=41BDF5\u0026logo=home-assistant\u0026label=integration%20usage\u0026suffix=%20installs\u0026cacheSeconds=15600\u0026url=https://analytics.home-assistant.io/custom_integrations.json\u0026query=$.vigieau.total)\n\n\n## Installation\n\nIt must be used as a custom repository via HACS.\n\n## Configuration\n\nOnce the custom integration has been added, add \"vigieau\" integration through the UI.\n\nYou can choose the location either by using HA coordinates (default), giving a specific town zip code or select a point in a map.\n\n![image info](/img/vigieau_location.png)\n\nHA coordinates are the one defined during initial setup and accessible using (`System\u003eGeneral\u003eEdit location`)\n\nOnce a first location is added a new one can be added (using city zip code or a pin on a map)\n\n### Using Zip Code\n![image info](/img/location.png)\n\nLocalisation is based on INSEE Code, not ZIP/Postal code. If several INSEE code correspond to provided Zip code, manual selection will be required..\n\n![image info](/img/multiloc.png)\n\n### Selecting a point on map\n![image info](/img/vigieau_map.png)\n\n## Known issues and workaround\n\n### Error communicating with API: Impossible to find approximate address of the current HA instance. API returned no result.\n\nThis integration uses a geocoding API to get the city code from INSEE (used as a input by Vigieau API). It is based on governement data which is still incomplete in some France areas.\n\nA workaround can be used by setting the `VIGIEAU_FORCED_INSEE_CITY_CODE` environment variable with the city code as value.\n⚠ Value of city code is not necessarily city \"postal code\". You can find it easily of wikipedia under the name [code commune](https://fr.wikipedia.org/wiki/Code_officiel_g%C3%A9ographique#Code_commune).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamaradclimber%2Fvigieau","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamaradclimber%2Fvigieau","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamaradclimber%2Fvigieau/lists"}