https://habr.com/ru/post/470347/

• Python
• Программирование
• Maps API
• API

В конце сентября состоялся самый большой в мире хакатон, который проходил в Казани. Данное мероприятие по количеству участников вошло в «Книгу рекордов Гиннесса».

В данной статье хочется поделиться опытом, по использованию HERE API, полученным за эти бессонные 48 часов.

Использование API начинается с регистрации в разделе для разработчиков на официальном сайте для генерации и получения ключей APP ID и APP CODE. Free API key позволяет выполнять до 250 тысяч транзакций в месяц. Поверьте, это покрывает все потребности для хакатона.

Статистика использования HERE API нашим ПО за 48 часов показала следующие цифры:

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

Анализ общедоступных API показал, что больше всего для решения задачи подойдут следующие REST-запросы:

• Plan a route from A to B using Public Transport
• Car route from A to B
• Pedestrian route from A to B

Каждый запрос содержит следующие поля:

deplocation = A # точка отправки
arrlocation = B # точка прибытия
# ключи, полученные после регистрации на сайте
app_id = os.getenv('HERE_APP_ID')
app_code = os.getenv('HERE_APP_CODE')

Нахождение времени в пути с использованием общественного транспорта

url = f"https://transit.api.here.com/v3/route.json"
query = {
			'dep': deplocation,
			'arr': arrlocation,
			'time': datetime.now().strftime('%Y-%m-%dT%H:%M:%S'), # время, на которое выполняется запрос
			'app_id': app_id,
			'app_code': app_code,
			'routing': 'tt' # маршрутизация по расписанию
		}

response = requests.get(url, params=query)
data = response.json()
status = data["Res"]

if "Message" in status:
    print(status["Message"])
    exit(-1)

if "Connections" in status:
    route_dut_time = iso8601toSec( status["Connections"]["Connection"][0]["duration"] )

Хотелось бы отметить, что в данном запросе время выдается используя ISO 8601. Была реализована функция конвертации полученного продолжительности времени в секунды iso8601toSec.

Нахождение времени в пути с использованием личного транспорта

url = f"https://route.api.here.com/routing/7.2/calculateroute.json"
query = {
			'waypoint0': deplocation,
			'waypoint1': arrlocation,
			'mode': 'fastest;car;traffic:enabled', # определение быстрого маршрута с учетом пробок
			'app_id': app_id,
			'app_code': app_code,
			'departure': 'now' # время отправки
		}

response = requests.get(url, params=query)
data = response.json()
route_dur_time = data['response']['route'][0]['summary']['trafficTime']

В этом запросе со временем проблем нет, он возвращается в секундах.

Нахождение времени в пути с использованием собственных ног (пешая прогулка)

url = f"https://route.api.here.com/routing/7.2/calculateroute.json"
query = {
			'waypoint0': deplocation,
			'waypoint1': arrlocation,
			'mode': 'fastest;pedestrian', # пешеходный режим
			'app_id': app_id,
			'app_code': app_code
		}

response = requests.get(url, params=query)
data = response.json()
route_dur_time = data['response']['route'][0]['summary']['travelTime']

В этом запросе, как и в предыдущем примере, со временем проблем нет, он возвращается в секундах.

Итоги

На основе этих запросов, получили три времени необходимых для перемещения из точки А до точки Б. Вычислив из них минимальное время и тип перемещения, определяли за какое время необходимо выходить, чтобы успеть подойди до точки Б к указанному времени.