Yandex.Geocoding 1.0.0

Geocoding.Yandex

Geocoding.net library extension for working with Yandex geocoder. Yandex geocoder works well with the geography of Russia, Ukraine, Belarus, Turkey and other close countries.

The API returns latitude/longitude coordinates and normalized address information. This can be used to perform address validation, real time mapping of user-entered addresses, distance calculations, and much more.

Get the API key here

Installing

PM> Install-Package Yandex.Geocoding

Avaliable on NuGet

Usage Example

Simple Example

IGeocoder geocoder = new YandexGeocoder("yandex-api-key");
IEnumerable<Address> addresses = await geocoder.GeocodeAsync("Tverskaya 4");
Console.WriteLine("Formatted: " + addresses.First().FormattedAddress); //Formatted: Россия, Москва, Тверская улица, 4
Console.WriteLine("Coordinates: " + addresses.First().Coordinates.Latitude + ", " + addresses.First().Coordinates.Longitude); //Coordinates: 55,758493, 37,613198

It can also be used to return address information from latitude/longitude coordinates (aka reverse geocoding):

IGeocoder geocoder = new YandexGeocoder("yandex-api-key");
IEnumerable<Address> addresses = await geocoder.ReverseGeocodeAsync(38.8976777, -77.036517);

Using Yandex Provider Specific Data

Find address by known city

YandexGeocoder geocoder = new YandexGeocoder(ApiKey);
IEnumerable<YandexAddress> addresses = await geocoder.GeocodeAsync("Tverskaya 4");
var moscowAddress = addresses.First(address=>address.City == "Moscow");
Console.WriteLine($"Country: {moscowAddress.Country}, City: {moscowAddress.City}, Postal Code: {moscowAddress.PostCode}");

Specify response language

var geocoder = new YandexGeocoder(ApiKey)
{
  Language = Language.Turkish
};

Available languages: Russian, Belarusian, Ukrainian, Turkish, English

Specify toponym (Only for reverse geocoding)

geocoder.Kind = Kind.Metro;

Possible values: House, Street, Metro, District, Locality

Specify search boundaries

Ignored when Kind is set to District

geocoder.Bounds = new Bounds(55.542312, 37.253144, 55.933075, 37.861323);

Specify the number of addresses in response

geocoder.Results = 30;

By default - 10

Specify the number of skipped addresses

geocoder.Skip = 4;

License

This project is licensed under the MIT License - see the LICENSE file for details