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 使用说明

安装方式

cmd 复制代码

dotnet add package Sparrow.Qweather

初始化

csharp 复制代码

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;
}

使用示例

csharp 复制代码

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

cmd 复制代码

dotnet add package Sparrow.Qweather

Initialization

csharp 复制代码

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

csharp 复制代码

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

cmd 复制代码

dotnet add package Sparrow.Qweather

Initialisation

csharp 复制代码

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

csharp 复制代码

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

cmd 复制代码

dotnet add package Sparrow.Qweather

Inicialización

csharp 复制代码

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

csharp 复制代码

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

Установка

cmd 复制代码

dotnet add package Sparrow.Qweather

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

csharp 复制代码

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;
}

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

csharp 复制代码

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

التثبيت

cmd 复制代码

dotnet add package Sparrow.Qweather

التهيئة

csharp 复制代码

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;
}

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

csharp 复制代码

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 ドキュメント

インストール

cmd 复制代码

dotnet add package Sparrow.Qweather

初期化

csharp 复制代码

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;
}

使用例

csharp 复制代码

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 문서

설치

cmd 复制代码

dotnet add package Sparrow.Qweather

초기화

csharp 复制代码

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;
}

사용 예제

csharp 复制代码

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`	요청량 통계

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

Sparrow.Qweather .NET SDK

Git库

语言 / Languages

简体中文

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

安装方式

初始化

使用示例

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

地理位置 GeoAPI

天气预报

分钟级预报

天气预警

天气指数

空气质量

时光机（历史数据）

热带气旋（台风）

海洋数据

太阳辐射

天文

控制台

English

QWeather Sparrow.Qweather .NET SDK Documentation

Installation

Initialization

Usage Example

SDK Method to QWeather API Mapping

Geo API

Weather Forecast

Minutely Forecast

Weather Warning

Weather Indices

Air Quality

Time Machine (Historical Data)

Tropical Cyclone (Typhoon)

Ocean Data

Solar Radiation

Astronomy

Console

Français

Documentation du SDK .NET QWeather Sparrow.Qweather

Installation

Initialisation

Exemple d'utilisation

Correspondance méthodes SDK / API QWeather

API Géographique (GeoAPI)

Prévisions météo

Prévisions à la minute

Alertes météo

Indices météo

Qualité de l'air

Machine à remonter le temps (données historiques)

Cyclone tropical (Typhon)

Données océaniques

Rayonnement solaire

Astronomie

Console

Español

Documentación del SDK .NET QWeather Sparrow.Qweather

Instalación

Inicialización

Ejemplo de uso

Correspondencia entre métodos SDK y API QWeather

API Geográfica (GeoAPI)

Pronóstico del tiempo

Pronóstico por minutos

Alertas meteorológicas

Índices meteorológicos

Calidad del aire

Máquina del tiempo (datos históricos)

Ciclón tropical (Tifón)

Datos oceánicos

Radiación solar

Astronomía

Consola

Русский

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

Установка

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