seniverse

README

Golang

📦 Golang 心知天气

安装

go get -v -u go.dtapp.net/seniverse@v1.0.4

Documentation

Index

• Constants
• type ApiError
• type V3Client
  • func NewV3Client(key string) (*V3Client, error)
  • func (c *V3Client) ConfigApiGormFun(apiClientFun golog.ApiGormFun)
  • func (c *V3Client) WeatherDaily(ctx context.Context, location string, notMustParams ...gorequest.Params) (*V3WeatherDailyResult, ApiError, error)
  • func (c *V3Client) WeatherNow(ctx context.Context, location string, notMustParams ...gorequest.Params) (*V3WeatherNowResult, ApiError, error)
• type V3WeatherDailyResponse
• type V3WeatherDailyResult
• type V3WeatherNowResponse
• type V3WeatherNowResult
• type V4Client
  • func NewV4Client(publicKey string, secret string) (*V4Client, error)
  • func (c *V4Client) ConfigApiGormFun(apiClientFun golog.ApiGormFun)
  • func (c *V4Client) WeatherDaily(ctx context.Context, locations string, notMustParams ...gorequest.Params) (*V4WeatherDailyResult, ApiError, error)
• type V4WeatherDailyResponse
• type V4WeatherDailyResult

Constants

const LogTable = "seniverse"

const (
	Version = "1.0.4"
)

Types

type ApiError

type ApiError struct {
	Status     string `json:"status"`
	StatusCode string `json:"status_code"` // 心知状态码
}

type V3Client

type V3Client struct {
	// contains filtered or unexported fields
}

func NewV3Client

func NewV3Client(key string) (*V3Client, error)

func (*V3Client) ConfigApiGormFun

func (c *V3Client) ConfigApiGormFun(apiClientFun golog.ApiGormFun)

ConfigApiGormFun 接口日志配置

func (*V3Client) WeatherDaily

func (c *V3Client) WeatherDaily(ctx context.Context, location string, notMustParams ...gorequest.Params) (*V3WeatherDailyResult, ApiError, error)

WeatherDaily 未来15天逐日天气预报和昨日天气 https://seniverse.yuque.com/hyper_data/api_v3/sl6gvt

func (*V3Client) WeatherNow

func (c *V3Client) WeatherNow(ctx context.Context, location string, notMustParams ...gorequest.Params) (*V3WeatherNowResult, ApiError, error)

WeatherNow 天气实况 location 所查询的位置 https://seniverse.yuque.com/hyper_data/api_v3/nyiu3t

type V3WeatherDailyResponse

type V3WeatherDailyResponse struct {
	Results []struct {
		Location struct {
			Id             string `json:"id"`
			Name           string `json:"name"`
			Country        string `json:"country"`
			Path           string `json:"path"`
			Timezone       string `json:"timezone"`
			TimezoneOffset string `json:"timezone_offset"`
		} `json:"location"`
		Daily []struct {
			Date                string `json:"date"`                  // 日期（该城市的本地时间）
			TextDay             string `json:"text_day"`              // 白天天气现象文字
			CodeDay             string `json:"code_day"`              // 白天天气现象代码
			TextNight           string `json:"text_night"`            // 晚间天气现象文字
			CodeNight           string `json:"code_night"`            // 晚间天气现象代码
			High                string `json:"high"`                  // 当天最高温度
			Low                 string `json:"low"`                   // 当天最低温度
			Precip              string `json:"precip"`                // 降水概率，范围0~100，单位百分比（目前仅支持国外城市）
			WindDirection       string `json:"wind_direction"`        // 风向文字
			WindDirectionDegree string `json:"wind_direction_degree"` // 风向角度，范围0~360
			WindSpeed           string `json:"wind_speed"`            // 风速，单位km/h（当unit=c时）、mph（当unit=f时）
			WindScale           string `json:"wind_scale"`            // 风力等级
			Rainfall            string `json:"rainfall"`              // 降水量，单位mm
			Humidity            string `json:"humidity"`              // 相对湿度，0~100，单位为百分比
		} `json:"daily"`
		LastUpdate time.Time `json:"last_update"`
	} `json:"results"`
}

type V3WeatherDailyResult

type V3WeatherDailyResult struct {
	Result V3WeatherDailyResponse // 结果
	Body   []byte                 // 内容
	Http   gorequest.Response     // 请求·
}

type V3WeatherNowResponse

type V3WeatherNowResponse struct {
	Results []struct {
		Location struct {
			Id             string `json:"id"`
			Name           string `json:"name"`
			Country        string `json:"country"`
			Path           string `json:"path"`
			Timezone       string `json:"timezone"`
			TimezoneOffset string `json:"timezone_offset"`
		} `json:"location"`
		Now struct {
			Text                string `json:"text"`                  // 天气现象文字
			Code                string `json:"code"`                  // 天气现象代码
			Temperature         string `json:"temperature"`           // 温度，单位为c摄氏度或f华氏度
			FeelsLike           string `json:"feels_like"`            // 体感温度，单位为c摄氏度或f华氏度
			Pressure            string `json:"pressure"`              // 气压，单位为mb百帕或in英寸
			Humidity            string `json:"humidity"`              // 相对湿度，0~100，单位为百分比
			Visibility          string `json:"visibility"`            // 能见度，单位为km公里或mi英里
			WindDirection       string `json:"wind_direction"`        // 风向文字
			WindDirectionDegree string `json:"wind_direction_degree"` // 风向角度，范围0~360
			WindSpeed           string `json:"wind_speed"`            // 风速，单位km/h（当unit=c时）、mph（当unit=f时）
			WindScale           string `json:"wind_scale"`            // 风力等级
			Clouds              string `json:"clouds"`                // 云量，单位%，范围0~100，天空被云覆盖的百分比 #目前不支持中国城市#
			DewPoint            string `json:"dew_point"`             // 露点温度，请参考：http://baike.baidu.com/view/118348.htm #目前不支持中国城市#
		} `json:"now"`
		LastUpdate time.Time `json:"last_update"`
	} `json:"results"`
}

type V3WeatherNowResult

type V3WeatherNowResult struct {
	Result V3WeatherNowResponse // 结果
	Body   []byte               // 内容
	Http   gorequest.Response   // 请求·
}

type V4Client

type V4Client struct {
	// contains filtered or unexported fields
}

func NewV4Client

func NewV4Client(publicKey string, secret string) (*V4Client, error)

func (*V4Client) ConfigApiGormFun

func (c *V4Client) ConfigApiGormFun(apiClientFun golog.ApiGormFun)

ConfigApiGormFun 接口日志配置

func (*V4Client) WeatherDaily

func (c *V4Client) WeatherDaily(ctx context.Context, locations string, notMustParams ...gorequest.Params) (*V4WeatherDailyResult, ApiError, error)

WeatherDaily 天气网格预报（中国/15天/逐日） https://seniverse.yuque.com/hyper_data/api_v4/weather_daily

type V4WeatherDailyResponse

type V4WeatherDailyResponse struct {
	Status     string    `json:"status"`      // 状态
	ApiVersion string    `json:"api_version"` // api版本
	ApiStatus  string    `json:"api_status"`  // api状态
	Lang       string    `json:"lang"`
	Unit       string    `json:"unit"`
	Tzshift    float64   `json:"tzshift"`
	Timezone   string    `json:"timezone"`
	ServerTime float64   `json:"server_time"`
	Location   []float64 `json:"location"`
	Result     struct {
		Alert struct {
			Status  string `json:"status"`
			Content []struct {
				Pubtimestamp  int       `json:"pubtimestamp"` // 发布时间，单位是 Unix 时间戳
				AlertID       string    `json:"alertId"`      // 预警 ID
				Status        string    `json:"status"`       // 预警信息的状态
				Adcode        string    `json:"adcode"`       // 区域代码
				Location      string    `json:"location"`     // 位置
				Province      string    `json:"province"`     // 省
				City          string    `json:"city"`         // 市
				County        string    `json:"county"`       // 县
				Code          string    `json:"code"`         // 预警代码
				Source        string    `json:"source"`       // 发布单位
				Title         string    `json:"title"`        // 标题
				Description   string    `json:"description"`  // 描述
				RegionID      string    `json:"regionId"`
				Latlon        []float64 `json:"latlon"`
				RequestStatus string    `json:"request_status"`
			} `json:"content"`
			Adcodes []struct {
				Adcode int    `json:"adcode"`
				Name   string `json:"name"`
			} `json:"adcodes"` // 行政区划层级信息
		} `json:"alert"` // 预警数据
		WeatherDaily struct {
			Status string `json:"status"`
			Astro  []struct {
				Date    string `json:"date"`
				Sunrise struct {
					Time string `json:"time"`
				} `json:"sunrise"`
				Sunset struct {
					Time string `json:"time"`
				} `json:"sunset"`
			} `json:"astro"` // 日出日落时间，当地时区的时刻，tzshift 不作用在这个变量)
			Precipitation08H20H []struct {
				Date        string  `json:"date"`
				Max         float64 `json:"max"`
				Min         float64 `json:"min"`
				Avg         float64 `json:"avg"`
				Probability float64 `json:"probability"`
			} `json:"precipitation_08h_20h"` // 白天降水数据
			Precipitation20H32H []struct {
				Date        string  `json:"date"`
				Max         float64 `json:"max"`
				Min         float64 `json:"min"`
				Avg         float64 `json:"avg"`
				Probability float64 `json:"probability"`
			} `json:"precipitation_20h_32h"` // 夜晚降水数据
			Precipitation []struct {
				Date        string  `json:"date"`
				Max         float64 `json:"max"`
				Min         float64 `json:"min"`
				Avg         float64 `json:"avg"`
				Probability float64 `json:"probability"`
			} `json:"precipitation"` // 降水数据
			Temperature []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"temperature"` // 全天地表 2 米气温
			Temperature08H20H []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"temperature_08h_20h"` // 白天地表 2 米气温
			Temperature20H32H []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"temperature_20h_32h"` // 夜晚地表 2 米气温
			Wind []struct {
				Date string `json:"date"`
				Max  struct {
					Speed     float64 `json:"speed"` // 全天地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"max"`
				Min struct {
					Speed     float64 `json:"speed"` // 全天地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"min"`
				Avg struct {
					Speed     float64 `json:"speed"` // 全天地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"avg"`
			} `json:"wind"`
			Wind08H20H []struct {
				Date string `json:"date"`
				Max  struct {
					Speed     float64 `json:"speed"` // 白天地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"max"`
				Min struct {
					Speed     float64 `json:"speed"` // 白天地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"min"`
				Avg struct {
					Speed     float64 `json:"speed"` // 白天地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"avg"`
			} `json:"wind_08h_20h"`
			Wind20H32H []struct {
				Date string `json:"date"`
				Max  struct {
					Speed     float64 `json:"speed"` // 夜晚地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"max"`
				Min struct {
					Speed     float64 `json:"speed"` // 夜晚地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"min"`
				Avg struct {
					Speed     float64 `json:"speed"` // 夜晚地表 10 米风速
					Direction float64 `json:"direction"`
				} `json:"avg"`
			} `json:"wind_20h_32h"`
			Humidity []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"humidity"` // 地表 2 米相对湿度(%)
			Cloudrate []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"cloudrate"` // 云量(0.0-1.0)
			Pressure []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"pressure"` // 地面气压
			Visibility []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"visibility"` // 地表水平能见度
			Dswrf []struct {
				Date string  `json:"date"`
				Max  float64 `json:"max"`
				Min  float64 `json:"min"`
				Avg  float64 `json:"avg"`
			} `json:"dswrf"` // 向下短波辐射通量(W/M2)
			AirQuality struct {
				Aqi []struct {
					Date string `json:"date"`
					Max  struct {
						Chn float64 `json:"chn"`
						Usa float64 `json:"usa"`
					} `json:"max"`
					Avg struct {
						Chn float64 `json:"chn"`
						Usa float64 `json:"usa"`
					} `json:"avg"`
					Min struct {
						Chn float64 `json:"chn"`
						Usa float64 `json:"usa"`
					} `json:"min"`
				} `json:"aqi"` // 国标 AQI
				Pm25 []struct {
					Date string  `json:"date"`
					Max  float64 `json:"max"`
					Avg  float64 `json:"avg"`
					Min  float64 `json:"min"`
				} `json:"pm25"` // PM2.5 浓度(μg/m3)
			} `json:"air_quality"`
			Skycon []struct {
				Date  string `json:"date"`
				Value string `json:"value"` // 全天主要 天气现象
			} `json:"skycon"`
			Skycon08H20H []struct {
				Date  string `json:"date"`
				Value string `json:"value"` // 白天主要 天气现象
			} `json:"skycon_08h_20h"`
			Skycon20H32H []struct {
				Date  string `json:"date"`
				Value string `json:"value"` // 夜晚主要 天气现象
			} `json:"skycon_20h_32h"`
			LifeIndex struct {
				Ultraviolet []struct {
					Date  string `json:"date"`
					Index string `json:"index"`
					Desc  string `json:"desc"` // 紫外线指数自然语言
				} `json:"ultraviolet"`
				CarWashing []struct {
					Date  string `json:"date"`
					Index string `json:"index"`
					Desc  string `json:"desc"` // 洗车指数自然语言
				} `json:"carWashing"`
				Dressing []struct {
					Date  string `json:"date"`
					Index string `json:"index"`
					Desc  string `json:"desc"` // 穿衣指数自然语言
				} `json:"dressing"`
				Comfort []struct {
					Date  string `json:"date"`
					Index string `json:"index"`
					Desc  string `json:"desc"` // 舒适度指数自然语言
				} `json:"comfort"`
				ColdRisk []struct {
					Date  string `json:"date"`
					Index string `json:"index"`
					Desc  string `json:"desc"` // 感冒指数自然语言
				} `json:"coldRisk"`
			} `json:"life_index"`
		} `json:"WeatherDaily"` // 天级别预报
		Primary float64 `json:"primary"`
	} `json:"result"`
}

type V4WeatherDailyResult

type V4WeatherDailyResult struct {
	Result V4WeatherDailyResponse // 结果
	Body   []byte                 // 内容
	Http   gorequest.Response     // 请求·
}