ViaCep 4.1.79
See the version list below for details.
dotnet add package ViaCep --version 4.1.79
NuGet\Install-Package ViaCep -Version 4.1.79
<PackageReference Include="ViaCep" Version="4.1.79" />
paket add ViaCep --version 4.1.79
#r "nuget: ViaCep, 4.1.79"
// Install ViaCep as a Cake Addin
#addin nuget:?package=ViaCep&version=4.1.79
// Install ViaCep as a Cake Tool
#tool nuget:?package=ViaCep&version=4.1.79
ViaCEP
A .NET client wrapper for both .NET Core & .NET Framework projects of Via CEP API
CI/CD
Build status | Last commit | Tests | Coverage | Code Smells | LOC |
---|---|---|---|---|---|
Code Quality
Installation
Github Releases
Download the latest zip file from the Release page.
Nuget package manager
Package | Version | Downloads |
---|---|---|
ViaCEP |
Usage
The package has two classes:
- ViaCepClient: The main class (methods).
- ViaCepResult: The result class (data).
This package is fully compatible with Dependency Injection. Use the interface IViaCepClient and the constructor with HttpClient parameter with a IHttpClientFactory instance.
//your DI container
services.AddHttpClient<IViaCepClient, ViaCepClient>(client => { client.BaseAddress = new Uri("https://viacep.com.br/"); });
//then use in your domain service, handler, controller...
var viaCepClient = container.GetService<IViaCepClient>();
var result = await viaCepClient.SearchAsync("01001000", cancellationToken);
You can search using the zip code/postal code (AKA CEP) or using the address data (state initials - UF, city name and location name - street, avenue, park, square). Both methods support async and sync!
Querying by zip code / postal code (single result)
var result = new ViaCepClient().Search("01001000"); //searches for the postal code 01001-000
var address = result.Address; //Praça da Sé
var city = reuslt.City; //São Paulo
//do what you need with 'result' instance of ViaCEPResult.
Querying by address (list result)
var results = new ViaCepClient().Search("SP", "São Paulo", "Avenida Paulista"); //search for the Avenida Paulista in São Paulo / SP
foreach(var result in results){
var address = result.Address;
var neighborhood = result.Neighborhood;
var zipCode = result.ZipCode;
//do what you need with 'result' instance of ViaCEPResult.
}
Changelog
- 2023-03-03: Update dependencies, change branch name, update logo. @guibranco
- 2021-06-21: Update dependencies version. @guibranco
- 2020-10-23: Add support to .NET Standard 2.0 and .NET Framework v4.6.1 and above. @guibranco
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Microsoft.AspNet.WebApi.Client (>= 5.2.9)
- Newtonsoft.Json (>= 13.0.3)
-
.NETStandard 2.1
- Microsoft.AspNet.WebApi.Client (>= 5.2.9)
- Newtonsoft.Json (>= 13.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
4.1.123 | 35 | 5/24/2023 |
4.1.120 | 31 | 5/24/2023 |
4.1.115 | 32 | 5/24/2023 |
4.1.104 | 68 | 5/4/2023 |
4.1.101 | 65 | 5/3/2023 |
4.1.96 | 132 | 4/9/2023 |
4.1.92 | 103 | 4/4/2023 |
4.1.87 | 134 | 3/25/2023 |
4.1.79 | 120 | 3/23/2023 |
4.1.76 | 187 | 3/3/2023 |
4.1.73 | 136 | 3/3/2023 |
4.1.57 | 138 | 3/3/2023 |
4.1.54 | 240 | 1/24/2023 |
4.1.53 | 215 | 1/15/2023 |
4.1.48 | 183 | 1/15/2023 |
4.1.45 | 187 | 1/14/2023 |
4.1.40 | 195 | 1/14/2023 |
3.2.35 | 182 | 1/14/2023 |
3.2.32 | 201 | 12/25/2022 |
3.2.27 | 193 | 12/25/2022 |
3.2.19 | 8,699 | 6/21/2021 |
3.1.5 | 5,899 | 10/23/2020 |
3.0.40 | 2,607 | 4/18/2020 |
3.0.38 | 1,055 | 4/7/2020 |
3.0.30 | 386 | 3/30/2020 |
3.0.23 | 398 | 3/29/2020 |
3.0.15 | 403 | 3/29/2020 |
3.0.12 | 414 | 3/29/2020 |
3.0.9 | 503 | 3/28/2020 |
2.0.93 | 1,323 | 3/28/2020 |
2.0.92 | 444 | 3/28/2020 |
2.0.89 | 433 | 3/28/2020 |
2.0.88 | 423 | 3/28/2020 |
2.0.80 | 435 | 3/28/2020 |
2.0.64 | 5,367 | 12/30/2019 |
2.0.61 | 8,499 | 12/3/2019 |
2.0.58 | 1,177 | 9/22/2019 |
2.0.48 | 2,389 | 2/15/2019 |
2.0.47 | 549 | 2/15/2019 |
1.0.0 | 545 | 2/15/2019 |