Конкурс инструкций

Telegram-бот для получения адреса по локации или координатам (Python)

Привет! Представь ситуацию, когда тебе скинули координаты или локацию, но ты хочешь срочно узнать адрес этого места.

Сегодня попробуем написать Telegram-бота для получения адреса по координатам или локации.

В итоге у тебя получится вот такой бот @SayMyAddressBot.

Что нам для этого потребуется?

  • Бот в Telegram;
  • Обратный геокодинг от Яндекса. Геокодинг это такой сервис, который позволяет получить из адреса координаты, а нам нужно наоборот, поэтому «обратный геокодинг»;
  • Установленный Python и библиотека requests для посылки запросов;
  • Установленная библиотека Python-telegram-bot.

Но давай обо всём по порядку!

Создаём бота в Telegram.

1) Ищем в поиске Telegram бота по нику @botfather. Этот бот ответственен за регистрацию всех остальных ботов;

@botfather

2) Отправляем ему /newbot и начинаем создание бота;

3) Отправляем имя бота (оно может быть любым) и ник бота (обязательно должен оканчиваться на «bot»). Если у тебя выходит ошибка, то значит этот ник занят. Пробуй другой.

4) Получаем токен бота (скопируй этот токен и никому не давай😅).

Скриншот ниже (токен выделен красной рамкой).

Супер! Бот создан и уже доступен внутри Telegram по нику. Можешь вбить в поиске и убедиться. Также ты можешь найти его по ссылке t.me/НикТвоегоБота. Например на скриншоте я зарегистрировал SayMyAddressBot, значит его ссылка t.me/SayMyAddressBot. Сохрани такую ссылку с ником твоего бота. Скоро она нам пригодится.

Отлично. С ботом разобрались.

Обратный геокодинг от Яндекса.

Я надеюсь, что у тебя есть аккаунт на Яндексе. Если нет, то тебе сюда.

Итак. Как работает обратный геокодинг от Яндекса?

Всё очень просто. Нужно отправить GET запрос с координатами и получить в ответ адрес.

Вот пример такого запроса:

https://geocode-maps.yandex.ru/1.x? format=json&lang=ru_RU&kind=house&geocode=37.617585,55.751903&apikey=ТОКЕН

Что мы тут видим?

Запрос:

https://geocode-maps.yandex.ru/1.x/

Параметры:

  • format: в каком формате возвращать данные. В данном случае json;
  • lang: язык возвращаемых данных. В данном случае ru_RU (русский);
  • kind: вид адреса. В данном случае house (точность до дома);
  • geocode: координаты (сначала идет долгота, затем широта);
  • apikey: токен для доступа.

P.S.: параметров гораздо больше, но нам они не нужны. Подробнее можешь почитать тут.

Просто, правда? Послал запрос с координатами, получил адрес 😊.

Как видишь у нас есть все данные кроме токена. Займемся его получением!

Получаем токен.

1) Заходим на страницу разработчика и входим в кабинет (аккаунт на Яндексе у тебя уже есть).

2) Получилось? Отлично. Далее ты увидишь вот такую страницу.

Пустой кабинет разработчика

Жми желтую кнопку «Подключить API»

3) Теперь нужно выбрать какой именно токен нам нужен.

Нам нужен HTTP геокодер

Выбирай «JavaScript API и HTTP геокодер». За ним мы и пришли.

4) Далее заполняем формочку твоими данными.

В поле «Ссылка на ваш сайт» пиши ссылку на своего бота, которую мы сохранили ранее.

Ну и тыкай кнопку «Продолжить».

5) Тебе должно всплыть окошко с сообщением об успешной регистрации.

Жми «Перейти к API».

6) Вот и всё. На открывшейся странице уже лежит наш искомый токен геокодера (выделил красной рамкой). Его тоже сохрани и никому не давай.

Токен активируется через 15 минут после создания. Можешь прямо в браузере (Chrome, Safari или что там у тебя) вбить (не забудь подставить свой токен в конце).

https://geocode-maps.yandex.ru/1.x? format=json&lang=ru_RU&kind=house&geocode=37.617585,55.751903&apikey=ТОКЕН

и получить ответ в json виде:

{ "response": { "GeoObjectCollection": { "metaDataProperty": { "GeocoderResponseMetaData": { "Point": { "pos": "37.617585 55.751903" }, "boundedBy": { "Envelope": { "lowerCorner": "37.615084 55.749405", "upperCorner": "37.620079 55.7544" } }, "request": "37.617585,55.751903", "results": "10", "found": "2" } }, "featureMember": [ { "GeoObject": { "metaDataProperty": { "GeocoderMetaData": { "precision": "exact", "text": "Russia, Moscow, Moscow Kremlin, 1", "kind": "house", "Address": { "country_code": "RU", "formatted": "Russia, Moscow, Moscow Kremlin, 1", "Components": [ { "kind": "country", "name": "Russia" }, { "kind": "province", "name": "Tsentralny federalny okrug" }, { "kind": "province", "name": "Moscow" }, { "kind": "locality", "name": "Moscow" }, { "kind": "district", "name": "Moscow Kremlin" }, { "kind": "house", "name": "1" } ] }, "AddressDetails": { "Country": { "AddressLine": "Russia, Moscow, Moscow Kremlin, 1", "CountryNameCode": "RU", "CountryName": "Russia", ...

Пол дела сделано. У нас есть и Telegram бот (с его токеном) и геокодер (с его токеном).

Теперь с помощью Python мы их объединим!

Python у тебя уже установлен? Если нет, то тебе сюда.

Получаем адрес по координатам на Python.

В Python есть библиотека requests и она позволяет посылать запросы (как ты только что делал в браузере). Это нам подходит.

1) Открывай консоль (терминал) и устанавливай requests с помощью команды:

pip install requests

Подробнее тут.

2) Теперь нужно будет написать небольшой код на Python для получения адреса по координатам.

Открывай свою среду разработки или просто текстовый файл (нужно будет сохранить его с окончанием. py, а не. txt). Назовём файл main.py.

И добавляй туда этот код. Он полностью расписан в комментариях.

#импортируем библиотеку requests import requests #создаем функцию get_address_from_coords с параметром coords, куда мы будем посылать координаты и получать готовый адрес. def get_address_from_coords(coords): #заполняем параметры, которые описывались выже. Впиши в поле apikey свой токен! PARAMS = { "apikey":"ТОКЕН", "format":"json", "lang":"ru_RU", "kind":"house", "geocode": coords } #отправляем запрос по адресу геокодера. try: r = requests.get(url="https://geocode-maps.yandex.ru/1.x/", params=PARAMS) #получаем данные json_data = r.json() #вытаскиваем из всего пришедшего json именно строку с полным адресом. address_str = json_data["response"]["GeoObjectCollection"]["featureMember"][0]["GeoObject"]["metaDataProperty"]["GeocoderMetaData"]["AddressDetails"]["Country"]["AddressLine"] #возвращаем полученный адрес return address_str except Exception as e: #если не смогли, то возвращаем ошибку return "error" if __name__ == '__main__': #даем запрос на получение адреса с координатами 37.617585, 55.751903 address_str = get_address_from_coords("37.617585,55.751903") #распечатываем адрес print(address_str)

3) В консоли (терминале) переходим в папку с нашим файлом через команду «cd» (у меня он лежит в папке Documents/Python/).

И запускаем файл с помощью «python3».

Как результат, ты получишь адрес координат из кода.

Мы почти закончили! Осталось совсем немного.

Программируем Telegram бота на Python

Здесь в целом всё точно также, как и в предыдущей части.

Нам необходимо:

  • Установить библиотеку python-telegram-bot для управления нашим ботом.
  • Написать немного кода.

Поехали!

Установка библиотеки python-telegram-bot

1) Снова открывай консоль (терминал) и устанавливай python-telegram-bot с помощью команды:

pip install python-telegram-bot

Подробнее тут.

2) Пришло время написать код нашего бота. Я снова всё опишу в комментариях (не забудь поставить токен геокодера и токен бота в нужных местах в коде)!

#Подлкючаем библиотеку requests import requests #Подключаем нужные для бота модули из библиотеки telegram.ext from telegram.ext import Updater, CommandHandler, MessageHandler, Filters #это наша функция для получения адреса по координатам. С ней мы знакомы. def get_address_from_coords(coords): PARAMS = { "apikey": "ТОКЕН_ГЕОКОДЕРА", "format": "json", "lang": "ru_RU", "kind": "house", "geocode": coords } try: r = requests.get(url="https://geocode-maps.yandex.ru/1.x/", params=PARAMS) json_data = r.json() address_str = json_data["response"]["GeoObjectCollection"]["featureMember"][0]["GeoObject"]["metaDataProperty"][ "GeocoderMetaData"]["AddressDetails"]["Country"]["AddressLine"] return address_str except Exception as e: #единственное что тут изменилось, так это сообщение об ошибке. return "Не могу определить адрес по этой локации/координатам.\n\nОтправь мне локацию или координаты (долгота, широта):" #Эта функция будет использоваться когда человек первый нажал в боте START def start(update, context): #эта строка отправляет сообщение пользователю с просьбой послать локацию или координаты update.message.reply_text('Отправь мне локацию или координаты (долгота, широта):') #Эта функция будет использоваться, если пользователь послал в бота любой текст. #Мы ожидаем координаты, но если прийдет что-то другое не страшно, ведь мы описали в функции получения адреса возвращение ошибки в случае чего. def text(update, context): #получаем текст от пользователя coords = update.message.text #отправляем текст в нашу функцио получения адреса из координат address_str = get_address_from_coords(coords) #вовщращаем результат пользователю в боте update.message.reply_text(address_str) #Эта функция будет использоваться, если пользователь послал локацию. def location(update, context): #получаем обьект сообщения (локации) message = update.message #вытаскиваем из него долготу и ширину current_position = (message.location.longitude, message.location.latitude) #создаем строку в виде ДОЛГОТА,ШИРИНА coords = f"{current_position[0]},{current_position[1]}" #отправляем координаты в нашу функцию получения адреса address_str = get_address_from_coords(coords) #вовщращаем результат пользователю в боте update.message.reply_text(address_str) #Это основная функция, где запускается наш бот def main(): #создаем бота и указываем его токен updater = Updater("ТОКЕН_БОТА", use_context=True) #создаем регистратор событий, который будет понимать, что сделал пользователь и на какую функцию надо переключиться. dispatcher = updater.dispatcher #регистрируем команду /start и говорим, что после нее надо использовать функцию def start dispatcher.add_handler(CommandHandler("start", start)) #регистрируем получение текста и говорим, что после нее надо использовать функцию def text dispatcher.add_handler(MessageHandler(Filters.text, text)) #регистрируем получение локации и говорим, что после нее надо использовать функцию def location dispatcher.add_handler(MessageHandler(Filters.location, location)) #запускаем бота updater.start_polling() updater.idle() if __name__ == '__main__': #запускаем функцию def main main()

3) Создаем файл main_bot.py и сохраняем этот код в нём.

4) В консоли (терминале) переходим в папку с нашим файлом через команду «cd» (у меня он лежит в папке Documents/Python/).

5) И снова запускаем файл с помощью «python3». Теперь уже это файл нашего готового бота!

Всё! Заходи в своего бота в Telegram (ищи по нику) и используй🤩🥳.

Моего бота можно посмотреть тут @SayMyAddressBot.

P. S. Это моя первая инструкция на портале. Старался сделать так, чтобы было понятно даже совсем начинающим. Спасибо за то, что прочёл до конца!

0
9 комментариев
Написать комментарий...
Денис Осотов

Начну с вопроса - а зачем такой бот нужен? Любая онлайн карта без проблем справляется с определением адреса по координатам.
Конечно можно сказать, что это pet project и основной смысл в обучении, но зачем это тогда постить? Статья видимо рассчитана на крайне узкую прослойку начинающих программистов, которые уже вроде что-то умеют, но ещё не написали ни одного полноценного скрипта, который бы выполнял какую-то полезную функцию. 
Автор явно сам является начинающим программистом, а уже хочет научить чему-то других. Причём библиотека для работы с api телеги используется далеко не самая топовая, но в этом ничего плохого нет - как говорится на вкус и цвет.
Собственно я клоню к тому, что если автор хочет начать постить статьи о программировании, и сам при этом является начинающим программистом, то стоило начать с цикла статей с соответствующей тематикой, а-ля "Я являюсь программистом такого-то уровня и поставил перед собой задачу достичь такой-то цели. Буду рад советам в комментариях".
Крайне простой и (без обид, но сам понимаешь) абсолютно бесполезный тг-бот, коих сотни тысяч, а то и миллионы, с очень узкой специализацией конечно не тянет на такую цель.
А что тянет?, - Ну например было бы гораздо круче, если был выбран такой функционал бота, в котором нужно задействовать базы данных. И которого потом можно было бы интегрировать с сайтом или мобильным приложением.
В любом случае я не пытаюсь критиковать автора и уж тем более не хочу обидеть. Просто хотелось бы увидеть более осмысленный и интересный материал в этой области, а не подобное ребячество. Это было бы полезно, как для самого автора, так и для всех читателей.

Ответить
Развернуть ветку
Dan
Автор

Привет! Спасибо за критику. Пост в рамках конкурса для начинающих. Можешь посмотреть наши работы https://t.me/EngJackBot, https://t.me/OzyBot, https://t.me/ArzonAptekaBot. Но расписать создание таких ботов по простому - сложновато (да и только "профи" поймут всё), поэтому хотел скорее для широкой аудитории, чтобы побольше ребят не уходили расстроенные, а пробовали и понимали, что все возможно).

А бот из статьи используют уже несколько компаний для получения адреса. Т.к им клиенты скидывают локации (у водителей гонит интернет и навигатор не открывается, в регионах с плохим интернетом это боль) и многие не могут или забывают назвать точный адрес. При этом множество мелких бизнесов работают именно через Телеграм. Не все диджитализированы по максимуму;)

Ответить
Развернуть ветку
Roman Firsov

Послушай токсик, нормальная статься, мне лично было интересно взглянуть, если таких как ты слушать то никто ничего вообще не запостит и не выложит никогда.

Ответить
Развернуть ветку
Иннокентий Комаров

Какая сейчас топовая библиотека для тг-бота и чем плоха эта библиотека?

Ответить
Развернуть ветку
Ignat Romanov

Ещё бы с фотки координаты мог сканировать )

Ответить
Развернуть ветку
Habel

Рай закладчика

Ответить
Развернуть ветку
Ибрагим Кадиров

Все очень четко и просто объяснили. Спасибо! 

Ответить
Развернуть ветку

Комментарий удален модератором

Развернуть ветку
batyr new

Скажите пожалуйста, как вытащить из json файла, дающегося при запросе, город пользователя? Я просто хочу вытащить его из GeocoderMetaData, потом Component и locality, но не входит

Ответить
Развернуть ветку
Артем Менеджер

Статья очень дельная!!!!
Автору огромный респект.

А вы не сталкивались с oAuth авторизацией Уяндекса? Как внедрить невпихнуемое, когда кодирование запроса не в json a x-www-form-urlencoded???

Ответить
Развернуть ветку
6 комментариев
Раскрывать всегда