unickq / yandexgeocoder

.NET wrapper of YandexGeocoder - the Yandex API for converting geographical coordinates to an address and back.

Yandex Geocoder .NET wrapper

.NET API for converting geographical coordinates to an address and back.

Build:

Download (NuGet):

About:

Yandex Geocoder service can get the coordinates and other information about an object using its name or address, as well as the opposite, using the coordinates of an object to get its address (reverse geocoding).

For example, the geocoder receives the request “Türkiye, İstanbul, Kartal, Esentepe, Aydos Sokak, 32” and returns the geographical coordinates of this building: “29.198184 40.900640” (longitude, latitude). Conversely, if the request contains the geographical coordinates of the building “29.198184 40.900640”, the geocoder will return the address.

Note: Free version supports 25000 requests per day. Also not all countries supported - read geocoder documentation.

Example:

var geocoder = new YandexGeocoder {
    SearchQuery = "Kyiv, Ukraine, Maydan Nezalezhnosti",
    Results = 1,
    LanguageCode = LanguageCode.en_US
};
Console.WriteLine(geocoder.GetResults().First());

Output:

AddressLine: Kyiv, Nezalezhnosti Square
AdministrativeAreaName: Kyiv
CountryName: Ukraine
CountryCode: UA
Text: Ukraine, Kyiv, Nezalezhnosti Square
Kind: street
Name: Nezalezhnosti Square
Description: Kyiv, Ukraine
Point: 30.523846,50.450131
PointLowerCorner: 30.521681,50.448904
PointUpperCorner: 30.526056,50.451514

yandexgeocoder's Issues

Null reference exception when SearchQuery is "Зейский государственный природный заповедник"

Exception:

System.NullReferenceException : Object reference not set to an instance of an object.
   at Yandex.Geocoder.YandexResponse..ctor(GeoObject geoObject) in C:\src\YandexGeocoder\YandexGeocoder\src\YandexResponse.cs:line 34
   at Yandex.Geocoder.YandexGeocoder.<>c.<GetResultsAsync>b__26_0(FeatureMember geoObject) in C:\src\YandexGeocoder\YandexGeocoder\src\YandexGeocoder.cs:line 111
   at System.Linq.Enumerable.SelectListIterator`2.ToList()
   at System.Linq.Enumerable.ToList[TSource](IEnumerable`1 source)
   at Yandex.Geocoder.YandexGeocoder.GetResultsAsync() in C:\src\YandexGeocoder\YandexGeocoder\src\YandexGeocoder.cs:line 110
   at Yandex.Geocoder.Tests.BasicTests.NullReferenceOnCountryNullQuery() in C:\src\YandexGeocoder\YandexGeocoder.Tests\BasicTests.cs:line 26
   at NUnit.Framework.Internal.TaskAwaitAdapter.GenericAdapter`1.BlockUntilCompleted()
   at NUnit.Framework.Internal.MessagePumpStrategy.NoMessagePumpStrategy.WaitForCompletion(AwaitAdapter awaitable)
   at NUnit.Framework.Internal.AsyncToSyncAdapter.Await(Func`1 invoke)
   at NUnit.Framework.Internal.Commands.TestMethodCommand.RunTestMethod(TestExecutionContext context)
   at NUnit.Framework.Internal.Commands.TestMethodCommand.Execute(TestExecutionContext context)
   at NUnit.Framework.Internal.Execution.SimpleWorkItem.PerformWork()