Looking back at that summer, the first "application" I created while playing.

Introduction#

This article is copied from my Github homepage and is considered as my first fully functional and usable application, so I use it to fill my first "Programming Application" category.

The inspiration for creating this application can be seen in the functional description later. Looking back now, I can still see the inexplicable enthusiasm I had when I grabbed the end of August. I spent all my time on this application, except for eating and sleeping.

I am extremely enthusiastic about the technology of this application and playing with various tools. This enthusiasm probably started in 2019, which connected the end of the cold winter, the chirping summer, and the beginning of the deep autumn.

I hope I can always maintain this precious "playfulness".

header

Author#

Author's homepage: zhuozhiyongde(Arthals)

Project address: Alfred_HeWeather_Workflow

Source code author's homepage: skefy(Leon)

Source code project address: alfred_workflow_weather

Functional Description#

Query disaster warnings, air quality index (AQI), real-time weather, and weather forecast for the next three days. This Alfred Workflow uses the HeWeather API (https://dev.heweather.com/), for educational and reference purposes only, and should not be used for commercial purposes.

This Alfred Workflow source code is from @skefy(Leon)/alfred_workflow_weather.

Because the original author initially set the base_url to the commercial version API, personal use requires modifying the source code, which is inconvenient. Moreover, the HeWeather API has been updated to v7, but the original author has not updated it. Therefore, based on the source code, I have refactored more than 90% of the original project.

In addition to the above changes, I have also made the following modifications:

Added disaster warning query. When there are multiple disaster warnings, it automatically returns a deduplicated and merged parallel string.
Added AQI query.
Modified the item layout and added more information to each item, such as sunrise and sunset, precipitation, and feels-like temperature. I also introduced Unicode icons in the layout, following the layout of @jason0x43/alfred-weather, making it more concise and intuitive.
Added adm and location parameters in the environment variables to accurately locate the city and obtain the city ID. This is also because the original automatic positioning interface is outdated and cannot accurately locate the county level. Therefore, the automatic positioning function has been abandoned.
You can still use the keyword + space + other city name to get the weather conditions of other cities. If the queried city is not within China, it will not return disaster warnings and AQI information.
Considering that most people use the personal/developer version API, I changed api in the base_url to devapi.
Added error prompts based on the latest version of the v7 API's status code.
Changed the original icons to the new version of HeWeather icons, which are more beautiful.

Regarding this, you can download other versions of HeWeather-designed icons from @heweather / WeatherIcon and replace the icons in the ./res/icon-heweather folder by yourself.
Added the quicklookurl parameter to preview the adaptive webpage returned by the fxLink of the API when selecting each result while holding down ⇧ or ⌘+Y to obtain more detailed information.
Added the date_valid() function to compare the three-day forecast obtained from the interface with the current date. The reason is that when I was writing the code until 5 o'clock, I accidentally found that the interface had not updated the data, resulting in the information for the 10th to 12th being returned at 5 o'clock on the 11th, and the original author did not correct it. It will automatically display the information from the 11th to the 13th starting from today.

Default keyword: rt#

Required parameters:#

api_key: Your WEB API key. Ordinary users have 1000 free requests per day, and developer versions have 16700 free requests. If you have more requirements, please purchase the commercial version or high-performance version API and replace devapi with api in line 65 of main.py according to your needs.

The developer version API can obtain hourly forecasts for the next 24 hours, but since I have not been certified yet, the development of this part is temporarily suspended.
adm: The upper-level province or city range of the selected county, used to prevent duplicate city names, such as Beijing Chaoyang District and Liaoning Chaoyang City.
location: Please select the county-level planning of the specific area, such as Haidian District/Hanyang County.

Instructions#

Make sure you have the Powerpack feature of Alfred.
Install this workflow.
Register with HeWeather and apply for an API key.
Registration process:

a. Go to HeWeather to register an account.

b. After registration, go to Console → Application Management → Create Application → Free Developer Edition → Fill in an application name → Select Key Type as WEB API → Follow the prompts to complete the registration.

c. You can see your API Key in the Console-Application Management.
Set the api_key environment parameter.

It is recommended to copy it somewhere first and check if there are any tabs/carriage returns copied in. Otherwise, an error will occur.
Set the adm and location environment parameters, which can be entered in Chinese.