Sparrow.Qweather .NET SDK

---

Git库

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

语言 / Languages

• 简体中文
• 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	요청량 통계