yandex-geo

Simple library for getting address or coordinates via Yandex geocoder


Keywords
geocoder, httpx
License
MIT
Install
pip install yandex-geo==2.1.0

Documentation

Yandex Geocoder

Get address coordinates via Yandex geocoder

test Coverage Status Code style: black Python versions PyPi

Installation

Synchronous version:

Install it via pip tool:

pip install yandex-geo

or Poetry:

poetry add yandex-geo

Usage example

Yandex Geocoder requires an API developer key, you can get it here to use this library.

Synchronous version:

from decimal import Decimal

from yandex_geocoder import Client

client = Client("your-api-key")

coordinates = client.coordinates("Москва Льва Толстого 16")
assert coordinates == (Decimal("37.587093"), Decimal("55.733969"))

address = client.address(Decimal("37.587093"), Decimal("55.733969"))
assert address == "Россия, Москва, улица Льва Толстого, 16"

Asynchronous version:

import asyncio
from decimal import Decimal

from yandex_geocoder import Client


async def main():
    aclient = Client(api_key="your-api-key")

    coordinates = await aclient.aiocoordinates("Москва Льва Толстого 16")
    assert coordinates == (Decimal("37.587093"), Decimal("55.733974"))
    address = await aclient.aioaddress(Decimal("37.587093"), Decimal("55.733974"))
    assert address == "Россия, Москва, улица Льва Толстого, 16"


if __name__ == '__main__':
    asyncio.run(main())

Development and contribution

First of all you should install Poetry.

  • install project dependencies
just install
  • run linters
just lint
  • run tests
just test
  • feel free to contribute!