weather

README

weather

weather skd for tianqiapi.com v91

how to use

package main

import (
	"fmt"
	"time"

	"github.com/tiantour/weather"
)

func main() {
	weather.AppID = "you appid"
	weather.AppSecret = "you appsecret"
	weather.Version = "v91"

	result, err := weather.NewWeather().FetchWithTTL(cityID, 1, 7200*time.Second)
	if err != nil {
		fmt.Println(err)
	}

	for k, v := range result.Data {
		fmt.Println(k, v)
	}
}

Documentation

Index

• Variables
• type Alarm
• type Data
• type Hour
• type Weather
  • func NewWeather() *Weather
  • func (w *Weather) Fetch(cityID int32) (*Weather, error)
  • func (w *Weather) FetchWithTTL(cityID int32, cost int64, ttl time.Duration) (*Weather, error)
• type Week

Variables

var (
	AppID     int32  //  AppID
	AppSecret string // AppSecret
	Version   string // Version
)

Types

type Alarm

type Alarm struct {
	AlarmType    string `json:"alarm_type,omitempty"`    // 预警类型
	AlarmLevel   string `json:"alarm_level,omitempty"`   // 预警级别
	AlarmTitle   string `json:"alarm_title,omitempty"`   // 预警标题
	AlarmContent string `json:"alarm_content,omitempty"` // 预警内容
}

type Data

type Data struct {
	Wea           string   `json:"wea,omitempty"`           // 天气情况1
	WeaImg        string   `json:"wea_img,omitempty"`       // 固定9种类型(您也可以根据wea字段自己处理)xue、lei、shachen、wu、bingbao、yun、yu、yin、qing
	Phrase        string   `json:"phrase,omitempty"`        // 天气情况短语
	Narrative     string   `json:"narrative,omitempty"`     // 天气情况描述
	Tem           string   `json:"tem,omitempty"`           // 实时温度
	Tem1          string   `json:"tem1,omitempty"`          // 高温
	Tem2          string   `json:"tem2,omitempty"`          // 低温
	Win           []string `json:"win,omitempty"`           // 风力
	WinSpeed      string   `json:"win_speed,omitempty"`     // 风力等级
	Humidity      string   `json:"humidity,omitempty"`      // 湿度
	Sunrise       string   `json:"sunrise,omitempty"`       // 日出
	Sunset        string   `json:"sunset,omitempty"`        // 日落
	Moonrise      string   `json:"moonrise,omitempty"`      // 月出
	Moonset       string   `json:"moonset,omitempty"`       // 月落
	MoonPhrase    string   `json:"moonPhrase,omitempty"`    // 月相
	Visibility    string   `json:"visibility,omitempty"`    // 能见度
	Pressure      string   `json:"pressure,omitempty"`      // 气压
	Air           string   `json:"air,omitempty"`           // 空气质量
	AirLevel      string   `json:"air_level,omitempty"`     // 空气质量等级
	AirTips       string   `json:"air_tips,omitempty"`      // 空气质量描述
	Rain          string   `json:"rain,omitempty"`          // 降雨概率
	UvIndex       string   `json:"uvIndex,omitempty"`       // 紫外线等级
	UvDescription string   `json:"uvDescription,omitempty"` // 紫外线等级描述
	Alarm         []*Alarm `json:"alarm,omitempty"`         // 预警

}

type Hour

type Hour struct {
	Time     string `json:"time,omitempty"`      // 时间
	Icon     string `json:"icon,omitempty"`      // Icon
	Wea      string `json:"wea,omitempty"`       // 天气
	WeaImg   string `json:"wea_img,omitempty"`   // 天气图片
	Rain     string `json:"rain,omitempty"`      // 下雨
	Win      string `json:"win,omitempty"`       // 风力
	WinMeter string `json:"win_meter,omitempty"` // 风速

}

type Weather

type Weather struct {
	ErrCode    int32   `json:"errcode,omitempty"`     // 错误代码
	ErrMsg     string  `json:"errmsg,omitempty"`      // 错误消息
	UpdateTime string  `json:"update_time,omitempty"` // 更新时间
	CityID     string  `json:"citydid,omitempty"`     // 城市编号
	City       string  `json:"city,omitempty"`        // 城市名称
	CityEN     string  `json:"cityEN,omitempty"`      // 城市英文名称
	Country    string  `json:"country,omitempty"`     // 国家名称
	CountryEN  string  `json:"countryEN,omitempty"`   // 国家英文名称
	Data       []*Data `json:"data,omitempty"`        // 每日数据
}

Weather weather

func NewWeather

func NewWeather() *Weather

NewWeather new weather

func (*Weather) Fetch

func (w *Weather) Fetch(cityID int32) (*Weather, error)

Fetch fetch weather

func (*Weather) FetchWithTTL

func (w *Weather) FetchWithTTL(cityID int32, cost int64, ttl time.Duration) (*Weather, error)

type Week

type Week struct {
	Date          string  `json:"date,omitempty"`            // 日期
	Week          string  `json:"week,omitempty"`            // 星期
	DayTem        string  `json:"day_tem,omitempty"`         // 日期温度
	DayWea        string  `json:"day_wea,omitempty"`         // 日期天气
	DayWeaImg     string  `json:"day_wea_img,omitempty"`     // 日期天气图片
	DayWeaIcon    string  `json:"day_wea_icon,omitempty"`    // 日期天气图标
	DayWin        string  `json:"day_win,omitempty"`         // 日期风力
	DayWinSpeed   string  `json:"day_win_speed,omitempty"`   // 日期风速
	NightTem      string  `json:"night_tem,omitempty"`       // 夜晚温度
	NightWea      string  `json:"night_wea,omitempty"`       // 夜晚天气
	NightWeaImg   string  `json:"night_wea_img,omitempty"`   // 夜晚天气图片
	NightWeaIcon  string  `json:"night_wea_icon,omitempty"`  // 夜晚天气图标
	NightWin      string  `json:"night_win,omitempty"`       // 夜晚风力
	NightWinSpeed string  `json:"night_win_speed,omitempty"` // 夜晚风速度
	Hours         []*Hour `json:"hours,omitempty"`           // 小时风力
}