China Air Quality Index API for Ruby. Thanks pm25.in for provide all the AQI sources for us as free, all the data is form China's official sector. it's a reall gread work! ChinaAqi gem provide some interface base on Ruby On Rails, before to use it, you need ask for a token form pm25.in.
All monitoring stations in most cities of China are available, most AQI data are available, they are:
- CO: 一氧化碳
- NO2: 二氧化氮
- O3: 臭氧
- PM10: 颗粒物（粒径小于等于10μm）
- PM2.5: 颗粒物（粒径小于等于2.5μm）
- SO2: 二氧化硫
About PM2.5 reporting from U.S. Consulate please check out: pm25
Add this line to your application's Gemfile:
gem 'china_aqi'
And then execute:
$ bundle
Or install it yourself as:
$ gem install china_aqi
Run install generator:
$ rails generate china_aqi:install
It will add a new line in config/application.rb:
config.china_aqi_token = 'you_token_here'Put you token there.
As we mention at the beginning, we must get a token form pm25.in before we use their APIs, it's free!
Most APIs accept three params:
city: city name can be chinese characters, pinyin and area code('上海' or 'shanghai' or '021')avg: true/false, optional, if true,return average for all monitoring stations, default is true.stations: yes/no, optional, if yes, return data for all monitoring stations; if no, just return average without stations data, default is yes.
avg and stations params is optional, it will use defaut value if not set them.
shanghai = ChinaAqi::CO.new('上海', avg: true, stations: :yes) # same as ChinaAqi::CO.new('上海')
# => #<ChinaAqi::CO:0x007fbf9d953238 @city="021", @parmas={:avg=>true ...
shanghai.get
# => [{"aqi"=>57, "area"=>"上海", "co"=>0.0, "co_24h"=>0.0, "position_name"=>"普陀", "primary_pollutant" ...
ChinaAqi::CO.get('上海', avg: true, stations: :yes) # => Same as aboveChinaAqi::NO2.new('021').get # or ChinaAqi::NO2.get('021')
# => [{"aqi"=>57, "area"=>"上海", "no2"=>0, "no2_24h"=>0, "position_name"=>"普陀", "primary_pollutant" ...ChinaAqi::O3.new('shanghai').get # or ChinaAqi::O3.get('shanghai')
# => [{"aqi"=>57, "area"=>"上海", "o3"=>0, "o3_24h"=>0, "o3_8h"=>0, "o3_8h_24h"=>0, "position_name" ...ChinaAqi::PM10.new('上海').get # or ChinaAqi::PM10.get('上海')
# => [{"aqi"=>57, "area"=>"上海", "pm10"=>55, "pm10_24h"=>64, "position_name"=>"普陀", "primary_pollutant" ...ChinaAqi::PM25.new('shanghai').get # or ChinaAqi::PM25.get('shanghai')
# => [{"aqi"=>57, "area"=>"上海", "pm2_5"=>21, "pm2_5_24h"=>38, "position_name"=>"普陀", "primary_pollutant" ...ChinaAqi::SO2.new('shanghai').get # or ChinaAqi::SO2.get('shanghai')
# => [{"aqi"=>57, "area"=>"上海", "so2"=>0, "so2_24h"=>0, "position_name"=>"普陀", "primary_pollutant" ...ChinaAqi::City.new('shanghai').get # or ChinaAqi::City.get('shanghai')
# => [{"aqi"=>57, "area"=>"上海", "so2"=>0, "so2_24h"=>0, "position_name"=>"普陀", "primary_pollutant" ...ChinaAqi::CityPro.new('shanghai').get # or ChinaAqi::CityPro.get('shanghai')
# => [{"aqi"=>57, "area"=>"上海", "co"=>0.0, "co_24h"=>0.0, "no2"=>0, "no2_24h"=>0, ...ChinaAqi::Station.new('1141A').get # or ChinaAqi::Station.get('1141A')
# => [{"aqi"=>57, "area"=>"上海", "co"=>0.0, "co_24h"=>0.0, "no2"=>0, "no2_24h"=>0, ...ChinaAqi::Global.new.get
# same as below:
ChinaAqi::Global.get
# => [{"aqi"=>57, "area"=>"上海", "co"=>0.0, "co_24h"=>0.0, "no2"=>0, "no2_24h"=>0, ...ChinaAqi::Ranking.new.get
# same as below:
ChinaAqi::Ranking.get
# => [{"aqi"=>57, "area"=>"上海", "co"=>0.0, "co_24h"=>0.0, "no2"=>0, "no2_24h"=>0, ...# Get station names and station codes for one city
ChinaAqi.get_stations_for_city('上海')
ChinaAqi.get_stations_for_city('shanghai')
ChinaAqi.get_stations_for_city('021')
# same as:
ChinaAqi::CityStations.get('上海/shanghai/021')
# {"city"=>"上海", "stations"=>[{"station_name"=>"普陀" ..- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent