• 日期: 2026-04-28
  • 标签: 程序员

Sparrow.Qweather .NET SDK

Git库

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

语言 / Languages

简体中文

和风天气 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 요청량 통계

原文地址: https://www.cveoy.top/t/topic/qGxt 著作权归作者所有。请勿转载和采集!

免费AI点我,无需注册和登录