ymaps 0.2

Client for Yandex Maps API

ymaps

Клиент для API Яндекс Карт (Неофициальный)

---

Включает в себя 4 класса:

• BaseClient - Родитель
• SearchClient - Поиск по организациям
• GeocoderClient - Геокодер
• StaticClient - Static API

Геокоординаты задаются в порядке долгота и широта

* - обязательный аргумент

---

BaseClient

Аргументы:

• api_key*, получить ключ.
• scheme, протокол передачи данных, по умолчанию https
• timeout, таймаут запроса, по умолчанию 1
• proxies, прокси-сервера, по умолчанию ищет прокси в системе, если не находит не используется

SearchClient, GeocoderClient, StaticClient принимают такие же аргументы, передавайте api_key в StaticClient только если используете коммерческую версию.

Примеры:

scheme='http'

timeout=10

proxies={ “http”: “http://0.0.0.0:8000*”, “https”: “http://0.0.0.0:8000” }

---

SearchClient

search()

Выполняет поиск по организациям или топонимам.

• text*, текст поискового запроса
• lang, язык ответа, по умолчанию ru_RU
• type_objects, типы возвращаемых результатов. geo — топонимы, biz — организации, по умолчанию автоматическое определение типа по тексту запроса
• ll, центр области поиска
• spn, размеры области поиска
• bbox, альтернативный способ задания области поиска, при одновременном задании bbox и ll+spn параметр bbox является более приоритетным
• rspn, признак «жесткого» ограничения области поиска, по умолчанию False (не ограничивать)
• results, количество возвращаемых объектов, по умолчанию 10
• skip, количество объектов в ответе (начиная с первого), которое необходимо пропустить, skip должно нацело делиться на results

Примеры:

• text

text='лебединое озеро'

text='55.750788,37.618534'

text='Санкт-Петербург, ул. Блохина, 15'

text='[phone]'

text='ООО Яндекс'

• lang

lang='ru_RU'

lang='be_BY'

• type

type_objects='biz'

type_objects='geo'

• ll, spn (используются совместно)

ll=[37.618920, 55.756994], spn=[0.552069, 0.400552]

• bbox

bbox=[36.83, 55.67, 38.24, 55.91]

• rspn

rspn=True # не искать за пределами заданной области

• results

results=25

• skip

skip=25

---

GeocoderClient

Прямое и обратное геокодирование

geocode()

Преобразует адрес в координаты объекта

• address*, текст поискового запроса
• rspn, признак «жесткого» ограничения области поиска, по умолчанию False (не ограничивать)
• ll, центр области поиска
• spn, размеры области поиска
• bbox, альтернативный способ задания области поиска, при одновременном задании bbox и ll+spn параметр bbox является более приоритетным
• form, формат ответа геокодера xml, json по умолчанию
• results, количество возвращаемых объектов, по умолчанию 10
• skip, количество объектов в ответе (начиная с первого), которое необходимо пропустить, skip должно нацело делиться на results
• lang, язык ответа, по умолчанию ru_RU

reverse()

Преобразует координаты в адрес объекта. Принимает те же аргументы что и geocode() кроме address, и еще:

• geocode*, географические координаты объекта
• sco, порядок записи координат, longlat — долгота, широта, latlong — широта, долгота
• kind, вид необходимого топонима (house, street, metro, district, locality)

Примеры:

text='Санкт-Петербург, ул. Блохина, 15'

geocode=[37.611347, 55.760241]

form='xml'

sco='longlat'

kind='street'

---

StaticClient

Формирует изображение карты в соответствии со значениями параметров

getimage()

• l*, перечень слоев, определяющих тип карты: map (схема), sat (спутник) и sat,skl (гибрид)
• ll*, долгота и широта центра карты в градусах
• spn, протяженность области показа карты по долготе и широте (в градусах)
• z, уровень масштабирования карты (0-17), см
• size, ширина и высота запрашиваемого изображения карты (в пикселах)
• scale, коэффициент увеличения объектов на карте (от 1.0 до 4.0)
• pt, содержит описание одной или нескольких меток, которые требуется отобразить на карте
• pl, Содержит набор описаний геометрических фигур (ломаных и многоугольников), которые требуется отобразить на карте
• lang, язык ответа, по умолчанию ru_RU

Примеры:

l=['sat', 'skl']

ll=[37.620070, 55.753630]

spn=[0.01, 0.01]

z=10

size=[450, 450]

scale=2.0

pt=['37.620070,55.753630,pmwtm1']

pl=['c:ec473fFF,f:00FF00A0,w:5,37.51,55.83,37.67,55.82,37.66,55.74,37.49,55.70,37.51,55.83']

Сохраните изображение:

with open('file.png', "wb") as f:
	f.write(response)