和风天气 .NET（C#） SDK Sparrow.Qweather

原创已于 2026-04-29 08:53:31 修改 · 410 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#c# #.net #asp.net #.netcore

于 2026-04-29 08:53:10 首次发布

.NET Core 专栏收录该内容

4 篇文章

订阅专栏

和风天气 .NET（C#） SDK Sparrow.Qweather

简介

Sparrow.Qweather 是基于和风天气开放平台官方 API 封装的 .NET SDK，提供简洁、类型安全的异步调用接口，让开发者无需关心 JWT 签名与 HTTP 细节，即可在 .NET 项目中快速接入全球气象数据服务。

项目地址

GitHub：https://github.com/cnsmallant/sparrow.qweather
Gitee：https://gitee.com/dikeko/sparrow.qweather

特性

全覆盖：封装和风天气 12 大类、27 个接口，包括天气预报、空气质量、台风、海洋、天文、历史数据等
开箱即用：统一的 WebApiClient 扩展方法，一行代码发起请求
安全鉴权：内置 Ed25519 私钥 + JWT 签名，无需手动处理认证逻辑
异步优先：全部接口采用 async/await 模式，天然适配现代 .NET 应用
类型安全：每个接口均有对应的强类型 Request / Response 类，IDE 自动补全友好
多语言文档：提供中文、English、Français、Español、Русский、العربية、日本語、한국어 八种语言文档

简体中文

和风天气 Sparrow.Qweather .NET SDK 使用说明

安装方式

dotnet add package Sparrow.Qweather

初始化

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"您的私钥证书";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // 证书路径
    var options = new WebApiOptions()
    {
        Host     = "您的API Host",
        Kid      = "您的项目ID",
        Sub      = "您的凭据ID",
        CertPath = certPath           // 证书路径
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

使用示例

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // 实时天气查询

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

SDK 方法与和风天气 API 对应列表

地理位置 GeoAPI

SDK 方法	Request 类	Response 类	和风天气文档
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	城市查询
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	热门城市
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	POI 搜索
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI 范围搜索

天气预报

SDK 方法	Request 类	Response 类	和风天气文档
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	实时天气
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	每日天气预报（3d/7d/10d/15d/30d）
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	逐小时天气预报（3h/6h/12h/24h）
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	格点实时天气
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	格点每日天气预报（3d/7d）
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	格点逐小时天气预报（24h/72h）

分钟级预报

SDK 方法	Request 类	Response 类	和风天气文档
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	分钟级降水

天气预警

SDK 方法	Request 类	Response 类	和风天气文档
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	实时天气预警

天气指数

SDK 方法	Request 类	Response 类	和风天气文档
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	天气指数预报

空气质量

SDK 方法	Request 类	Response 类	和风天气文档
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	实时空气质量
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	空气质量小时预报

时光机（历史数据）

SDK 方法	Request 类	Response 类	和风天气文档
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	天气时光机
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	空气质量时光机

热带气旋（台风）

SDK 方法	Request 类	Response 类	和风天气文档
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	台风预报
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	台风实况和路径
`StormListAsync`	`StormListRequest`	`StormListResponse`	台风列表

海洋数据

SDK 方法	Request 类	Response 类	和风天气文档
`TideAsync`	`TideRequest`	`TideResponse`	潮汐

太阳辐射

SDK 方法	Request 类	Response 类	和风天气文档
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	太阳辐射预报

天文

SDK 方法	Request 类	Response 类	和风天气文档
`SunAsync`	`SunRequest`	`SunResponse`	日出日落
`MoonAsync`	`MoonRequest`	`MoonResponse`	月升月落和月相
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	太阳高度角

控制台

SDK 方法	Request 类	Response 类	和风天气文档
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	财务汇总
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	请求量统计

English

QWeather Sparrow.Qweather .NET SDK Documentation

Installation

dotnet add package Sparrow.Qweather

Initialization

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"your_private_key_certificate";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // certificate path
    var options = new WebApiOptions()
    {
        Host     = "your_API_Host",
        Kid      = "your_project_ID",
        Sub      = "your_credential_ID",
        CertPath = certPath           // certificate path
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

Usage Example

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // Real-time weather query

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

SDK Method to QWeather API Mapping

Geo API

SDK Method	Request Class	Response Class	QWeather Docs
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	City Lookup
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	Top City
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	POI Lookup
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI Range

Weather Forecast

SDK Method	Request Class	Response Class	QWeather Docs
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	Weather Now
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	Daily Forecast (3d/7d/10d/15d/30d)
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	Hourly Forecast (3h/6h/12h/24h)
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	Grid Weather Now
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	Grid Daily Forecast (3d/7d)
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	Grid Hourly Forecast (24h/72h)

Minutely Forecast

SDK Method	Request Class	Response Class	QWeather Docs
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	Minutely Precipitation

Weather Warning

SDK Method	Request Class	Response Class	QWeather Docs
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	Weather Alert

Weather Indices

SDK Method	Request Class	Response Class	QWeather Docs
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	Indices Forecast

Air Quality

SDK Method	Request Class	Response Class	QWeather Docs
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	Air Current
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	Air Hourly Forecast

Time Machine (Historical Data)

SDK Method	Request Class	Response Class	QWeather Docs
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	Historical Weather
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	Historical Air

Tropical Cyclone (Typhoon)

SDK Method	Request Class	Response Class	QWeather Docs
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	Storm Forecast
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	Storm Track
`StormListAsync`	`StormListRequest`	`StormListResponse`	Storm List

Ocean Data

SDK Method	Request Class	Response Class	QWeather Docs
`TideAsync`	`TideRequest`	`TideResponse`	Tide

Solar Radiation

SDK Method	Request Class	Response Class	QWeather Docs
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	Solar Radiation Forecast

Astronomy

SDK Method	Request Class	Response Class	QWeather Docs
`SunAsync`	`SunRequest`	`SunResponse`	Sunrise & Sunset
`MoonAsync`	`MoonRequest`	`MoonResponse`	Moon & Moon Phase
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	Solar Elevation Angle

Console

SDK Method	Request Class	Response Class	QWeather Docs
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	Finance Summary
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	Metrics Stats

Français

Documentation du SDK .NET QWeather Sparrow.Qweather

Installation

dotnet add package Sparrow.Qweather

Initialisation

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"votre_certificat_clé_privée";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // chemin du certificat
    var options = new WebApiOptions()
    {
        Host     = "votre_hôte_API",
        Kid      = "votre_ID_projet",
        Sub      = "votre_ID_credential",
        CertPath = certPath           // chemin du certificat
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

Exemple d’utilisation

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // Requête météo en temps réel

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

Correspondance méthodes SDK / API QWeather

API Géographique (GeoAPI)

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	Recherche de ville
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	Villes populaires
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	Recherche POI
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI dans un rayon

Prévisions météo

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	Météo en temps réel
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	Prévisions journalières (3d/7d/10d/15d/30d)
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	Prévisions horaires (3h/6h/12h/24h)
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	Météo grille temps réel
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	Prévisions grille journalières (3d/7d)
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	Prévisions grille horaires (24h/72h)

Prévisions à la minute

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	Précipitations par minute

Alertes météo

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	Alerte météo

Indices météo

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	Prévisions d’indices

Qualité de l’air

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	Qualité de l’air actuelle
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	Prévisions horaires qualité air

Machine à remonter le temps (données historiques)

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	Météo historique
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	Qualité de l’air historique

Cyclone tropical (Typhon)

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	Prévision typhon
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	Trajectoire typhon
`StormListAsync`	`StormListRequest`	`StormListResponse`	Liste des typhons

Données océaniques

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`TideAsync`	`TideRequest`	`TideResponse`	Marée

Rayonnement solaire

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	Prévisions rayonnement solaire

Astronomie

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`SunAsync`	`SunRequest`	`SunResponse`	Lever/Coucher du soleil
`MoonAsync`	`MoonRequest`	`MoonResponse`	Lune et phase lunaire
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	Angle d’élévation solaire

Console

Méthode SDK	Classe Request	Classe Response	Documentation QWeather
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	Résumé financier
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	Statistiques de requêtes

Español

Documentación del SDK .NET QWeather Sparrow.Qweather

Instalación

dotnet add package Sparrow.Qweather

Inicialización

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"su_certificado_clave_privada";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // ruta del certificado
    var options = new WebApiOptions()
    {
        Host     = "su_Host_API",
        Kid      = "su_ID_proyecto",
        Sub      = "su_ID_credencial",
        CertPath = certPath           // ruta del certificado
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

Ejemplo de uso

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // Consulta del tiempo en tiempo real

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

Correspondencia entre métodos SDK y API QWeather

API Geográfica (GeoAPI)

Método SDK	Clase Request	Clase Response	Documentación QWeather
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	Búsqueda de ciudad
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	Ciudades populares
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	Búsqueda POI
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI en radio

Pronóstico del tiempo

Método SDK	Clase Request	Clase Response	Documentación QWeather
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	Tiempo actual
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	Pronóstico diario (3d/7d/10d/15d/30d)
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	Pronóstico por horas (3h/6h/12h/24h)
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	Tiempo de cuadrícula actual
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	Pronóstico cuadrícula diario (3d/7d)
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	Pronóstico cuadrícula por horas (24h/72h)

Pronóstico por minutos

Método SDK	Clase Request	Clase Response	Documentación QWeather
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	Precipitación por minutos

Alertas meteorológicas

Método SDK	Clase Request	Clase Response	Documentación QWeather
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	Alerta meteorológica

Índices meteorológicos

Método SDK	Clase Request	Clase Response	Documentación QWeather
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	Pronóstico de índices

Calidad del aire

Método SDK	Clase Request	Clase Response	Documentación QWeather
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	Calidad del aire actual
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	Pronóstico horario calidad aire

Máquina del tiempo (datos históricos)

Método SDK	Clase Request	Clase Response	Documentación QWeather
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	Tiempo histórico
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	Calidad del aire histórica

Ciclón tropical (Tifón)

Método SDK	Clase Request	Clase Response	Documentación QWeather
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	Pronóstico de tifón
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	Trayectoria del tifón
`StormListAsync`	`StormListRequest`	`StormListResponse`	Lista de tifones

Datos oceánicos

Método SDK	Clase Request	Clase Response	Documentación QWeather
`TideAsync`	`TideRequest`	`TideResponse`	Marea

Radiación solar

Método SDK	Clase Request	Clase Response	Documentación QWeather
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	Pronóstico radiación solar

Astronomía

Método SDK	Clase Request	Clase Response	Documentación QWeather
`SunAsync`	`SunRequest`	`SunResponse`	Amanecer y atardecer
`MoonAsync`	`MoonRequest`	`MoonResponse`	Luna y fase lunar
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	Ángulo de elevación solar

Consola

Método SDK	Clase Request	Clase Response	Documentación QWeather
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	Resumen financiero
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	Estadísticas de solicitudes

Русский

Документация SDK .NET QWeather Sparrow.Qweather

Установка

dotnet add package Sparrow.Qweather

Инициализация

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"ваш_сертификат_закрытого_ключа";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // путь к сертификату
    var options = new WebApiOptions()
    {
        Host     = "ваш_API_хост",
        Kid      = "ваш_ID_проекта",
        Sub      = "ваш_ID_учётных_данных",
        CertPath = certPath           // путь к сертификату
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

Пример использования

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // Запрос погоды в реальном времени

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

Таблица соответствия методов SDK и API QWeather

Геолокационный API (GeoAPI)

Метод SDK	Класс Request	Класс Response	Документация QWeather
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	Поиск города
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	Популярные города
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	Поиск POI
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI в радиусе

Прогноз погоды

Метод SDK	Класс Request	Класс Response	Документация QWeather
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	Текущая погода
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	Ежедневный прогноз (3d/7d/10d/15d/30d)
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	Почасовой прогноз (3h/6h/12h/24h)
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	Текущая погода сетки
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	Ежедневный прогноз сетки (3d/7d)
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	Почасовой прогноз сетки (24h/72h)

Поминутный прогноз

Метод SDK	Класс Request	Класс Response	Документация QWeather
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	Поминутные осадки

Погодные предупреждения

Метод SDK	Класс Request	Класс Response	Документация QWeather
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	Погодное предупреждение

Погодные индексы

Метод SDK	Класс Request	Класс Response	Документация QWeather
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	Прогноз индексов

Качество воздуха

Метод SDK	Класс Request	Класс Response	Документация QWeather
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	Текущее качество воздуха
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	Почасовой прогноз качества воздуха

Машина времени (исторические данные)

Метод SDK	Класс Request	Класс Response	Документация QWeather
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	Историческая погода
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	Историческое качество воздуха

Тропический циклон (Тайфун)

Метод SDK	Класс Request	Класс Response	Документация QWeather
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	Прогноз тайфуна
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	Траектория тайфуна
`StormListAsync`	`StormListRequest`	`StormListResponse`	Список тайфунов

Океанические данные

Метод SDK	Класс Request	Класс Response	Документация QWeather
`TideAsync`	`TideRequest`	`TideResponse`	Приливы

Солнечная радиация

Метод SDK	Класс Request	Класс Response	Документация QWeather
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	Прогноз солнечной радиации

Астрономия

Метод SDK	Класс Request	Класс Response	Документация QWeather
`SunAsync`	`SunRequest`	`SunResponse`	Восход и закат
`MoonAsync`	`MoonRequest`	`MoonResponse`	Луна и фазы луны
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	Угол высоты солнца

Консоль

Метод SDK	Класс Request	Класс Response	Документация QWeather
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	Финансовая сводка
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	Статистика запросов

العربية

توثيق SDK ‏.NET الخاص بـ QWeather Sparrow.Qweather

التثبيت

dotnet add package Sparrow.Qweather

التهيئة

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"شهادة_مفتاحك_الخاص";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // مسار الشهادة
    var options = new WebApiOptions()
    {
        Host     = "مضيف_API_الخاص_بك",
        Kid      = "معرّف_مشروعك",
        Sub      = "معرّف_بيانات_اعتمادك",
        CertPath = certPath           // مسار الشهادة
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

مثال على الاستخدام

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // استعلام الطقس الفوري

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

جدول تطابق أساليب SDK مع واجهات برمجة تطبيقات QWeather

واجهة الموقع الجغرافي (GeoAPI)

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	البحث عن مدينة
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	المدن الأكثر شعبية
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	البحث عن نقطة اهتمام
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	نقاط الاهتمام في نطاق

توقعات الطقس

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	الطقس الآن
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	التوقعات اليومية (3d/7d/10d/15d/30d)
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	التوقعات بالساعة (3h/6h/12h/24h)
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	طقس الشبكة الآن
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	التوقعات اليومية للشبكة (3d/7d)
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	التوقعات بالساعة للشبكة (24h/72h)

توقعات دقيقة بدقيقة

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	هطول الأمطار بالدقيقة

تحذيرات الطقس

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	تنبيه الطقس

مؤشرات الطقس

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	توقعات المؤشرات

جودة الهواء

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	جودة الهواء الحالية
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	توقعات جودة الهواء بالساعة

آلة الزمن (البيانات التاريخية)

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	الطقس التاريخي
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	جودة الهواء التاريخية

الإعصار المداري (التايفون)

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	توقع الإعصار
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	مسار الإعصار
`StormListAsync`	`StormListRequest`	`StormListResponse`	قائمة الأعاصير

بيانات المحيط

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`TideAsync`	`TideRequest`	`TideResponse`	المد والجزر

الإشعاع الشمسي

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	توقعات الإشعاع الشمسي

علم الفلك

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`SunAsync`	`SunRequest`	`SunResponse`	شروق وغروب الشمس
`MoonAsync`	`MoonRequest`	`MoonResponse`	القمر وأطواره
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	زاوية ارتفاع الشمس

لوحة التحكم

أسلوب SDK	فئة Request	فئة Response	توثيق QWeather
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	الملخص المالي
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	إحصاءات الطلبات

日本語

QWeather Sparrow.Qweather .NET SDK ドキュメント

インストール

dotnet add package Sparrow.Qweather

初期化

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"あなたの秘密鍵証明書";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // 証明書パス
    var options = new WebApiOptions()
    {
        Host     = "あなたのAPI Host",
        Kid      = "あなたのプロジェクトID",
        Sub      = "あなたのクレデンシャルID",
        CertPath = certPath           // 証明書パス
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

使用例

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // リアルタイム天気クエリ

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

SDK メソッドと QWeather API の対応表

地理位置情報 GeoAPI

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	都市検索
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	人気都市
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	POI 検索
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI 範囲検索

天気予報

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	現在の天気
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	日別予報（3d/7d/10d/15d/30d）
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	時間別予報（3h/6h/12h/24h）
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	グリッド現在天気
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	グリッド日別予報（3d/7d）
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	グリッド時間別予報（24h/72h）

分単位予報

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	分単位降水

気象警報

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	気象警報

気象指数

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	指数予報

大気質

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	現在の大気質
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	時間別大気質予報

タイムマシン（履歴データ）

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	過去の天気
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	過去の大気質

熱帯低気圧（台風）

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	台風予報
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	台風経路
`StormListAsync`	`StormListRequest`	`StormListResponse`	台風リスト

海洋データ

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`TideAsync`	`TideRequest`	`TideResponse`	潮汐

太陽放射

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	太陽放射予報

天文

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`SunAsync`	`SunRequest`	`SunResponse`	日の出・日の入り
`MoonAsync`	`MoonRequest`	`MoonResponse`	月の出・月の入り・月相
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	太陽高度角

コンソール

SDK メソッド	Request クラス	Response クラス	QWeather ドキュメント
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	財務概要
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	リクエスト統計

한국어

QWeather Sparrow.Qweather .NET SDK 문서

설치

dotnet add package Sparrow.Qweather

초기화

public static WebApiClient WebApiClient()
{
    string folderPath = @"cert";
    string relativeFilePath = @"개인키_인증서";

    string certPath = Path.GetFullPath(Path.Combine(folderPath, relativeFilePath)); // 인증서 경로
    var options = new WebApiOptions()
    {
        Host     = "API Host",
        Kid      = "프로젝트 ID",
        Sub      = "자격증명 ID",
        CertPath = certPath           // 인증서 경로
    };

    var client = WebApiClientBuilder.Create(options).Build();
    return client;
}

사용 예제

using Sparrow.Qweather.Client;
using Sparrow.Qweather.Example;
using Sparrow.Qweather.Tools;

var request =
    new Sparrow.Qweather.Models.Request.Weather.WeatherNowRequest
    {
        Location = "101010100",
    }; // 실시간 날씨 조회

var response = await WebApiClientSetting.WebApiClient().WeatherNowAsync(request);
var json = JsonTool.SerializeWithNullFilter(response);
Console.WriteLine(json);

SDK 메서드와 QWeather API 대응 목록

지리 위치 GeoAPI

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`CityLookUpAsync`	`CityLookUpRequest`	`CityLookUpResponse`	도시 검색
`CityTopAsync`	`CityTopRequest`	`CityTopResponse`	인기 도시
`PoiLookUpAsync`	`PoiLookUpRequest`	`PoiLookUpResponse`	POI 검색
`PoiRangeAsync`	`PoiRangeRequest`	`PoiRangeReponse`	POI 범위 검색

날씨 예보

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`WeatherNowAsync`	`WeatherNowRequest`	`WeatherNowResponse`	현재 날씨
`WeatherDaysAsync`	`WeatherDaysRequest`	`WeatherDaysResponse`	일별 예보（3d/7d/10d/15d/30d）
`WeatherHoursAsync`	`WeatherHoursRequest`	`WeatherHoursResponse`	시간별 예보（3h/6h/12h/24h）
`GridWeatherNowAsync`	`GridWeatherNowRequest`	`GridWeatherNowResponse`	격자 현재 날씨
`GridWeatherDaysAsync`	`GridWeatherDaysRequest`	`GridWeatherDaysResponse`	격자 일별 예보（3d/7d）
`GridWeatherHoursAsync`	`GridWeatherHoursRequest`	`GridWeatherHoursResponse`	격자 시간별 예보（24h/72h）

분 단위 예보

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`Minutely5mAsync`	`Minutely5mRequset`	`Minutely5mResponse`	분 단위 강수

기상 경보

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`WeatheralertCurrentAsync`	`WeatheralertCurrentRequest`	`WeatheralertCurrentResponse`	기상 경보

날씨 지수

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`IndicesForecastAsync`	`IndicesForecastRequest`	`IndicesForecastResponse`	지수 예보

대기질

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`AirCurrentAsync`	`AirCurrentRequest`	`AirCurrentResponse`	현재 대기질
`AirHourlyForecastAsync`	`AirHourlyForecastRequest`	`AirHourlyForecastResponse`	시간별 대기질 예보

타임머신 (역사 데이터)

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`HistoricalWeatherAsync`	`HistoricalWeatherRequest`	`HistoricalWeatherResponse`	과거 날씨
`HistoricalAirAsync`	`HistoricalAirRequest`	`HistoricalAirResponse`	과거 대기질

열대성 저기압 (태풍)

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`StormForecastAsync`	`StormForecastRequest`	`StormForecastResponse`	태풍 예보
`StormTrackAsync`	`StormTrackRequest`	`StormTrackResponse`	태풍 경로
`StormListAsync`	`StormListRequest`	`StormListResponse`	태풍 목록

해양 데이터

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`TideAsync`	`TideRequest`	`TideResponse`	조석

태양 복사

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`SolarRadiationForecastAsync`	`SolarRadiationForecastRequest`	`SolarRadiationForecastResponse`	태양 복사 예보

천문

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`SunAsync`	`SunRequest`	`SunResponse`	일출·일몰
`MoonAsync`	`MoonRequest`	`MoonResponse`	월출·월몰 및 월상
`SolarElevationAngleAsync`	`SolarElevationAngleRequest`	`SolarElevationAngleResponse`	태양 고도각

콘솔

SDK 메서드	Request 클래스	Response 클래스	QWeather 문서
`FinanceSummaryAsync`	`FinanceSummaryRequest`	`FinanceSummaryResponse`	재무 요약
`MetricsStatsAsync`	`MetricsStatsRequest`	`MetricsStatsResponse`	요청량 통계