Client for Yandex Maps API
Project description
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='+7 495 739-70-70'
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)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.