{"id":15972117,"url":"https://github.com/briis/pyvisualcrossing","last_synced_at":"2026-02-10T02:05:42.849Z","repository":{"id":195800603,"uuid":"693689445","full_name":"briis/pyVisualCrossing","owner":"briis","description":"Python Wrapper for Visual Crossing Weather API","archived":false,"fork":false,"pushed_at":"2024-11-11T18:49:29.000Z","size":60,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T05:27:12.953Z","etag":null,"topics":["visual-crossing","visual-crossing-api","weather","weather-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/briis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/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}},"created_at":"2023-09-19T14:13:32.000Z","updated_at":"2024-06-28T03:54:13.000Z","dependencies_parsed_at":"2024-01-10T21:12:52.507Z","dependency_job_id":"280d7392-d9bc-4895-9926-047fdbac4899","html_url":"https://github.com/briis/pyVisualCrossing","commit_stats":{"total_commits":65,"total_committers":3,"mean_commits":"21.666666666666668","dds":0.3076923076923077,"last_synced_commit":"fb13d72c0df8b0ab2dea518a4e80a71a0e9f3fa0"},"previous_names":["briis/pyvisualcrossing"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briis%2FpyVisualCrossing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briis%2FpyVisualCrossing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briis%2FpyVisualCrossing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/briis%2FpyVisualCrossing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/briis","download_url":"https://codeload.github.com/briis/pyVisualCrossing/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243886568,"owners_count":20363754,"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":["visual-crossing","visual-crossing-api","weather","weather-api"],"created_at":"2024-10-07T20:42:02.828Z","updated_at":"2026-02-10T02:05:42.639Z","avatar_url":"https://github.com/briis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Python Wrapper for Visual Crossing Weather API\n\nThis Python Wrapper retrives data from the [Visual Crossing](https://www.visualcrossing.com/) API. Visual Crossing has an extensive Weather API for both historical and forecast weather data, and they have a Free Tier API Key which enables up to 1000 calls per day.\n\nIn order to get started you must create an Account with Visual Crossing and then create an API Key. You do this by accessing [this website](https://www.visualcrossing.com/weather-data-editions) and clicking on the **Free** plan. Then follow the instructions to create and account and store your key in a safe place.\n\n## Usage\n\nInstall the module by using this command in a terminal: `pip install pyVisualCrossing`\n\nAnd then see `test_module.py` and `async_test_module.py` for usage examples, both standard and async. (Async example not yet created)\n\n## Parameters\n\n```python\n# Initialise the module\nvcapi = VisualCrossing(\n    api_key,\n    latitude,\n    longitude,\n    days=7,\n    language=\"da\"\n)\n````\n\n| Parameter | Required | Default | Description |\n| --------- | -------- | ------- | ----------- |\n| `api_key` | Yes      | `None`  | This is the API Key you signed up for from Visual Crossing. See above for instructions |\n| `latitude` | Yes     | `None`  | Latitude for the location position |\n| `longitude` | Yes     | `None`  | Longitude for the location position |\n| `days` | No     | `14`  | Numbers of days to retrieve forecast for. 14 days means today plus the next 14 days. On the Free plan, this is the maximum number of days |\n| `language` | No     | `en`  | The language in which text strings should be returned. Se below for list of valid languages. |\n| `session` | No     | `None`  | A session variable. Only used when using the async function. |\n\n\n\nFor an in-depth description of the Visual Crossing API, go [here](https://www.visualcrossing.com/resources/documentation/weather-api/timeline-weather-api/)\n\n## Languages\nAvailable languages include: **ar** (Arabic), **bg** (Bulgiarian), **cs** (Czech), **da** (Danish), **de** (German), **el** (Greek Modern), **en** (English), **es** (Spanish), **fa** (Farsi), **fi** (Finnish), **fr** (French), **he** (Hebrew), **hu**, (Hungarian), **it** (Italian), **ja** (Japanese), **ko** (Korean), **nl** (Dutch), **pl** (Polish), **pt** (Portuguese), **sr** (Serbian), **sv** (Swedish), **tr** (Turkish), **uk** (Ukranian), **vi** (Vietnamese) and **zh** (Chinese).\n\n## Metrics\nAll records are returned using the *Metric* unit system. There is no conversion possible at the moment.\n\n| Weather variable\t                   | Measurement Unit         |\n| -----------------------------------  | ------------------------ |\n| Datetime\t                           | UTC datetime             |\n| Temperature, Heat Index \u0026 Wind Chill | Degrees Celcius          |\n| Precipitation\t                       | Millimeters              |\n| snow\t                               | Centimeters              |\n| Wind \u0026 Wind Gust\t                   | Kilometers Per Hour      |\n| Visibility\t                       | Kilometers               |\n| Pressure\t                           | Millibars (Hectopascals) |\n| Solar Radiation\t                   | W/m2                     |\n| Solar Energy\t                       | MJ/m2                    |\n\n## Icons\nWe use the Iconset *icons2*, which gives a more detailed description of the conditions.\n\n| Icon id\t            | Weather Conditions |\n| --------------------  | ---------------------------- |\n| snow\t                | Amount of snow is greater than zero |\n| snow-showers-day\t    | Periods of snow during the day |\n| snow-showers-night    | Periods of snow during the night |\n| thunder-rain\t        | Thunderstorms throughout the day or night |\n| thunder-showers-day   | Possible thunderstorms throughout the day |\n| thunder-showers-night | Possible thunderstorms throughout the night |\n| rain                  | Amount of rainfall is greater than zero |\n| showers-day           | Rain showers during the day |\n| showers-night         | Rain showers during the night |\n| fog                   | Visibility is low (lower than one kilometer or mile) |\n| wind                  | Wind speed is high (greater than 30 kph or mph) |\n| cloudy                | Cloud cover is greater than 90% cover |\n| partly-cloudy-day     | Cloud cover is greater than 20% cover during day time. |\n| partly-cloudy-night   | Cloud cover is greater than 20% cover during night time. |\n| clear-day             | Cloud cover is less than 20% cover during day time |\n| clear-night           | Cloud cover is less than 20% cover during night time |\n\n## TODO\n\n- Add all available items to the Data Structure\n- Create `async_test_module.py` in the samples directory\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriis%2Fpyvisualcrossing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbriis%2Fpyvisualcrossing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriis%2Fpyvisualcrossing/lists"}