| Name | ymaps JSON |
| Version |
1.3
JSON |
| download |
| home_page | |
| Summary | Client for Yandex Maps API |
| upload_time | 2023-10-31 15:22:41 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.7 |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# ymaps
---------
[![PyPI Version][pypi-image]][pypi-url]
![GitHub][license]
**`ymaps`** - это клиент для [API Яндекс Карт](https://yandex.ru/dev/maps/mapsapi/) (Неофициальный)
Синхронные и Асинхронные:
* Search, SearchAsync - [Поиск по организациям](https://yandex.ru/dev/maps/geosearch/?from=mapsapi)
* Geocode, GeocodeAsync - [Геокодер](https://yandex.ru/dev/maps/geocoder/?from=mapsapi)
* Suggest, SuggestAsync - [Геосаджест](https://yandex.ru/dev/maps/geosuggest/)
* Static, StaticAsync - [Static API](https://yandex.ru/dev/maps/staticapi/?from=mapsapi)
---------
## Установка
```
pip install ymaps
```
Зависимости
* python 3.7+
* [httpx](https://pypi.org/project/httpx/)
---------
## Использование
> Геокоординаты задаются в порядке долгота и широта
> \* - обязательный аргумент
> Все необязяательные аргументы должны передаваться по имени
### Параметры клиентов:
- api_key*, [получить ключ](https://developer.tech.yandex.ru/)
- language, язык ответа, по умолчанию русский (ru_RU)
- timeout, таймаут запроса, по умолчанию 1 секунда
#### Примеры:
```
# api_key = 'api_key', language = 'en_RU', timeout = 10
Search('api_key', 'en_RU', 10)
# api_key = 'api_key', language = 'ru_RU', timeout = 1
Geocode('api_key')
# api_key = 'api_key', language = 'tr_TR', timeout = 1
Suggest('api_key').suggest(text, lang='tr_TR')
```
### [Search](https://yandex.ru/dev/geosearch/doc/ru/request)
Поиска по организациям и географическим объектам (топонимы).
#### search()
Выполняет поиск по организациям или топонимам, [формат ответа](https://yandex.ru/dev/geosearch/doc/ru/response).
- __text*__- текст поискового запроса
- __lang__ - язык ответа, по умолчанию ru_RU
- __type__ - типы возвращаемых результатов. geo — топонимы, biz — организации, по умолчанию автоматическое определение типа по тексту запроса
- __ll__ - центр области поиска
- __spn__ - размеры области поиска
- __bbox__ - альтернативный способ задания области поиска, при одновременном задании bbox и ll+spn параметр bbox является более приоритетным. Границы области поиска задаются в виде географических координат левого нижнего и правого верхнего углов области.
- __rspn__ - признак «жесткого» ограничения области поиска, по умолчанию False (не ограничивать)
- __results__ - количество возвращаемых объектов, по умолчанию 10
- __skip__ - количество объектов в ответе (начиная с первого), которое необходимо пропустить, skip должно нацело делиться на results
- __uri__ - Дополнительная информация об объекте, значение параметра возвращается в ответе Геосаджеста.
#### Примеры:
```
client = Search('api_key')
# text
client.search('лебединое озеро')
client.search('55.750788,37.618534')
client.search('Санкт-Петербург, ул. Блохина, 15')
client.search('+7 495 739-70-70')
client.search('ООО Яндекс')
# lang
client.search('ООО Яндекс', lang='ru_RU')
client.search('Санкт-Петербург, ул. Блохина, 15', lang='be_BY')
# type
client.search('ООО Яндекс', lang='ru_RU', type='biz')
client.search('лебединое озеро', type='geo')
# ll, spn (используются совместно)
client.search('площадь Революции', ll=[37.618920, 55.756994], spn=[0.552069, 0.400552])
# bbox
client.search('Театр', bbox=[36.83, 55.67, 38.24, 55.91])
# rspn, не искать за пределами заданной области
client.search('Театр', rspn=True, bbox=[36.83, 55.67, 38.24, 55.91])
# results
client.search('Администрация', results=25)
# skip
client.search('Администрация', results=25, skip=25)
# asynchronous
client = SearchAsync('api_key')
await client.search('ООО Яндекс', lang='ru_RU')
```
### [Geocode](https://yandex.ru/dev/geocode/doc/ru/request)
Прямое и обратное геокодирование.
#### geocode()
Преобразует адрес в координаты объекта, [формат ответа](https://yandex.ru/dev/geocode/doc/ru/response).
- __geocode*__ - текст поискового запроса
- __ll__ - центр области поиска
- __spn__ - размеры области поиска
- __bbox__ - альтернативный способ задания области поиска, при одновременном задании bbox и ll+spn параметр bbox является более приоритетным. Границы области поиска задаются в виде географических координат левого нижнего и правого верхнего углов области.
- __format__ - формат ответа геокодера xml, json; json по умолчанию
- __rspn__ - признак «жесткого» ограничения области поиска, по умолчанию False (не ограничивать)
- __results__ - количество возвращаемых объектов, по умолчанию 10
- __skip__ - количество объектов в ответе (начиная с первого), которое необходимо пропустить, skip должно нацело делиться на results
- __lang__ - язык ответа, по умолчанию ru_RU
- __uri__ - Дополнительная информация об объекте, значение параметра возвращается в ответе Геосаджеста.
#### reverse()
Преобразует координаты в адрес объекта. Принимает те же аргументы что и geocode(), а также:
* __geocode*__ - географические координаты объекта
* __sco__ - порядок записи координат, longlat — долгота, широта, latlong — широта, долгота, по умолчанию longlat
* __kind__ - вид необходимого топонима (house, street, metro, district, locality), по умолчанию подбирается автоматически
#### Примеры:
```
client = Geocode('api_key')
# geocode
client.geocode('Санкт-Петербург, ул. Блохина, 15')
#reverse
client.reverse([37.611347, 55.760241])
# format, kind
client.reverse([37.611347, 55.760241], format='xml', kind='street')
# sco
client.reverse([55.760241, 37.611347], sco='latlong')
# ll, spn (используются совместно)
client.geocode('Санкт-Петербург, ул. Блохина, 15', ll=[30.301324, 59.951921], spn=[0.552069, 0.400552])
# bbox
client.geocode('Санкт-Петербург, ул. Блохина, 15', bbox=[36.83, 55.67, 38.24, 55.91])
# asynchronous
client = GeocodeAsync('api_key')
await client.geocode('Санкт-Петербург, ул. Блохина, 15')
```
### [Suggest](https://yandex.ru/dev/geosuggest/doc/ru/request)
Позволяет получать предложения поисковой выдачи во время поиска географических объектов и/или организаций.
#### suggest()
Выполняет поиск географических объектов и/или организаций, [формат ответа](https://yandex.ru/dev/geosuggest/doc/ru/response).
- __text*__- текст поискового запроса
- __lang__ - язык ответа в формате [ISO 639-1](https://www.loc.gov/standards/iso639-2/php/code_list.php), по умолчанию ru
- __results__ - количество возвращаемых объектов, по умолчанию 10
- __highlight__ - По умолчанию сервис осуществляет подсветку совпадений в результатах и возвращает набор диапазонов индексов, которые можно выделить в интерфейсе. Значение highlight=0 отключает подсветку.
- __ll__ - центр области поиска
- __spn__ - размеры области поиска
- __bbox__ - альтернативный способ задания области поиска, при одновременном задании bbox и ll+spn параметр bbox является более приоритетным. Границы области поиска задаются в виде географических координат левого нижнего и правого верхнего углов области.
- __ull__ - координаты пользователя, используется при расчете расстояний. Если параметр не указан, по умолчанию для расчетов будет взят центр окна.
- __strict_bounds__ - используется в значении strict_bounds=1, чтобы строго ограничить выдачу и оставлять только объекты, которые попадают в окно.
- __types__ - тип объекта в ответе
- __print_address__ - возвращает покомпонентный адрес в ответе. Для этого укажите значение print_address=1
- __org_address_kind__ - возвращает список организаций только с адресом до номера дома
- __attrs__ - используется в значении attrs=uri. Возвращает в ответе параметр uri
#### Примеры:
```
client = Suggest('api_key')
# text
client.suggest('санкт')
# lang
client.suggest('санкт', lang='be')
# types
client.suggest('санкт', types='province')
# ll, spn (используются совместно)
client.suggest('площадь Революции', ll=[37.618920, 55.756994], spn=[0.552069, 0.400552])
# bbox, ull
client.suggest('Театр', bbox=[36.83, 55.67, 38.24, 55.91], ull=[36.84, 55.69])
# asynchronous
client = SearchAsync('api_key')
await client.search('ООО Яндекс', lang='ru_RU')
```
### [Static](https://yandex.ru/dev/staticapi/doc/ru/request)
Формирует изображение схемы карты
Static имеет дополнительный параметр - url.
- __api_key__ - при __url = 1.x__ необязателен
- __url__ - определяет адрес запроса, значения: v1, 1.x. При запросе на 1.x есть возможность указать перечень слоёв карты - l.
```
# url='v1' (on default)
# BASE_URL = 'https://static-maps.yandex.ru/v1'
Static()
# url='1.x
# 'BASE_URL = 'https://static-maps.yandex.ru/1.x'
Static(url='1.x')
```
#### load_image()
Сохраняет найденное изображение карт.
- __path*__, путь к файлу
- ..., то же что и в __get_image__
```
client = Static(url='1.x')
client.load_image(path='file.png', l=['sat', 'skl'], ll=[37.620070, 55.753630])
```
#### get_image()
Формирует изображение карты в соответствии со значениями параметров,
возвращает bytes.
__*__ - __ll__ или __bbox__
- __l*, (только для url='1.x')__ перечень слоев, определяющих тип карты: map (схема), sat (спутник), sat,skl (гибрид), trf (Слой пробок)
- __ll__ - центр области поиска, долгота и широта центра карты в градусах
- __bbox__ - альтернативный способ задания области поиска, при одновременном задании bbox и ll+spn параметр bbox является более приоритетным. Границы области поиска задаются в виде географических координат левого нижнего и правого верхнего углов области.
- __spn__ - протяженность области показа карты по долготе и широте (в градусах)
- __z__ - уровень масштабирования карты (0-17), см
- __size__ - ширина и высота запрашиваемого изображения карты (в пикселах)
- __scale__ - коэффициент увеличения объектов на карте (от 1.0 до 4.0)
- __pt__ - содержит описание одной или нескольких меток, которые требуется отобразить на карте
- __pl__ - Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте
#### Примеры:
```
client = Static()
# ll
client.get_image(ll=[37.620070, 55.753630])
# spn
client.get_image(ll=[37.620070, 55.753630], spn=[0.02, 0.02])
# bbox
client.get_image(bbox=[30.03, 59.85, 30.49, 60.10])
# z scale
client.get_image(ll=[37.620070, 55.753630], z=12, scale=2.5)
# size
client.get_image(ll=[37.620070, 55.753630], size=[450, 450])
# pt
client.get_image(ll=[37.620070, 55.753630], pt=[
'37.620070,55.753630,pmwtm1',
'37.62006,55.753632,pmwtm2'
])
# pl
client.get_image(ll=[37.620070, 55.753630], pl=[
'c:ec473fFF,f:00FF00A0,w:5,37.51,55.83',
'c:ec473fFF,f:00FF00A0,w:5,37.49,55.70,37.51,55.83'
])
# l
client = Static(url='1.x')
client.get_image(ll=[37.620070, 55.753630], l=['sat', 'skl'])
# asynchronous
client = StaticAsync()
await client.get_image(ll=[37.620070, 55.753630])
```
Сохраните изображение:
```sh
response = Static('api_key').get_image(...)
with open('file.png', "wb") as f:
f.write(response)
```
## Настройка разработки
```sh
$ python -m venv venv
$ . venv/bin/activate
$ make deps
$ tox
```
## Лицензия
[MIT](https://choosealicense.com/licenses/mit/)
<!-- Badges -->
[pypi-image]: https://img.shields.io/pypi/v/ymaps?color=blue
[pypi-url]: https://pypi.org/project/ymaps/
[license]: https://img.shields.io/github/license/sfkan6/ymaps
Raw data
{
"_id": null,
"home_page": "",
"name": "ymaps",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "",
"author": "",
"author_email": "sfkan6 <sfkan6@yandex.ru>",
"download_url": "https://files.pythonhosted.org/packages/a3/b6/519ff3ec43839c423797f6576bd63083bd6a730e3ba22b21151bb106b993/ymaps-1.3.tar.gz",
"platform": null,
"description": "# ymaps\n---------\n[![PyPI Version][pypi-image]][pypi-url]\n![GitHub][license]\n\n**`ymaps`** - \u044d\u0442\u043e \u043a\u043b\u0438\u0435\u043d\u0442 \u0434\u043b\u044f [API \u042f\u043d\u0434\u0435\u043a\u0441 \u041a\u0430\u0440\u0442](https://yandex.ru/dev/maps/mapsapi/) (\u041d\u0435\u043e\u0444\u0438\u0446\u0438\u0430\u043b\u044c\u043d\u044b\u0439)\n\n\u0421\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0435 \u0438 \u0410\u0441\u0438\u043d\u0445\u0440\u043e\u043d\u043d\u044b\u0435:\n\n* Search, SearchAsync - [\u041f\u043e\u0438\u0441\u043a \u043f\u043e \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f\u043c](https://yandex.ru/dev/maps/geosearch/?from=mapsapi)\n* Geocode, GeocodeAsync - [\u0413\u0435\u043e\u043a\u043e\u0434\u0435\u0440](https://yandex.ru/dev/maps/geocoder/?from=mapsapi)\n* Suggest, SuggestAsync - [\u0413\u0435\u043e\u0441\u0430\u0434\u0436\u0435\u0441\u0442](https://yandex.ru/dev/maps/geosuggest/)\n* Static, StaticAsync - [Static API](https://yandex.ru/dev/maps/staticapi/?from=mapsapi)\n\n\n\n---------\n\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430\n\n```\npip install ymaps\n```\n\n\u0417\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438\n* python 3.7+\n* [httpx](https://pypi.org/project/httpx/)\n\n---------\n## \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\n\n> \u0413\u0435\u043e\u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0437\u0430\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u043f\u043e\u0440\u044f\u0434\u043a\u0435 \u0434\u043e\u043b\u0433\u043e\u0442\u0430 \u0438 \u0448\u0438\u0440\u043e\u0442\u0430\n\n> \\* - \u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\n\n> \u0412\u0441\u0435 \u043d\u0435\u043e\u0431\u044f\u0437\u044f\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b \u0434\u043e\u043b\u0436\u043d\u044b \u043f\u0435\u0440\u0435\u0434\u0430\u0432\u0430\u0442\u044c\u0441\u044f \u043f\u043e \u0438\u043c\u0435\u043d\u0438\n\n\n\n### \u041f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u0432:\n - api_key*, [\u043f\u043e\u043b\u0443\u0447\u0438\u0442\u044c \u043a\u043b\u044e\u0447](https://developer.tech.yandex.ru/)\n - language, \u044f\u0437\u044b\u043a \u043e\u0442\u0432\u0435\u0442\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u0440\u0443\u0441\u0441\u043a\u0438\u0439 (ru_RU)\n - timeout, \u0442\u0430\u0439\u043c\u0430\u0443\u0442 \u0437\u0430\u043f\u0440\u043e\u0441\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e 1 \u0441\u0435\u043a\u0443\u043d\u0434\u0430\n\n#### \u041f\u0440\u0438\u043c\u0435\u0440\u044b:\n```\n# api_key = 'api_key', language = 'en_RU', timeout = 10\nSearch('api_key', 'en_RU', 10)\n\n# api_key = 'api_key', language = 'ru_RU', timeout = 1\nGeocode('api_key')\n\n# api_key = 'api_key', language = 'tr_TR', timeout = 1\nSuggest('api_key').suggest(text, lang='tr_TR')\n\n```\n\n\n### [Search](https://yandex.ru/dev/geosearch/doc/ru/request)\n\n\u041f\u043e\u0438\u0441\u043a\u0430 \u043f\u043e \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f\u043c \u0438 \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u043c \u043e\u0431\u044a\u0435\u043a\u0442\u0430\u043c (\u0442\u043e\u043f\u043e\u043d\u0438\u043c\u044b).\n\n#### search()\n\n\u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u043f\u043e\u0438\u0441\u043a \u043f\u043e \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u044f\u043c \u0438\u043b\u0438 \u0442\u043e\u043f\u043e\u043d\u0438\u043c\u0430\u043c, [\u0444\u043e\u0440\u043c\u0430\u0442 \u043e\u0442\u0432\u0435\u0442\u0430](https://yandex.ru/dev/geosearch/doc/ru/response).\n\n- __text*__- \u0442\u0435\u043a\u0441\u0442 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430\n- __lang__ - \u044f\u0437\u044b\u043a \u043e\u0442\u0432\u0435\u0442\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e ru_RU\n- __type__ - \u0442\u0438\u043f\u044b \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u0445 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u043e\u0432. geo \u2014 \u0442\u043e\u043f\u043e\u043d\u0438\u043c\u044b, biz \u2014 \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u0438, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u043e\u0435 \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u0435 \u0442\u0438\u043f\u0430 \u043f\u043e \u0442\u0435\u043a\u0441\u0442\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u0430\n- __ll__ - \u0446\u0435\u043d\u0442\u0440 \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430\n- __spn__ - \u0440\u0430\u0437\u043c\u0435\u0440\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430\n- __bbox__ - \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431 \u0437\u0430\u0434\u0430\u043d\u0438\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u043f\u0440\u0438 \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u043c \u0437\u0430\u0434\u0430\u043d\u0438\u0438 bbox \u0438 ll+spn \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 bbox \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0431\u043e\u043b\u0435\u0435 \u043f\u0440\u0438\u043e\u0440\u0438\u0442\u0435\u0442\u043d\u044b\u043c. \u0413\u0440\u0430\u043d\u0438\u0446\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430 \u0437\u0430\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u0432\u0438\u0434\u0435 \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442 \u043b\u0435\u0432\u043e\u0433\u043e \u043d\u0438\u0436\u043d\u0435\u0433\u043e \u0438 \u043f\u0440\u0430\u0432\u043e\u0433\u043e \u0432\u0435\u0440\u0445\u043d\u0435\u0433\u043e \u0443\u0433\u043b\u043e\u0432 \u043e\u0431\u043b\u0430\u0441\u0442\u0438.\n- __rspn__ - \u043f\u0440\u0438\u0437\u043d\u0430\u043a \u00ab\u0436\u0435\u0441\u0442\u043a\u043e\u0433\u043e\u00bb \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e False (\u043d\u0435 \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0438\u0432\u0430\u0442\u044c)\n- __results__ - \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e 10\n- __skip__ - \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 (\u043d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 \u043f\u0435\u0440\u0432\u043e\u0433\u043e), \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u043f\u0440\u043e\u043f\u0443\u0441\u0442\u0438\u0442\u044c, skip \u0434\u043e\u043b\u0436\u043d\u043e \u043d\u0430\u0446\u0435\u043b\u043e \u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u043d\u0430 results\n- __uri__ - \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043e\u0431 \u043e\u0431\u044a\u0435\u043a\u0442\u0435, \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 \u0413\u0435\u043e\u0441\u0430\u0434\u0436\u0435\u0441\u0442\u0430.\n\n#### \u041f\u0440\u0438\u043c\u0435\u0440\u044b:\n```\nclient = Search('api_key')\n\n\n# text\nclient.search('\u043b\u0435\u0431\u0435\u0434\u0438\u043d\u043e\u0435 \u043e\u0437\u0435\u0440\u043e')\nclient.search('55.750788,37.618534')\nclient.search('\u0421\u0430\u043d\u043a\u0442-\u041f\u0435\u0442\u0435\u0440\u0431\u0443\u0440\u0433, \u0443\u043b. \u0411\u043b\u043e\u0445\u0438\u043d\u0430, 15')\nclient.search('+7 495 739-70-70')\nclient.search('\u041e\u041e\u041e \u042f\u043d\u0434\u0435\u043a\u0441')\n\n# lang\nclient.search('\u041e\u041e\u041e \u042f\u043d\u0434\u0435\u043a\u0441', lang='ru_RU')\nclient.search('\u0421\u0430\u043d\u043a\u0442-\u041f\u0435\u0442\u0435\u0440\u0431\u0443\u0440\u0433, \u0443\u043b. \u0411\u043b\u043e\u0445\u0438\u043d\u0430, 15', lang='be_BY')\n\n# type\nclient.search('\u041e\u041e\u041e \u042f\u043d\u0434\u0435\u043a\u0441', lang='ru_RU', type='biz')\nclient.search('\u043b\u0435\u0431\u0435\u0434\u0438\u043d\u043e\u0435 \u043e\u0437\u0435\u0440\u043e', type='geo')\n\n# ll, spn (\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442\u0441\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u043d\u043e)\nclient.search('\u043f\u043b\u043e\u0449\u0430\u0434\u044c \u0420\u0435\u0432\u043e\u043b\u044e\u0446\u0438\u0438', ll=[37.618920, 55.756994], spn=[0.552069, 0.400552])\n\n# bbox\nclient.search('\u0422\u0435\u0430\u0442\u0440', bbox=[36.83, 55.67, 38.24, 55.91])\n\n# rspn, \u043d\u0435 \u0438\u0441\u043a\u0430\u0442\u044c \u0437\u0430 \u043f\u0440\u0435\u0434\u0435\u043b\u0430\u043c\u0438 \u0437\u0430\u0434\u0430\u043d\u043d\u043e\u0439 \u043e\u0431\u043b\u0430\u0441\u0442\u0438\nclient.search('\u0422\u0435\u0430\u0442\u0440', rspn=True, bbox=[36.83, 55.67, 38.24, 55.91])\n\n# results\nclient.search('\u0410\u0434\u043c\u0438\u043d\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044f', results=25)\n\n# skip\nclient.search('\u0410\u0434\u043c\u0438\u043d\u0438\u0441\u0442\u0440\u0430\u0446\u0438\u044f', results=25, skip=25)\n\n\n# asynchronous\nclient = SearchAsync('api_key')\nawait client.search('\u041e\u041e\u041e \u042f\u043d\u0434\u0435\u043a\u0441', lang='ru_RU')\n```\n\n### [Geocode](https://yandex.ru/dev/geocode/doc/ru/request)\n\n\u041f\u0440\u044f\u043c\u043e\u0435 \u0438 \u043e\u0431\u0440\u0430\u0442\u043d\u043e\u0435 \u0433\u0435\u043e\u043a\u043e\u0434\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u0435.\n\n#### geocode()\n\n\u041f\u0440\u0435\u043e\u0431\u0440\u0430\u0437\u0443\u0435\u0442 \u0430\u0434\u0440\u0435\u0441 \u0432 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043e\u0431\u044a\u0435\u043a\u0442\u0430, [\u0444\u043e\u0440\u043c\u0430\u0442 \u043e\u0442\u0432\u0435\u0442\u0430](https://yandex.ru/dev/geocode/doc/ru/response).\n\n- __geocode*__ - \u0442\u0435\u043a\u0441\u0442 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430\n- __ll__ - \u0446\u0435\u043d\u0442\u0440 \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430\n- __spn__ - \u0440\u0430\u0437\u043c\u0435\u0440\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430\n- __bbox__ - \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431 \u0437\u0430\u0434\u0430\u043d\u0438\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u043f\u0440\u0438 \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u043c \u0437\u0430\u0434\u0430\u043d\u0438\u0438 bbox \u0438 ll+spn \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 bbox \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0431\u043e\u043b\u0435\u0435 \u043f\u0440\u0438\u043e\u0440\u0438\u0442\u0435\u0442\u043d\u044b\u043c. \u0413\u0440\u0430\u043d\u0438\u0446\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430 \u0437\u0430\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u0432\u0438\u0434\u0435 \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442 \u043b\u0435\u0432\u043e\u0433\u043e \u043d\u0438\u0436\u043d\u0435\u0433\u043e \u0438 \u043f\u0440\u0430\u0432\u043e\u0433\u043e \u0432\u0435\u0440\u0445\u043d\u0435\u0433\u043e \u0443\u0433\u043b\u043e\u0432 \u043e\u0431\u043b\u0430\u0441\u0442\u0438.\n- __format__ - \u0444\u043e\u0440\u043c\u0430\u0442 \u043e\u0442\u0432\u0435\u0442\u0430 \u0433\u0435\u043e\u043a\u043e\u0434\u0435\u0440\u0430 xml, json; json \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e\n- __rspn__ - \u043f\u0440\u0438\u0437\u043d\u0430\u043a \u00ab\u0436\u0435\u0441\u0442\u043a\u043e\u0433\u043e\u00bb \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0435\u043d\u0438\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e False (\u043d\u0435 \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0438\u0432\u0430\u0442\u044c)\n- __results__ - \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e 10\n- __skip__ - \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 (\u043d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 \u043f\u0435\u0440\u0432\u043e\u0433\u043e), \u043a\u043e\u0442\u043e\u0440\u043e\u0435 \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e \u043f\u0440\u043e\u043f\u0443\u0441\u0442\u0438\u0442\u044c, skip \u0434\u043e\u043b\u0436\u043d\u043e \u043d\u0430\u0446\u0435\u043b\u043e \u0434\u0435\u043b\u0438\u0442\u044c\u0441\u044f \u043d\u0430 results\n- __lang__ - \u044f\u0437\u044b\u043a \u043e\u0442\u0432\u0435\u0442\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e ru_RU\n- __uri__ - \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043e\u0431 \u043e\u0431\u044a\u0435\u043a\u0442\u0435, \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 \u0413\u0435\u043e\u0441\u0430\u0434\u0436\u0435\u0441\u0442\u0430.\n\n#### reverse()\n\n\u041f\u0440\u0435\u043e\u0431\u0440\u0430\u0437\u0443\u0435\u0442 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u0432 \u0430\u0434\u0440\u0435\u0441 \u043e\u0431\u044a\u0435\u043a\u0442\u0430. \u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u0442 \u0442\u0435 \u0436\u0435 \u0430\u0440\u0433\u0443\u043c\u0435\u043d\u0442\u044b \u0447\u0442\u043e \u0438 geocode(), \u0430 \u0442\u0430\u043a\u0436\u0435:\n\n* __geocode*__ - \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0435 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043e\u0431\u044a\u0435\u043a\u0442\u0430\n* __sco__ - \u043f\u043e\u0440\u044f\u0434\u043e\u043a \u0437\u0430\u043f\u0438\u0441\u0438 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442, longlat \u2014 \u0434\u043e\u043b\u0433\u043e\u0442\u0430, \u0448\u0438\u0440\u043e\u0442\u0430, latlong \u2014 \u0448\u0438\u0440\u043e\u0442\u0430, \u0434\u043e\u043b\u0433\u043e\u0442\u0430, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e longlat\n* __kind__ - \u0432\u0438\u0434 \u043d\u0435\u043e\u0431\u0445\u043e\u0434\u0438\u043c\u043e\u0433\u043e \u0442\u043e\u043f\u043e\u043d\u0438\u043c\u0430 (house, street, metro, district, locality), \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u043f\u043e\u0434\u0431\u0438\u0440\u0430\u0435\u0442\u0441\u044f \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438\n\n#### \u041f\u0440\u0438\u043c\u0435\u0440\u044b:\n```\nclient = Geocode('api_key')\n\n# geocode\nclient.geocode('\u0421\u0430\u043d\u043a\u0442-\u041f\u0435\u0442\u0435\u0440\u0431\u0443\u0440\u0433, \u0443\u043b. \u0411\u043b\u043e\u0445\u0438\u043d\u0430, 15')\n\n#reverse\nclient.reverse([37.611347, 55.760241])\n\n# format, kind\nclient.reverse([37.611347, 55.760241], format='xml', kind='street')\n\n# sco\nclient.reverse([55.760241, 37.611347], sco='latlong')\n\n# ll, spn (\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442\u0441\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u043d\u043e)\nclient.geocode('\u0421\u0430\u043d\u043a\u0442-\u041f\u0435\u0442\u0435\u0440\u0431\u0443\u0440\u0433, \u0443\u043b. \u0411\u043b\u043e\u0445\u0438\u043d\u0430, 15', ll=[30.301324, 59.951921], spn=[0.552069, 0.400552])\n\n# bbox\nclient.geocode('\u0421\u0430\u043d\u043a\u0442-\u041f\u0435\u0442\u0435\u0440\u0431\u0443\u0440\u0433, \u0443\u043b. \u0411\u043b\u043e\u0445\u0438\u043d\u0430, 15', bbox=[36.83, 55.67, 38.24, 55.91])\n\n\n# asynchronous\nclient = GeocodeAsync('api_key')\nawait client.geocode('\u0421\u0430\u043d\u043a\u0442-\u041f\u0435\u0442\u0435\u0440\u0431\u0443\u0440\u0433, \u0443\u043b. \u0411\u043b\u043e\u0445\u0438\u043d\u0430, 15')\n```\n\n\n### [Suggest](https://yandex.ru/dev/geosuggest/doc/ru/request)\n\n\u041f\u043e\u0437\u0432\u043e\u043b\u044f\u0435\u0442 \u043f\u043e\u043b\u0443\u0447\u0430\u0442\u044c \u043f\u0440\u0435\u0434\u043b\u043e\u0436\u0435\u043d\u0438\u044f \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u043e\u0439 \u0432\u044b\u0434\u0430\u0447\u0438 \u0432\u043e \u0432\u0440\u0435\u043c\u044f \u043f\u043e\u0438\u0441\u043a\u0430 \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0438/\u0438\u043b\u0438 \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u0439.\n\n#### suggest()\n\n\u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u043f\u043e\u0438\u0441\u043a \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u0438/\u0438\u043b\u0438 \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u0439, [\u0444\u043e\u0440\u043c\u0430\u0442 \u043e\u0442\u0432\u0435\u0442\u0430](https://yandex.ru/dev/geosuggest/doc/ru/response).\n\n- __text*__- \u0442\u0435\u043a\u0441\u0442 \u043f\u043e\u0438\u0441\u043a\u043e\u0432\u043e\u0433\u043e \u0437\u0430\u043f\u0440\u043e\u0441\u0430\n- __lang__ - \u044f\u0437\u044b\u043a \u043e\u0442\u0432\u0435\u0442\u0430 \u0432 \u0444\u043e\u0440\u043c\u0430\u0442\u0435 [ISO 639-1](https://www.loc.gov/standards/iso639-2/php/code_list.php), \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e ru\n- __results__ - \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u043c\u044b\u0445 \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e 10\n- __highlight__ - \u041f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u0441\u0435\u0440\u0432\u0438\u0441 \u043e\u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043b\u044f\u0435\u0442 \u043f\u043e\u0434\u0441\u0432\u0435\u0442\u043a\u0443 \u0441\u043e\u0432\u043f\u0430\u0434\u0435\u043d\u0438\u0439 \u0432 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0430\u0445 \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043d\u0430\u0431\u043e\u0440 \u0434\u0438\u0430\u043f\u0430\u0437\u043e\u043d\u043e\u0432 \u0438\u043d\u0434\u0435\u043a\u0441\u043e\u0432, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043c\u043e\u0436\u043d\u043e \u0432\u044b\u0434\u0435\u043b\u0438\u0442\u044c \u0432 \u0438\u043d\u0442\u0435\u0440\u0444\u0435\u0439\u0441\u0435. \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 highlight=0 \u043e\u0442\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u043f\u043e\u0434\u0441\u0432\u0435\u0442\u043a\u0443.\n- __ll__ - \u0446\u0435\u043d\u0442\u0440 \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430\n- __spn__ - \u0440\u0430\u0437\u043c\u0435\u0440\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430\n- __bbox__ - \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431 \u0437\u0430\u0434\u0430\u043d\u0438\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u043f\u0440\u0438 \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u043c \u0437\u0430\u0434\u0430\u043d\u0438\u0438 bbox \u0438 ll+spn \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 bbox \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0431\u043e\u043b\u0435\u0435 \u043f\u0440\u0438\u043e\u0440\u0438\u0442\u0435\u0442\u043d\u044b\u043c. \u0413\u0440\u0430\u043d\u0438\u0446\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430 \u0437\u0430\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u0432\u0438\u0434\u0435 \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442 \u043b\u0435\u0432\u043e\u0433\u043e \u043d\u0438\u0436\u043d\u0435\u0433\u043e \u0438 \u043f\u0440\u0430\u0432\u043e\u0433\u043e \u0432\u0435\u0440\u0445\u043d\u0435\u0433\u043e \u0443\u0433\u043b\u043e\u0432 \u043e\u0431\u043b\u0430\u0441\u0442\u0438.\n- __ull__ - \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442\u044b \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u044f, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u043f\u0440\u0438 \u0440\u0430\u0441\u0447\u0435\u0442\u0435 \u0440\u0430\u0441\u0441\u0442\u043e\u044f\u043d\u0438\u0439. \u0415\u0441\u043b\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 \u043d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d, \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e \u0434\u043b\u044f \u0440\u0430\u0441\u0447\u0435\u0442\u043e\u0432 \u0431\u0443\u0434\u0435\u0442 \u0432\u0437\u044f\u0442 \u0446\u0435\u043d\u0442\u0440 \u043e\u043a\u043d\u0430.\n- __strict_bounds__ - \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0432 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0438 strict_bounds=1, \u0447\u0442\u043e\u0431\u044b \u0441\u0442\u0440\u043e\u0433\u043e \u043e\u0433\u0440\u0430\u043d\u0438\u0447\u0438\u0442\u044c \u0432\u044b\u0434\u0430\u0447\u0443 \u0438 \u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u043e\u0431\u044a\u0435\u043a\u0442\u044b, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u043f\u043e\u043f\u0430\u0434\u0430\u044e\u0442 \u0432 \u043e\u043a\u043d\u043e.\n- __types__ - \u0442\u0438\u043f \u043e\u0431\u044a\u0435\u043a\u0442\u0430 \u0432 \u043e\u0442\u0432\u0435\u0442\u0435\n- __print_address__ - \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u043f\u043e\u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442\u043d\u044b\u0439 \u0430\u0434\u0440\u0435\u0441 \u0432 \u043e\u0442\u0432\u0435\u0442\u0435. \u0414\u043b\u044f \u044d\u0442\u043e\u0433\u043e \u0443\u043a\u0430\u0436\u0438\u0442\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435 print_address=1\n- __org_address_kind__ - \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0441\u043f\u0438\u0441\u043e\u043a \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u0439 \u0442\u043e\u043b\u044c\u043a\u043e \u0441 \u0430\u0434\u0440\u0435\u0441\u043e\u043c \u0434\u043e \u043d\u043e\u043c\u0435\u0440\u0430 \u0434\u043e\u043c\u0430\n- __attrs__ - \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f \u0432 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0438 attrs=uri. \u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0432 \u043e\u0442\u0432\u0435\u0442\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 uri\n\n#### \u041f\u0440\u0438\u043c\u0435\u0440\u044b:\n```\nclient = Suggest('api_key')\n\n\n# text\nclient.suggest('\u0441\u0430\u043d\u043a\u0442')\n\n# lang\nclient.suggest('\u0441\u0430\u043d\u043a\u0442', lang='be')\n\n# types \nclient.suggest('\u0441\u0430\u043d\u043a\u0442', types='province')\n\n# ll, spn (\u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u044e\u0442\u0441\u044f \u0441\u043e\u0432\u043c\u0435\u0441\u0442\u043d\u043e)\nclient.suggest('\u043f\u043b\u043e\u0449\u0430\u0434\u044c \u0420\u0435\u0432\u043e\u043b\u044e\u0446\u0438\u0438', ll=[37.618920, 55.756994], spn=[0.552069, 0.400552])\n\n# bbox, ull\nclient.suggest('\u0422\u0435\u0430\u0442\u0440', bbox=[36.83, 55.67, 38.24, 55.91], ull=[36.84, 55.69])\n\n\n# asynchronous\nclient = SearchAsync('api_key')\nawait client.search('\u041e\u041e\u041e \u042f\u043d\u0434\u0435\u043a\u0441', lang='ru_RU')\n```\n\n\n### [Static](https://yandex.ru/dev/staticapi/doc/ru/request)\n\n\u0424\u043e\u0440\u043c\u0438\u0440\u0443\u0435\u0442 \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u0441\u0445\u0435\u043c\u044b \u043a\u0430\u0440\u0442\u044b\n\nStatic \u0438\u043c\u0435\u0435\u0442 \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 - url.\n\n- __api_key__ - \u043f\u0440\u0438 __url = 1.x__ \u043d\u0435\u043e\u0431\u044f\u0437\u0430\u0442\u0435\u043b\u0435\u043d\n- __url__ - \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0435\u0442 \u0430\u0434\u0440\u0435\u0441 \u0437\u0430\u043f\u0440\u043e\u0441\u0430, \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f: v1, 1.x. \u041f\u0440\u0438 \u0437\u0430\u043f\u0440\u043e\u0441\u0435 \u043d\u0430 1.x \u0435\u0441\u0442\u044c \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u044c \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u043f\u0435\u0440\u0435\u0447\u0435\u043d\u044c \u0441\u043b\u043e\u0451\u0432 \u043a\u0430\u0440\u0442\u044b - l.\n\n```\n# url='v1' (on default)\n# BASE_URL = 'https://static-maps.yandex.ru/v1'\nStatic()\n\n# url='1.x\n# 'BASE_URL = 'https://static-maps.yandex.ru/1.x'\nStatic(url='1.x')\n```\n\n#### load_image()\n\n\u0421\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442 \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u043e\u0435 \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u043a\u0430\u0440\u0442.\n\n- __path*__, \u043f\u0443\u0442\u044c \u043a \u0444\u0430\u0439\u043b\u0443\n- ..., \u0442\u043e \u0436\u0435 \u0447\u0442\u043e \u0438 \u0432 __get_image__\n\n```\nclient = Static(url='1.x') \nclient.load_image(path='file.png', l=['sat', 'skl'], ll=[37.620070, 55.753630]) \n```\n\n#### get_image()\n\n\u0424\u043e\u0440\u043c\u0438\u0440\u0443\u0435\u0442 \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435 \u043a\u0430\u0440\u0442\u044b \u0432 \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u0438\u0438 \u0441\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f\u043c\u0438 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432,\n\u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 bytes. \n\n__*__ - __ll__ \u0438\u043b\u0438 __bbox__\n\n- __l*, (\u0442\u043e\u043b\u044c\u043a\u043e \u0434\u043b\u044f url='1.x')__ \u043f\u0435\u0440\u0435\u0447\u0435\u043d\u044c \u0441\u043b\u043e\u0435\u0432, \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u044e\u0449\u0438\u0445 \u0442\u0438\u043f \u043a\u0430\u0440\u0442\u044b: map (\u0441\u0445\u0435\u043c\u0430), sat (\u0441\u043f\u0443\u0442\u043d\u0438\u043a), sat,skl (\u0433\u0438\u0431\u0440\u0438\u0434), trf (\u0421\u043b\u043e\u0439 \u043f\u0440\u043e\u0431\u043e\u043a)\n- __ll__ - \u0446\u0435\u043d\u0442\u0440 \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u0434\u043e\u043b\u0433\u043e\u0442\u0430 \u0438 \u0448\u0438\u0440\u043e\u0442\u0430 \u0446\u0435\u043d\u0442\u0440\u0430 \u043a\u0430\u0440\u0442\u044b \u0432 \u0433\u0440\u0430\u0434\u0443\u0441\u0430\u0445\n- __bbox__ - \u0430\u043b\u044c\u0442\u0435\u0440\u043d\u0430\u0442\u0438\u0432\u043d\u044b\u0439 \u0441\u043f\u043e\u0441\u043e\u0431 \u0437\u0430\u0434\u0430\u043d\u0438\u044f \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430, \u043f\u0440\u0438 \u043e\u0434\u043d\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u043c \u0437\u0430\u0434\u0430\u043d\u0438\u0438 bbox \u0438 ll+spn \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440 bbox \u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0431\u043e\u043b\u0435\u0435 \u043f\u0440\u0438\u043e\u0440\u0438\u0442\u0435\u0442\u043d\u044b\u043c. \u0413\u0440\u0430\u043d\u0438\u0446\u044b \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u0438\u0441\u043a\u0430 \u0437\u0430\u0434\u0430\u044e\u0442\u0441\u044f \u0432 \u0432\u0438\u0434\u0435 \u0433\u0435\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u043a\u043e\u043e\u0440\u0434\u0438\u043d\u0430\u0442 \u043b\u0435\u0432\u043e\u0433\u043e \u043d\u0438\u0436\u043d\u0435\u0433\u043e \u0438 \u043f\u0440\u0430\u0432\u043e\u0433\u043e \u0432\u0435\u0440\u0445\u043d\u0435\u0433\u043e \u0443\u0433\u043b\u043e\u0432 \u043e\u0431\u043b\u0430\u0441\u0442\u0438.\n- __spn__ - \u043f\u0440\u043e\u0442\u044f\u0436\u0435\u043d\u043d\u043e\u0441\u0442\u044c \u043e\u0431\u043b\u0430\u0441\u0442\u0438 \u043f\u043e\u043a\u0430\u0437\u0430 \u043a\u0430\u0440\u0442\u044b \u043f\u043e \u0434\u043e\u043b\u0433\u043e\u0442\u0435 \u0438 \u0448\u0438\u0440\u043e\u0442\u0435 (\u0432 \u0433\u0440\u0430\u0434\u0443\u0441\u0430\u0445)\n- __z__ - \u0443\u0440\u043e\u0432\u0435\u043d\u044c \u043c\u0430\u0441\u0448\u0442\u0430\u0431\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u043a\u0430\u0440\u0442\u044b (0-17), \u0441\u043c\n- __size__ - \u0448\u0438\u0440\u0438\u043d\u0430 \u0438 \u0432\u044b\u0441\u043e\u0442\u0430 \u0437\u0430\u043f\u0440\u0430\u0448\u0438\u0432\u0430\u0435\u043c\u043e\u0433\u043e \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u043a\u0430\u0440\u0442\u044b (\u0432 \u043f\u0438\u043a\u0441\u0435\u043b\u0430\u0445)\n- __scale__ - \u043a\u043e\u044d\u0444\u0444\u0438\u0446\u0438\u0435\u043d\u0442 \u0443\u0432\u0435\u043b\u0438\u0447\u0435\u043d\u0438\u044f \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u0432 \u043d\u0430 \u043a\u0430\u0440\u0442\u0435 (\u043e\u0442 1.0 \u0434\u043e 4.0)\n- __pt__ - \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0435 \u043e\u0434\u043d\u043e\u0439 \u0438\u043b\u0438 \u043d\u0435\u0441\u043a\u043e\u043b\u044c\u043a\u0438\u0445 \u043c\u0435\u0442\u043e\u043a, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f \u043e\u0442\u043e\u0431\u0440\u0430\u0437\u0438\u0442\u044c \u043d\u0430 \u043a\u0430\u0440\u0442\u0435\n- __pl__ - \u0421\u043e\u0434\u0435\u0440\u0436\u0438\u0442 \u043d\u0430\u0431\u043e\u0440 \u043e\u043f\u0438\u0441\u0430\u043d\u0438\u0439 \u0433\u0435\u043e\u043c\u0435\u0442\u0440\u0438\u0447\u0435\u0441\u043a\u0438\u0445 \u0444\u0438\u0433\u0443\u0440 (\u043b\u043e\u043c\u0430\u043d\u044b\u0445 \u0438 \u043c\u043d\u043e\u0433\u043e\u0443\u0433\u043e\u043b\u044c\u043d\u0438\u043a\u043e\u0432), \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0442\u0440\u0435\u0431\u0443\u0435\u0442\u0441\u044f \u043e\u0442\u043e\u0431\u0440\u0430\u0437\u0438\u0442\u044c \u043d\u0430 \u043a\u0430\u0440\u0442\u0435\n\n\n#### \u041f\u0440\u0438\u043c\u0435\u0440\u044b:\n\n```\nclient = Static()\n\n# ll\nclient.get_image(ll=[37.620070, 55.753630])\n\n# spn\nclient.get_image(ll=[37.620070, 55.753630], spn=[0.02, 0.02])\n\n# bbox\nclient.get_image(bbox=[30.03, 59.85, 30.49, 60.10])\n\n# z scale\nclient.get_image(ll=[37.620070, 55.753630], z=12, scale=2.5)\n\n# size \nclient.get_image(ll=[37.620070, 55.753630], size=[450, 450])\n\n# pt\nclient.get_image(ll=[37.620070, 55.753630], pt=[\n\t'37.620070,55.753630,pmwtm1', \n\t'37.62006,55.753632,pmwtm2'\n])\n\n# pl\nclient.get_image(ll=[37.620070, 55.753630], pl=[\n\t'c:ec473fFF,f:00FF00A0,w:5,37.51,55.83', \n\t'c:ec473fFF,f:00FF00A0,w:5,37.49,55.70,37.51,55.83'\n])\n\n# l\nclient = Static(url='1.x')\nclient.get_image(ll=[37.620070, 55.753630], l=['sat', 'skl'])\n\n\n# asynchronous\nclient = StaticAsync()\nawait client.get_image(ll=[37.620070, 55.753630])\n```\n\n\u0421\u043e\u0445\u0440\u0430\u043d\u0438\u0442\u0435 \u0438\u0437\u043e\u0431\u0440\u0430\u0436\u0435\u043d\u0438\u0435:\n```sh\nresponse = Static('api_key').get_image(...)\n\nwith open('file.png', \"wb\") as f:\n\tf.write(response)\n```\n\n## \u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u0440\u0430\u0437\u0440\u0430\u0431\u043e\u0442\u043a\u0438\n\n```sh\n$ python -m venv venv\n$ . venv/bin/activate\n$ make deps\n$ tox\n```\n\n## \u041b\u0438\u0446\u0435\u043d\u0437\u0438\u044f\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n<!-- Badges -->\n[pypi-image]: https://img.shields.io/pypi/v/ymaps?color=blue\n[pypi-url]: https://pypi.org/project/ymaps/\n\n[license]: https://img.shields.io/github/license/sfkan6/ymaps\n",
"bugtrack_url": null,
"license": "",
"summary": "Client for Yandex Maps API",
"version": "1.3",
"project_urls": {
"Home": "https://github.com/sfkan6/ymaps"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6a3710557d06a12697aa77b7cb95b3e01b5e2e6ff5fe93997ab3b60ab3528685",
"md5": "84ec76474964ebe24ff2c97dc0eeae7c",
"sha256": "887f46443ad708ed219f8fa8a5e243288cd05d0120c6dd55e46233b2d08a4fb3"
},
"downloads": -1,
"filename": "ymaps-1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "84ec76474964ebe24ff2c97dc0eeae7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 10189,
"upload_time": "2023-10-31T15:22:37",
"upload_time_iso_8601": "2023-10-31T15:22:37.727460Z",
"url": "https://files.pythonhosted.org/packages/6a/37/10557d06a12697aa77b7cb95b3e01b5e2e6ff5fe93997ab3b60ab3528685/ymaps-1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a3b6519ff3ec43839c423797f6576bd63083bd6a730e3ba22b21151bb106b993",
"md5": "e8bc1979b09a7e98cd9a07b2f22dfee8",
"sha256": "9e8730abd8d8e05f560b651899ccbbe5068c090ab6e69b967f15f918b6d73a58"
},
"downloads": -1,
"filename": "ymaps-1.3.tar.gz",
"has_sig": false,
"md5_digest": "e8bc1979b09a7e98cd9a07b2f22dfee8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 11614,
"upload_time": "2023-10-31T15:22:41",
"upload_time_iso_8601": "2023-10-31T15:22:41.368532Z",
"url": "https://files.pythonhosted.org/packages/a3/b6/519ff3ec43839c423797f6576bd63083bd6a730e3ba22b21151bb106b993/ymaps-1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-31 15:22:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sfkan6",
"github_project": "ymaps",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "ymaps"
}
