From 2196a5ca479f29129e2e000a026209aa71ec0dc0 Mon Sep 17 00:00:00 2001 From: Sebastian Jensen Date: Tue, 22 Jul 2025 22:06:20 +0200 Subject: [PATCH 1/2] Update README with new API methods and improve formatting Expanded the README to document additional API methods for geolocation and air pollution data. Improved formatting for badges, links, and sample image. Updated the sample screenshot. --- README.md | 72 ++++++++++++++++++++++------ docs/openweathermapsharp-sample.png | Bin 34172 -> 79087 bytes 2 files changed, 57 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index ede7723..dc27b9d 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,12 @@ # OpenWeatherMapSharp -A .NET client wrapper for https://openweathermap.org written in .NET Standard 2.0 - +A .NET client wrapper for [https://openweathermap.org](https://openweathermap.org) written in .NET Standard 2.0 ## Installation Install the package via [NuGet](https://www.nuget.org/packages/OpenWeatherMapSharp). -![Nuget](https://img.shields.io/nuget/v/OpenWeatherMapSharp) - +[![Nuget](https://img.shields.io/nuget/v/OpenWeatherMapSharp)](https://www.nuget.org/packages/OpenWeatherMapSharp) ## Usage @@ -18,7 +16,8 @@ You need to create a new instance of `OpenWeatherMapService` passing in the *API ```csharp /// -/// Gets forecast for a location given its longitude and latitude +/// Gets forecast data for a location based +/// on its geographic coordinates. /// Task> GetForecastAsync( double latitude, @@ -27,7 +26,7 @@ Task> GetForecastAsync( Unit unit = Unit.Standard); /// -/// Gets forecast for a location given its city ID +/// Gets forecast data based on a city ID. /// [Obsolete] Task> GetForecastAsync( @@ -36,7 +35,7 @@ Task> GetForecastAsync( Unit unit = Unit.Standard); /// -/// Gets forecast for a location given its city name +/// Gets forecast data based on a city name. /// [Obsolete] Task> GetForecastAsync( @@ -45,7 +44,7 @@ Task> GetForecastAsync( Unit unit = Unit.Standard); /// -/// Gets weather information for a location given its longitude and latitude +/// Gets current weather data for a location based on its geographic coordinates. /// Task> GetWeatherAsync( double latitude, @@ -54,7 +53,7 @@ Task> GetWeatherAsync( Unit unit = Unit.Standard); /// -/// Gets weather information for a location given its city ID +/// Gets current weather data based on a city ID. /// [Obsolete] Task> GetWeatherAsync( @@ -63,31 +62,74 @@ Task> GetWeatherAsync( Unit unit = Unit.Standard); /// -/// Gets weather information for a location given its city name +/// Gets current weather data based on a city name. /// [Obsolete] Task> GetWeatherAsync( string city, LanguageCode language = LanguageCode.EN, Unit unit = Unit.Standard); + +/// +/// Gets a list of matching locations for a given query string. +/// +Task>> GetLocationByNameAsync( + string query, + int limit = 5); + +/// +/// Gets geolocation information based on a ZIP or postal code. +/// +Task> GetLocationByZipAsync( + string zipCode); + +/// +/// Gets a list of matching locations for a given pair of coordinates. +/// +Task>> GetLocationByLatLonAsync( + double latitude, + double longitude, + int limit = 5); + +/// +/// Retrieves current air pollution data for a specific location. +/// +Task> GetAirPolutionAsync( + double latitude, + double longitude); + +/// +/// Retrieves forecasted air pollution data for the coming days for a specific location. +/// +Task> GetAirPolutionForecastAsync( + double latitude, + double longitude); + +/// +/// Retrieves historical air pollution data for a specific location and time range. +/// +Task> GetAirPolutionHistoryAsync( + double latitude, + double longitude, + DateTime start, + DateTime end); ``` ***HINT:*** Some methods are marked as `obsolete`, because [openweathermap.org](https://openweathermap.org) marked these methods as depracted. Currently they are all still working, but might be removed in feature releases. They recommend using the methods with *latitude* and *longitude* to get the current weather or the forecast. - ## Sample Here is a screenshot of the `Console Application` using the [NuGet package](https://www.nuget.org/packages/OpenWeatherMapSharp) to get the current weather for a provided city. -![](./docs/openweathermapsharp-sample.png) +![Console Application](./docs/openweathermapsharp-sample.png) ## Buy Me A Coffee -I appreciate any form of support to keep my _Open Source_ activities going. +I appreciate any form of support to keep my *Open Source* activities going. Whatever you decide, be it reading and sharing my blog posts, using my NuGet packages or buying me a coffee/book, thank you ❤️. -Buy Me A Coffee +[![Buy Me A Coffee](https://cdn.buymeacoffee.com/buttons/default-yellow.png)](https://www.buymeacoffee.com/tsjdevapps) ## Contributing @@ -98,4 +140,4 @@ Please make sure to update tests as appropriate. ## License -[MIT](https://choosealicense.com/licenses/mit/) \ No newline at end of file +[MIT](https://choosealicense.com/licenses/mit/) diff --git a/docs/openweathermapsharp-sample.png b/docs/openweathermapsharp-sample.png index 16485ef52b32da46f05a92220ea8710892a24a00..646199a461a6a95f45f0f3e06d9fe42905928ad5 100644 GIT binary patch literal 79087 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

~ZAijKTl{u6vqT?{UQ_%3D3dG<`KzGVNO@u&yz zCQ#hs2a|Kk?YE4>_kl4zem^_x!KPqjW~4uJcoEV%&{|;nW3cnps7jBbTWKKYIX8XU z`u5|LyRG}j4&6>!EnT;MPb5vkYdfRwEJtIc~WG!X2H==<&qQ4xx{ zihijaKpPo)hefA6^G}BAaiVn}QVnlr0_oYbhpi76V7(P-*QTPurb?k|f!RNUEKs`W zv<)aOGo?-AuKOpC_m0zLuP<5Qh~g;)#!7db!l2%gW%&|rrWgM_1`w>~bdczJB3ks2|4~fP8H};C3bTPg| zc{g{sz!5GT5dl8xbF%M#wmz}cX+OE4=)1O#@+R)c;$8WDw~~Q$NS*U08g-XA(*P$q@zfNBK%G4R({5^hkk%Vw^q@PiKc4@|J?N*TtJ#zl%itQ6#OsjI7#`4m(Z z%K*AGD+}4E&b1BG5wcB-nJ@tc8Vnx$J9Vh)dSR==2&?E7(;Qb1j&zl70D!^&g{U3J z(Z%MWOCWmB+(J$e0LniTAZ}aj)Xw*7AGlV`6R{o?&}jK)+^1mH_1<~cnsTqXvGn6Z z2Ln^aH@*aQ_KZxM``&A^hfK)iZB|>5B}wgco&AiX+~lRt-`1SCr;SquOg77F7oXm% zKUz+czOO4=zTag5$r*t$e_)!$s0$%F;TiR@#jlrM9cwN`=in;z;NqfD*A= z<3YDJ+UELc+1n=LTi~8VyG2P!>Aaa?6WR{&hf1H{B`+U=^nInZ)Km5#Mo#WAt(>w< z|6dp;ck0@Ip@JD>+*KnZCzIs;WqSU&DhF#P{sR>(6ev?rfsR()=CXydO!HC;XC96} z_hAaP6c|kAn9y|g7-&!}R-@1=jXqW}r6DKy z-`+@d`51|I6)j3ha?@)c|p-& zwdKOed1vK2A*n(nOSjT4TrZdF?am5kxl%TcgLBf~FfUTHai6$_aqC~#-EF;prIo7w zTU4vwzeTmO{aaKk-T%XvS4#Y>)Ql5X-MRW76mp+a!_6#uZ3}m zJHJu3@w#COn8VY&ts!ER{T$`z#LIW@*6!xe&hDjPFkW6?;S;+#FpcvIUEJFsz$gs) z&QJYkfQ!R<{5|I}8AnT7o1CS3mat4uNEPChlw^hRUQ9qhV8_m#=dpn{2LF>=^5ZLV rUk~A9u&}Z|0v|&j^x5Z5MOan{T=|$zk4~qNfPd6gbyRYdk6rjL-D#DL literal 34172 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¬bEnNg5&Hj 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 From 329dacbbfc5e9de3cd54268405b25a3f735ff8a6 Mon Sep 17 00:00:00 2001 From: Sebastian Jensen Date: Tue, 22 Jul 2025 22:06:41 +0200 Subject: [PATCH 2/2] Add README and update project metadata for v4.0.0 Added README.md to the project and included it in the NuGet package. Updated OpenWeatherMapSharp.csproj to generate package on build, set version to 4.0.0, updated copyright year, and release notes to reflect new features including Air Pollution endpoints. --- .../OpenWeatherMapSharp.csproj | 18 +-- src/OpenWeatherMapSharp/README.md | 122 ++++++++++++++++++ 2 files changed, 132 insertions(+), 8 deletions(-) create mode 100644 src/OpenWeatherMapSharp/README.md diff --git a/src/OpenWeatherMapSharp/OpenWeatherMapSharp.csproj b/src/OpenWeatherMapSharp/OpenWeatherMapSharp.csproj index efbce50..d46ed69 100644 --- a/src/OpenWeatherMapSharp/OpenWeatherMapSharp.csproj +++ b/src/OpenWeatherMapSharp/OpenWeatherMapSharp.csproj @@ -2,32 +2,34 @@ netstandard2.0 - False + True OpenWeatherMapSharp - 3.1.4 + 4.0.0 Thomas Sebastian Jensen tsjdev-apps.de An unofficial .NET API wrapper for OpenWeatherMap.org - © Thomas Sebastian Jensen | 2017-2023 + © Thomas Sebastian Jensen | 2017-2025 https://github.com/tsjdev-apps/openweathermap-sharp https://github.com/tsjdev-apps/openweathermap-sharp MIT icon.png OpenWeatherMap; Api; Mock; Wrapper; free; Weather + - Add Air Pollution endpoints + - Update NuGet packages - Code improvements - - Add IconName to data model - - Add DateTime information to forcecast data model en + README.md - + + - + - + diff --git a/src/OpenWeatherMapSharp/README.md b/src/OpenWeatherMapSharp/README.md new file mode 100644 index 0000000..5cea81f --- /dev/null +++ b/src/OpenWeatherMapSharp/README.md @@ -0,0 +1,122 @@ +# OpenWeatherMapSharp + +A .NET client wrapper for [https://openweathermap.org](https://openweathermap.org) written in .NET Standard 2.0 + +## Installation + +Install the package via [NuGet](https://www.nuget.org/packages/OpenWeatherMapSharp). + +[![Nuget](https://img.shields.io/nuget/v/OpenWeatherMapSharp)](https://www.nuget.org/packages/OpenWeatherMapSharp) + +## Usage + +First you need to get a free API key from [openweathermap.org](https://www.openweathermap.org). You can create a new account and you will find your API keys on [your API keys page](https://home.openweathermap.org/api_keys). + +You need to create a new instance of `OpenWeatherMapService` passing in the *API key*. There is also an interface available, if you are using Dependency Injection. + +```csharp +///

+/// Gets forecast data for a location based +/// on its geographic coordinates. +/// +Task> GetForecastAsync( + double latitude, + double longitude, + LanguageCode language = LanguageCode.EN, + Unit unit = Unit.Standard); + +/// +/// Gets forecast data based on a city ID. +/// +[Obsolete] +Task> GetForecastAsync( + int cityId, + LanguageCode language = LanguageCode.EN, + Unit unit = Unit.Standard); + +/// +/// Gets forecast data based on a city name. +/// +[Obsolete] +Task> GetForecastAsync( + string city, + LanguageCode language = LanguageCode.EN, + Unit unit = Unit.Standard); + +/// +/// Gets current weather data for a location based on its geographic coordinates. +/// +Task> GetWeatherAsync( + double latitude, + double longitude, + LanguageCode language = LanguageCode.EN, + Unit unit = Unit.Standard); + +/// +/// Gets current weather data based on a city ID. +/// +[Obsolete] +Task> GetWeatherAsync( + int cityId, + LanguageCode language = LanguageCode.EN, + Unit unit = Unit.Standard); + +/// +/// Gets current weather data based on a city name. +/// +[Obsolete] +Task> GetWeatherAsync( + string city, + LanguageCode language = LanguageCode.EN, + Unit unit = Unit.Standard); + +/// +/// Gets a list of matching locations for a given query string. +/// +Task>> GetLocationByNameAsync( + string query, + int limit = 5); + +/// +/// Gets geolocation information based on a ZIP or postal code. +/// +Task> GetLocationByZipAsync( + string zipCode); + +/// +/// Gets a list of matching locations for a given pair of coordinates. +/// +Task>> GetLocationByLatLonAsync( + double latitude, + double longitude, + int limit = 5); + +/// +/// Retrieves current air pollution data for a specific location. +/// +Task> GetAirPolutionAsync( + double latitude, + double longitude); + +/// +/// Retrieves forecasted air pollution data for the coming days for a specific location. +/// +Task> GetAirPolutionForecastAsync( + double latitude, + double longitude); + +/// +/// Retrieves historical air pollution data for a specific location and time range. +/// +Task> GetAirPolutionHistoryAsync( + double latitude, + double longitude, + DateTime start, + DateTime end); +``` + +***HINT:*** Some methods are marked as `obsolete`, because [openweathermap.org](https://openweathermap.org) marked these methods as depracted. Currently they are all still working, but might be removed in feature releases. They recommend using the methods with *latitude* and *longitude* to get the current weather or the forecast. + +## License + +[MIT](https://choosealicense.com/licenses/mit/)