Просмотр кода страницы Развертывание GraphHopper в качестве веб-сервиса для построения маршрутов

== Запуск GraphHopper с помощью Jetty Runner ==

Jetty Runner предназначен для быстрого запуска Веб-приложений непосредственно из командной строки и не требует установки
полноценного Веб-сервера.

<ol>
  <li>Для дальнейшей работы создадим в домашней директории каталог ''graphhopper'' (все файлы, с которыми мы будем работать, должны быть размещены здесь). В Linux: <pre>mkdir ~/graphhopper</pre></li>
  <li>Воспользуемся версией Jetty Runner 9.1.2 [http://central.maven.org/maven2/org/eclipse/jetty/jetty-runner/9.1.2.v20140210/jetty-runner-9.1.2.v20140210.jar jetty-runner-9.1.2.v20140210.jar]. Поместим его в директорию ''graphhopper''. Отметим, что для запуска Jetty Runner данной версии в системе должна быть установлена JRE7 или JRE8. Если же у вас нет возможности обновить JRE, то для запуска Jetty Runner на JRE6 можно попробовать воспользоваться [http://repo2.maven.org/maven2/org/mortbay/jetty/jetty-runner/ старыми версиями] Jetty Runner.</li>
  <li>На сегодняшний день последняя стабильная версия GraphHopper - 0.2, master-версия имеет ряд проблем, например, неправильное указание направлений в описании маршрута [https://github.com/graphhopper/graphhopper/issues/171 #171] (уже вроде исправили) и поэтому мы будем работать именно с версией 0.2. Скачиваем [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war].</li>
  <li>Скачиваем пример конфигурационного файла GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties].</li>
  <li>Скачиваем данные проекта OpenStreetMap на основе которых будет осуществляться роутинг. Для примера возьмём [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москву].</li>
  <li>Запускаем GraphHopper: <pre>java -Dgraphhopper.config=config-example.properties -Dgraphhopper.osmreader.osm=RU-MOS-140322.osm.pbf -jar jetty-runner-9.1.2.v20140210.jar --port 8989 graphhopper-web-0.2.war</pre></li>
</ol>

Первый запуск займёт какое-то время (порядка 1 минуты), это связано с построением графа роутинга. Если в процессе запуска не возникло никаких ошибок, то открыв в браузере страницу по адресу http://localhost:8989/, вы увидите следующую картину:

[[Файл:Graphhopper-web-app.png|671px|thumb|center|<center>Веб-приложение GraphHopper</center>]]

По данному адресу (http://localhost:8989/) расположено Веб-приложение, с помощью которого можно указать начальную и конечную точки и просмотреть получившийся маршрут, а также его текстовое описание с указанием того куда и через сколько метров следует поворачивать. В некоторых случаях достаточно просто вставить ссылку на это приложение в свою страницу и тем самым предоставить клиентам возможность построения маршрутов.

Если же вы не хотите использовать Web-приложение GraphHopper, а только HTTP API, то вам следует ознакомиться со следующей [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md документацией]. Пример HTTP запроса к GraphHopper: http://localhost:8989/api/route?point=55.422779,37.254639&point=55.646599,38.023682&locale=ru-RU.

Также имеется API для получения информации об инстансе GraphHopper: http://localhost:8989/api/info.