GIS-Lab - Вклад [ru]

Полевой сбор данных через nextgis.com: простой сценарий

2018-03-10T11:02:53Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Пример использования платформы NextGIS для сбора данных в поле}}

Это статья описывает конкретную технологию сбора полевых данных. Статья исходит из следующих предпосылок относительно читателя:

* Читатель знает, что он собирает и какие параметры объектов ему нужны. Статья не ставит целью научить правильно собирать встречи волка или описывать рекламные конструкции.
* Читатель заинтересован в максимально быстром, но в том же время полностью лишенном файловых манипуляций процессе. Разумеется, у технологии сбора данных есть масса возможных вариантов, расширяющих её возможности. О них мы расскажем в следующих статьях.
* Читатель имеет базовые знания в области геоданных и знает, например, чем отличается полигон от линии и что такое атрибуты.

Концептуально полевой сбор данных очень прост и состоит из следующих шагов:

# Завести место, куда будут автоматически стекаться собранные данные (потому что помните? "лишенный файловых манипуляций процесс!")
# Придумать, что собираем
# Выйти в поле с устройством и начать собственно сбор

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

Разберём подробнее как это работает.

{{NextGIS}}

[[Файл:Nextgis field 04.png|500px|thumb|center|Сотрудники Проекта ИПЭЭ РАН «Исследование популяционной структуры волков Северо-Западного Прикаспия и влияние волков на популяцию сайгаков» за работой]]

== Шаг 1. Зарегистрироваться на nextgis.com и создать Веб ГИС ==
В качестве хранилища данных будет выступать облачная Веб ГИС nextgis.com ([http://nextgis.ru/nextgis-com/ подробнее о Веб ГИС]). Веб ГИС - это универсальная платформа для геоданных, которая умеет очень много всего. Управлять Веб ГИС можно через браузер. Для этой статьи мы будем использовать только одну её функцию - хранение данных.

Подробно процесс регистрации и создания Веб ГИС описан в статье [http://gis-lab.info/qa/nextgiscom.html Создание Веб ГИС на nextgis.com]. В этой статье так же можно почерпнуть подробности по использованию других функций Веб ГИС.

После того как у вас появилось красивое имя, такое как, например: [http://maxim.nextgis.com maxim.nextgis.com], можно переходить к следующим шагам.

[[Файл:Nextgis field 01.png|500px|thumb|center|Общий вид Веб ГИС с данными (если вы только начали, у вас их пока нет)]]

== Шаг 2. Скачиваем и устанавливаем NextGIS Mobile ==
[http://nextgis.ru/nextgis-mobile/ NextGIS Mobile] это мобильная ГИС - приложение, которое может работать как поставщик данных для вашей Веб ГИС, синхронизируя их по мере возможности.

Приложение можно установить через [https://play.google.com/store/apps/details?id=com.nextgis.mobile Google Play].

По приложению доступна подробная [http://docs.nextgis.ru/docs_ngmobile/source/toc.html документация]. В этой статье мы повторим основные шаги.

== Шаг 3. Собираем данных! ==

Этот и следующий шаг легко поменять местами, в зависимости от того как вам удобнее. Данные можно сначала собрать, а потом отправить в облако. А можно наоборот, сначала подключить пустой пока слой к облаку, а уже потом собирать данные. Порядок значения не имеет. Важно, что так или иначе, отправлять слой в Веб ГИС нужно только один раз. Когда вы решите пособирать данные на следующий день, если вы не удалили слой, он уже будет стоять на синхронизации.

=== Создать новый слой ===
Откройте список слоёв, нажмите кнопку + (добавить) и выберите Создать слой.

Следующее окно служит для создания нового слоя.

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

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

Для каждого поля нужно выбрать тип значений.

[[Файл:Nextgis field 02.png|390px|thumb|center|Создание слоя и параметров объектов (атрибутов)]]

=== Собираем данные ===

Сбор данных - это создание объектов в определенных слоях. Создание объекта в ГИС включает создание геометрии и создание связанных с ней атрибутов.

Сначала вы ставите точку (рисуете линию или полигон), потом заполняете её атрибуты.

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

#Нажать на большую синюю кнопку
#Выбрать карандаш (редактирование)
#Выбрать слой для редактирования (если их несколько, если он один, он автоматически включится на редактирование)
#Нажать +, добавится точка
#Подвинуть её если нужно
#Нажать на дискету (сохранить)
#Появится окно для ввода атрибутов, заполнить их, если нужно
#Нажать галочку (завершить редактирование объекта)

Подробно процесс редактирования расписан в [http://docs.nextgis.ru/docs_ngmobile/source/editing.html официальной документации].

[[Файл:Nextgis field 03.png|390px|thumb|center|Создание объекта на карте]]

== Шаг 4. Отправляем слой в свою Веб ГИС ==
Данные собраны и мы готовы залить их в облако.

Открываем список слоёв и в меню слоя (оно вызывается по нажатию на троеточие) выбираем Отправить в NextGIS.

Так как вы только начинаете, список Веб ГИС куда можно отправить данные будет пуст и вам нужно нажать "Добавить Веб ГИС", где ввести имя её домена (только часть до .nextgis.com) и имя/пароль пользователя имеющего права на создание ресурсов (администратора или другого пользователя с соответствующими правами).

После создания соединения, присоединенную Веб ГИС нужно просто выбрать в списке и выбрать в ней место куда вы хотели бы положить свой слой. Нажать Добавить.

После успешного появления слоя в Веб ГИС (это можно проверить просто зайдя в Веб ГИС через браузер и убедившись, что слой там появился), можно создавать новые точки, он будут автоматически отправляться в Веб ГИС. Добавляемые таким образом слои автоматически "встают" на синхронизацию. Частоту синхронизации можно изменить в настройках слоя.

== Шаг 5. Поделитесь слоем с коллегами ==

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

Чтобы это сделать, зайдите в панель управления своей Веб ГИС в браузере под администратором, создайте пользователей и добавьте их в группу редакторы. Раздайте созданные учетные записи коллегам.

Новый пользователь должен будет повторить шаги по загрузке и установке NextGIS Mobile, но вместо создания слоя, ему нужно сказать Добавить/Добавить из Веб ГИС и ввести параметры учетной записи которую вы для него создали. Пользователь сможет добавить созданный вами слой со всей информацией и продолжить наполнять его данными вместе с вами и другими пользователями.

== Цена вопроса ==
Всё необходимое для реализации описанного подхода, своя Веб ГИС, ПО NextGIS Mobile и т.д. доступно бесплатно. Вы можете начать ей пользоваться прямо сейчас.

Однако, и у Веб ГИС и у мобильного приложения есть ряд продвинутых функций недоступных на ознакомительном плане. Ознакомиться с перечнем дополнительных возможностей можно на [http://nextgis.ru/nextgis-com/plans странице планов].

== Заключение ==

В статье разобран самый простой способ организовать удобный сбор данных не требующий никаких файловых манипуляций.

Дальше собранные данные можно положить на веб-карты, выгрузить в Excel, проанализировать и многое другое. Используются для этого как механизмы Веб ГИС, так и приложений с ней связанных (NextGIS Mobile, QGIS и других). О них можно прочитать в [http://gis-lab.info/qa/nextgiscom.html специальной статье] и [http://docs.nextgis.ru документации].

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

[[Файл:Nextgis field 05.png|500px|thumb|center|Результаты сбора данных на автоматически обновляемой карте]]

Обновление перевода документации OSGeo Live

2015-11-18T05:23:36Z

Denis Rykov:

== О чём речь? ==

[http://live.osgeo.org/ru/index.html OSGeo-Live] — LiveCD на базе Ubuntu Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц.
В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой [http://ru.wikipedia.org/wiki/ReStructuredText reStructuredText].

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация [http://gis-lab.info/qa/osgeo-live-docs-coord.html была переведена] на русский язык.

Цель данного мини-проекта — '''обновление''' русскоязычного перевода документации, которые значительно устарел.
Обновлённая документация появится на диске с OSGeo-Live 9.0, который будет раздаваться на конференции [http://gisconf.ru/ "Открытые ГИС 2015"]. Имена переводчиков будут (при их желании, естественно) увековечены в специальном файле ''translators.csv'' в следующем релизе OSGeo-Live.

== Схема работы ==
# Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка ''"рус. текст старый"'' пустая, то это новый файл, если не пустая - устаревший файл.
# Выбрать (никем не занятые) файлы для перевода (где пусто в графе ''"кто делает"'').
# Сообщить, что берёте такой-то файл, в [http://gis-lab.info/forum/viewtopic.php?f=51&t=20051 специальной теме] на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
# Скачать файл по ссылке в колонке ''"англ. текст новый" ''.
# Если файл новый, то надо просто перевести его, оставив имя файла таким же.
# Если файл устаревший, надо открыть ссылку в колонке ''"разница англ. текст старый/новый"'', там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке ''"рус. текст старый"'' и править его.
# При переводе желательно соблюдать правила, перечисленные ниже.
# Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 координатору].

'''Пожелание''': русский текст желательно присылать в кодировке UTF-8!

<big>Просьба: прислать переводы желательно '''НЕ ПОЗДНЕЕ 16 ноября'''!</big> Это связано с подготовкой к конференции "[http://gisconf.ru/ru/ Открытые ГИС - 2015]".

== Обновляемая онлайн-версия ==
[http://gis-lab.info/docs/osgeo/ru/ '''Онлайн-версия'''] переведённой документации будет обновляться по мере перевода.

== Координационная таблица ==

<span style="background-color:Yellow">Жёлтым</span> цветом отмечены файлы, находящиеся в переводе (занятые), <span style="background-color:LightGreen">зелёным</span> — переведённые и отредактированные.

<big>Всего: 85 файлов, в работе: 17, готово: 50, свободно: 18.</big>






{| class="wikitable" border="1" width="70%"
! class="head" | имя файла
! class="head" | англ. текст новый
! class="head" | разница англ. текст старый/новый
! class="head" | рус. текст старый
! class="head" | кто делает

|---- style="background-color:LightGreen"
| index.rst
|
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| overview.rst
| http://gis-lab.info/docs/osgeo/update_2015/edits/overview.rst
|
| http://gis-lab.info/docs/osgeo/update_2015/ru/overview/overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]

|---- style="background-color:LightGreen"
| mac_installers.rst
| http://gis-lab.info/docs/osgeo/update_2015/new/mac_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|metrics.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/metrics.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12297@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst&old=9149@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors_osgeo.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors_osgeo.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10081@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst&old=9974@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors_osgeo.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|win_installers.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/win_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|R_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|cartaro_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|cesium_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|geomajas_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12025@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomajas_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geomoose_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomoose_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonetwork_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12064@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonode_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:Yellow"
|grass_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12322@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/grass_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|ipython_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|iris_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|josm_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/josm_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|jts_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/jts_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|leaflet_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|mapwindow_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12237@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst&old=10725@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/mapwindow_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|marble_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12240@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/marble_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ncWMS_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|netcdf_dataset_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|openlayers_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12215@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst&old=11374@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/openlayers_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|otb_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12320@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/otb_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pycsw_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12419@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/pycsw_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|pywps_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|qgis_mapserver_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12278@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/qgis_mapserver_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|tilemill_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|52nSOS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nSOS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst&old=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nSOS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWPS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWPS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11624@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst&old=10606@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWPS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWSS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWSS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWSS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|IPython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/IPython_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|cartaro_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|cesium_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|deegree_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/deegree_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12028@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst&old=11685@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/deegree_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|eoxserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/eoxserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11866@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst&old=10819@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/eoxserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gdal_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gdal_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9908@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gdal_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:Yellow"
|geokettle_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geokettle_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10557@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geokettle_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomajas_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12026@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomajas_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomoose_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomoose_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonetwork_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12307@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geonetwork_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonode_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gmt_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gmt_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9730@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gmt_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|gpsdrive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsdrive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11315@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsdrive_quickstart.rst
|
|----
|gpsprune_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsprune_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11871@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsprune_quickstart.rst
|
|---- style="background-color:Yellow"
|grass_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12264@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/grass_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|----
|gvsig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gvsig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11060@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gvsig_quickstart.rst
|
|----
|internationalisation_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/internationalisation_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11951@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/internationalisation_quickstart.rst
|
|----
|iris_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|leaflet_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|mapfish_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapfish_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11351@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst&old=9163@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapfish_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:Yellow"
|mapnik_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapnik_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11300@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst&old=10835@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapnik_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|mapwindow_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12125@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst&old=10229@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapwindow_quickstart.rst
|
|----
|marble_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12139@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/marble_quickstart.rst
|
|---- style="background-color:Yellow"
|mb-system_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mb-system_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10833@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mb-system_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|ncWMS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_quickstart.rst
|
|
|
|----
|opencpn_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/opencpn_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11774@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/opencpn_quickstart.rst
|
|----
|openlayers_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12226@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/openlayers_quickstart.rst
|
|----
|osgeolive_install_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_install_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_install_quickstart.rst
|
|---- style="background-color:Yellow"
|osgeolive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11771@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|osm_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osm_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10267@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osm_quickstart.rst
|
|----
|ossim_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ossim_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10841@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ossim_quickstart.rst
|
|---- style="background-color:LightGreen"
|otb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12357@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/otb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pgrouting_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pgrouting_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10527@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pgrouting_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|postgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/postgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11134@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst&old=10691@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/postgis_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|pycsw_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12418@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pycsw_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|pywps_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|qgis_mapserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11941@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_mapserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|qgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12407@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_quickstart.rst
|
|----
|rasdaman_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/rasdaman_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12199@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/rasdaman_quickstart.rst
|
|----
|saga_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/saga_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11959@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/saga_quickstart.rst
|
|---- style="background-color:Yellow"
|sahana_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sahana_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11378@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/sahana_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|spatialite_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/spatialite_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11777@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/spatialite_quickstart.rst
|
|---- style="background-color:Yellow"
|tilemill_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|tinyows_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/tinyows_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10845@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/tinyows_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|udig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/udig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12425@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst&old=10607@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/udig_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|usb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/usb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11773@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/usb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ushahidi_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ushahidi_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9940@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ushahidi_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|viking_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/viking_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9764@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/viking_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|virtualbox_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/virtualbox_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11782@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/virtualbox_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|zoo-project_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zoo-project_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zoo-project_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|zygrib_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zygrib_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9744@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zygrib_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| download.rst
| https://raw.githubusercontent.com/amuriy/OSGeoLive-doc/master/en/download.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|}

== Как переводим? ==
=== Главные правила ===

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:
* НЕ переводятся имена файлов;
* оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
* ВСЕ отступы в тексте должны сохраняться;
* НЕ переносим строки в списках;
* в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
* НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
* НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа
<pre>
:scale: 80
</pre>
, кроме строк с ":alt:", которые представляют собой подписи к рисункам:
<pre>
:alt: Web services framework of OGC geoprocessing standards
</pre>
* в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,
"image" здесь
<pre>
.. image:: ../../images/screenshots/800x600/saga_fullextent.png
</pre>
или "tip" здесь
<pre>
.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.
</pre>
* также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

=== Повторяющиеся фрагменты ===
В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:
<pre>
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_
</pre>

Такие части надо переводить единообразно:

{| class="wikitable" border="1" width="40%"
|-
| Quickstart
| Начало работы
|-
| Quickstart documentation
| Введение
|-
| Details
| Дополнительная информация
|-
| Core features
| Базовые функции
|-
| Version
| Версия
|-
| Website
| Веб-сайт
|-
| Licence
| Лицензия
|-
| Software Version
| Версия ПО
|-
| Supported Platforms
| Поддерживаемые платформы
|-
| Support
| Поддержка
|-
| Documentation
| Документация
|-
| API Interfaces
| Интерфейсы API
|-
| Commercial Support
| Коммерческая поддержка
|-
| Community Support
| Поддержка сообщества
|-
| Community Website
| Сайт сообщества
|-
| Programing language support
| Поддержка языков программирования
|-
| Developers
| Разработчики
|-
| What Next?
| Что дальше?
|-
| Implemented Standards
| Реализованные стандарты
|}

В текстах упоминается много '''лицензий''' (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

'''Предложение по названиям лицензий''':

{| class="wikitable" border="1" width="70%"
! class="head" | Исходно
! class="head" | Меняем на:
! class="head" | Ссылка
|-
| AGPL
| AGPL
| http://www.fsf.org/news/agplv3-pr
|-
| Apache License, Version 2.0
| Apache, версия 2.0
| http://www.apache.org/licenses/LICENSE-2.0
|-
| BSD / BSD License / New BSD License / Simplified BSD license
| BSD
| http://ru.wikipedia.org/wiki/BSD_License
|-
| CeCILL
| CeCILL
| http://www.cecill.info/licences.en.html
|-
| custom
| собственная
| ссылка указана в тексте, оставляем её
|-
| GNU General Public License (GPL) version 2
| GPL версия 2
| http://www.gnu.org/licenses/gpl-2.0.html
|-
| GNU General Public License (GPL) version 3
| GPL версия 3
| http://www.gnu.org/licenses/gpl.html
|-
| GPL
| GPL
| http://www.gnu.org/licenses/gpl.html
|-
| GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)
| LGPL
| http://www.gnu.org/copyleft/lesser.html
|-
| MIT / MIT License / MIT x/11
| MIT
| http://opensource.org/licenses/mit-license.php
|-
| MIT based license / MIT-style license
| основанная на MIT
| ссылка указана в тексте, оставляем её
|-
| X/MIT style Open Source license
| в стиле X/MIT
| ссылка указана в тексте, оставляем её
|-
| MPLv1.1
| MPL версия 1.1
| http://www.mozilla.org/MPL/1.1/
|}

=== Найденные ошибки ===
Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на [http://wiki.gis-lab.info/w/%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8_OSGeo_Live--%D0%BD%D0%B0%D0%B9%D0%B4%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8 специальной странице] в вики.

Обновление перевода документации OSGeo Live

2015-11-18T05:14:28Z

Denis Rykov:

== О чём речь? ==

[http://live.osgeo.org/ru/index.html OSGeo-Live] — LiveCD на базе Ubuntu Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц.
В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой [http://ru.wikipedia.org/wiki/ReStructuredText reStructuredText].

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация [http://gis-lab.info/qa/osgeo-live-docs-coord.html была переведена] на русский язык.

Цель данного мини-проекта — '''обновление''' русскоязычного перевода документации, которые значительно устарел.
Обновлённая документация появится на диске с OSGeo-Live 9.0, который будет раздаваться на конференции [http://gisconf.ru/ "Открытые ГИС 2015"]. Имена переводчиков будут (при их желании, естественно) увековечены в специальном файле ''translators.csv'' в следующем релизе OSGeo-Live.

== Схема работы ==
# Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка ''"рус. текст старый"'' пустая, то это новый файл, если не пустая - устаревший файл.
# Выбрать (никем не занятые) файлы для перевода (где пусто в графе ''"кто делает"'').
# Сообщить, что берёте такой-то файл, в [http://gis-lab.info/forum/viewtopic.php?f=51&t=20051 специальной теме] на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
# Скачать файл по ссылке в колонке ''"англ. текст новый" ''.
# Если файл новый, то надо просто перевести его, оставив имя файла таким же.
# Если файл устаревший, надо открыть ссылку в колонке ''"разница англ. текст старый/новый"'', там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке ''"рус. текст старый"'' и править его.
# При переводе желательно соблюдать правила, перечисленные ниже.
# Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 координатору].

'''Пожелание''': русский текст желательно присылать в кодировке UTF-8!

<big>Просьба: прислать переводы желательно '''НЕ ПОЗДНЕЕ 16 ноября'''!</big> Это связано с подготовкой к конференции "[http://gisconf.ru/ru/ Открытые ГИС - 2015]".

== Обновляемая онлайн-версия ==
[http://gis-lab.info/docs/osgeo/ru/ '''Онлайн-версия'''] переведённой документации будет обновляться по мере перевода.

== Координационная таблица ==

<span style="background-color:Yellow">Жёлтым</span> цветом отмечены файлы, находящиеся в переводе (занятые), <span style="background-color:LightGreen">зелёным</span> — переведённые и отредактированные.

<big>Всего: 85 файлов, в работе: 17, готово: 50, свободно: 19.</big>






{| class="wikitable" border="1" width="70%"
! class="head" | имя файла
! class="head" | англ. текст новый
! class="head" | разница англ. текст старый/новый
! class="head" | рус. текст старый
! class="head" | кто делает

|---- style="background-color:LightGreen"
| index.rst
|
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| overview.rst
| http://gis-lab.info/docs/osgeo/update_2015/edits/overview.rst
|
| http://gis-lab.info/docs/osgeo/update_2015/ru/overview/overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]

|---- style="background-color:LightGreen"
| mac_installers.rst
| http://gis-lab.info/docs/osgeo/update_2015/new/mac_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|metrics.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/metrics.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12297@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst&old=9149@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors_osgeo.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors_osgeo.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10081@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst&old=9974@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors_osgeo.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|win_installers.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/win_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|R_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|cartaro_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|cesium_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|geomajas_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12025@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomajas_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geomoose_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomoose_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonetwork_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12064@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonode_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:Yellow"
|grass_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12322@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/grass_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|ipython_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|iris_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|josm_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/josm_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|jts_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/jts_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|leaflet_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|mapwindow_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12237@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst&old=10725@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/mapwindow_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|marble_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12240@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/marble_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ncWMS_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|netcdf_dataset_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|openlayers_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12215@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst&old=11374@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/openlayers_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|otb_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12320@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/otb_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pycsw_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12419@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/pycsw_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|pywps_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|qgis_mapserver_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12278@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/qgis_mapserver_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|tilemill_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|52nSOS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nSOS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst&old=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nSOS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWPS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWPS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11624@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst&old=10606@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWPS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWSS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWSS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWSS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|IPython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/IPython_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|cartaro_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|cesium_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|deegree_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/deegree_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12028@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst&old=11685@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/deegree_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|eoxserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/eoxserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11866@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst&old=10819@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/eoxserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gdal_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gdal_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9908@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gdal_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:Yellow"
|geokettle_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geokettle_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10557@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geokettle_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomajas_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12026@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomajas_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomoose_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomoose_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonetwork_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12307@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geonetwork_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonode_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gmt_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gmt_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9730@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gmt_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|gpsdrive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsdrive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11315@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsdrive_quickstart.rst
|
|----
|gpsprune_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsprune_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11871@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsprune_quickstart.rst
|
|---- style="background-color:Yellow"
|grass_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12264@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/grass_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|----
|gvsig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gvsig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11060@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gvsig_quickstart.rst
|
|----
|internationalisation_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/internationalisation_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11951@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/internationalisation_quickstart.rst
|
|----
|iris_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|leaflet_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|mapfish_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapfish_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11351@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst&old=9163@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapfish_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:Yellow"
|mapnik_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapnik_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11300@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst&old=10835@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapnik_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|mapwindow_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12125@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst&old=10229@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapwindow_quickstart.rst
|
|----
|marble_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12139@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/marble_quickstart.rst
|
|---- style="background-color:Yellow"
|mb-system_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mb-system_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10833@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mb-system_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|ncWMS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_quickstart.rst
|
|
|
|----
|opencpn_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/opencpn_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11774@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/opencpn_quickstart.rst
|
|----
|openlayers_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12226@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/openlayers_quickstart.rst
|
|----
|osgeolive_install_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_install_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_install_quickstart.rst
|
|---- style="background-color:Yellow"
|osgeolive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11771@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|osm_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osm_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10267@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osm_quickstart.rst
|
|----
|ossim_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ossim_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10841@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ossim_quickstart.rst
|
|---- style="background-color:LightGreen"
|otb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12357@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/otb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pgrouting_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pgrouting_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10527@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pgrouting_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|postgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/postgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11134@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst&old=10691@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/postgis_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|pycsw_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12418@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pycsw_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|pywps_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|qgis_mapserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11941@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_mapserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|qgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12407@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_quickstart.rst
|
|----
|rasdaman_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/rasdaman_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12199@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/rasdaman_quickstart.rst
|
|----
|saga_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/saga_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11959@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/saga_quickstart.rst
|
|---- style="background-color:Yellow"
|sahana_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sahana_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11378@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/sahana_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|spatialite_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/spatialite_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11777@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/spatialite_quickstart.rst
|
|---- style="background-color:Yellow"
|tilemill_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|tinyows_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/tinyows_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10845@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/tinyows_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|udig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/udig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12425@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst&old=10607@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/udig_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|usb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/usb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11773@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/usb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ushahidi_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ushahidi_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9940@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ushahidi_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|viking_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/viking_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9764@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/viking_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|virtualbox_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/virtualbox_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11782@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/virtualbox_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|zoo-project_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zoo-project_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zoo-project_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|zygrib_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zygrib_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9744@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zygrib_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| download.rst
| https://raw.githubusercontent.com/amuriy/OSGeoLive-doc/master/en/download.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|}

== Как переводим? ==
=== Главные правила ===

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:
* НЕ переводятся имена файлов;
* оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
* ВСЕ отступы в тексте должны сохраняться;
* НЕ переносим строки в списках;
* в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
* НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
* НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа
<pre>
:scale: 80
</pre>
, кроме строк с ":alt:", которые представляют собой подписи к рисункам:
<pre>
:alt: Web services framework of OGC geoprocessing standards
</pre>
* в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,
"image" здесь
<pre>
.. image:: ../../images/screenshots/800x600/saga_fullextent.png
</pre>
или "tip" здесь
<pre>
.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.
</pre>
* также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

=== Повторяющиеся фрагменты ===
В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:
<pre>
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_
</pre>

Такие части надо переводить единообразно:

{| class="wikitable" border="1" width="40%"
|-
| Quickstart
| Начало работы
|-
| Quickstart documentation
| Введение
|-
| Details
| Дополнительная информация
|-
| Core features
| Базовые функции
|-
| Version
| Версия
|-
| Website
| Веб-сайт
|-
| Licence
| Лицензия
|-
| Software Version
| Версия ПО
|-
| Supported Platforms
| Поддерживаемые платформы
|-
| Support
| Поддержка
|-
| Documentation
| Документация
|-
| API Interfaces
| Интерфейсы API
|-
| Commercial Support
| Коммерческая поддержка
|-
| Community Support
| Поддержка сообщества
|-
| Community Website
| Сайт сообщества
|-
| Programing language support
| Поддержка языков программирования
|-
| Developers
| Разработчики
|-
| What Next?
| Что дальше?
|-
| Implemented Standards
| Реализованные стандарты
|}

В текстах упоминается много '''лицензий''' (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

'''Предложение по названиям лицензий''':

{| class="wikitable" border="1" width="70%"
! class="head" | Исходно
! class="head" | Меняем на:
! class="head" | Ссылка
|-
| AGPL
| AGPL
| http://www.fsf.org/news/agplv3-pr
|-
| Apache License, Version 2.0
| Apache, версия 2.0
| http://www.apache.org/licenses/LICENSE-2.0
|-
| BSD / BSD License / New BSD License / Simplified BSD license
| BSD
| http://ru.wikipedia.org/wiki/BSD_License
|-
| CeCILL
| CeCILL
| http://www.cecill.info/licences.en.html
|-
| custom
| собственная
| ссылка указана в тексте, оставляем её
|-
| GNU General Public License (GPL) version 2
| GPL версия 2
| http://www.gnu.org/licenses/gpl-2.0.html
|-
| GNU General Public License (GPL) version 3
| GPL версия 3
| http://www.gnu.org/licenses/gpl.html
|-
| GPL
| GPL
| http://www.gnu.org/licenses/gpl.html
|-
| GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)
| LGPL
| http://www.gnu.org/copyleft/lesser.html
|-
| MIT / MIT License / MIT x/11
| MIT
| http://opensource.org/licenses/mit-license.php
|-
| MIT based license / MIT-style license
| основанная на MIT
| ссылка указана в тексте, оставляем её
|-
| X/MIT style Open Source license
| в стиле X/MIT
| ссылка указана в тексте, оставляем её
|-
| MPLv1.1
| MPL версия 1.1
| http://www.mozilla.org/MPL/1.1/
|}

=== Найденные ошибки ===
Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на [http://wiki.gis-lab.info/w/%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8_OSGeo_Live--%D0%BD%D0%B0%D0%B9%D0%B4%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8 специальной странице] в вики.

Обновление перевода документации OSGeo Live

2015-11-18T05:12:21Z

Denis Rykov:

== О чём речь? ==

[http://live.osgeo.org/ru/index.html OSGeo-Live] — LiveCD на базе Ubuntu Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц.
В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой [http://ru.wikipedia.org/wiki/ReStructuredText reStructuredText].

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация [http://gis-lab.info/qa/osgeo-live-docs-coord.html была переведена] на русский язык.

Цель данного мини-проекта — '''обновление''' русскоязычного перевода документации, которые значительно устарел.
Обновлённая документация появится на диске с OSGeo-Live 9.0, который будет раздаваться на конференции [http://gisconf.ru/ "Открытые ГИС 2015"]. Имена переводчиков будут (при их желании, естественно) увековечены в специальном файле ''translators.csv'' в следующем релизе OSGeo-Live.

== Схема работы ==
# Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка ''"рус. текст старый"'' пустая, то это новый файл, если не пустая - устаревший файл.
# Выбрать (никем не занятые) файлы для перевода (где пусто в графе ''"кто делает"'').
# Сообщить, что берёте такой-то файл, в [http://gis-lab.info/forum/viewtopic.php?f=51&t=20051 специальной теме] на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
# Скачать файл по ссылке в колонке ''"англ. текст новый" ''.
# Если файл новый, то надо просто перевести его, оставив имя файла таким же.
# Если файл устаревший, надо открыть ссылку в колонке ''"разница англ. текст старый/новый"'', там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке ''"рус. текст старый"'' и править его.
# При переводе желательно соблюдать правила, перечисленные ниже.
# Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 координатору].

'''Пожелание''': русский текст желательно присылать в кодировке UTF-8!

<big>Просьба: прислать переводы желательно '''НЕ ПОЗДНЕЕ 16 ноября'''!</big> Это связано с подготовкой к конференции "[http://gisconf.ru/ru/ Открытые ГИС - 2015]".

== Обновляемая онлайн-версия ==
[http://gis-lab.info/docs/osgeo/ru/ '''Онлайн-версия'''] переведённой документации будет обновляться по мере перевода.

== Координационная таблица ==

<span style="background-color:Yellow">Жёлтым</span> цветом отмечены файлы, находящиеся в переводе (занятые), <span style="background-color:LightGreen">зелёным</span> — переведённые и отредактированные.

<big>Всего: 85 файлов, в работе: 17, готово: 50, свободно: 19.</big>






{| class="wikitable" border="1" width="70%"
! class="head" | имя файла
! class="head" | англ. текст новый
! class="head" | разница англ. текст старый/новый
! class="head" | рус. текст старый
! class="head" | кто делает

|---- style="background-color:LightGreen"
| index.rst
|
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| overview.rst
| http://gis-lab.info/docs/osgeo/update_2015/edits/overview.rst
|
| http://gis-lab.info/docs/osgeo/update_2015/ru/overview/overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]

|---- style="background-color:LightGreen"
| mac_installers.rst
| http://gis-lab.info/docs/osgeo/update_2015/new/mac_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|metrics.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/metrics.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12297@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst&old=9149@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors_osgeo.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors_osgeo.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10081@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst&old=9974@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors_osgeo.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|win_installers.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/win_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|R_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|cartaro_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|cesium_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|geomajas_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12025@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomajas_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geomoose_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomoose_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonetwork_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12064@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonode_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:Yellow"
|grass_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12322@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/grass_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|ipython_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|iris_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|josm_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/josm_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|jts_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/jts_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|leaflet_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|mapwindow_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12237@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst&old=10725@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/mapwindow_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|marble_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12240@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/marble_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ncWMS_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|netcdf_dataset_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|openlayers_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12215@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst&old=11374@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/openlayers_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|otb_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12320@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/otb_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pycsw_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12419@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/pycsw_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|pywps_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|qgis_mapserver_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12278@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/qgis_mapserver_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|tilemill_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|52nSOS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nSOS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst&old=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nSOS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWPS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWPS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11624@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst&old=10606@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWPS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWSS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWSS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWSS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|IPython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/IPython_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|cartaro_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|cesium_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|deegree_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/deegree_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12028@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst&old=11685@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/deegree_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|eoxserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/eoxserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11866@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst&old=10819@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/eoxserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gdal_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gdal_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9908@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gdal_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:Yellow"
|geokettle_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geokettle_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10557@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geokettle_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomajas_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12026@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomajas_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomoose_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomoose_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonetwork_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12307@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geonetwork_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonode_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gmt_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gmt_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9730@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gmt_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|gpsdrive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsdrive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11315@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsdrive_quickstart.rst
|
|----
|gpsprune_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsprune_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11871@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsprune_quickstart.rst
|
|---- style="background-color:Yellow"
|grass_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12264@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/grass_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|----
|gvsig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gvsig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11060@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gvsig_quickstart.rst
|
|----
|internationalisation_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/internationalisation_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11951@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/internationalisation_quickstart.rst
|
|----
|iris_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|leaflet_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|mapfish_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapfish_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11351@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst&old=9163@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapfish_quickstart.rst
|
|---- style="background-color:Yellow"
|mapnik_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapnik_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11300@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst&old=10835@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapnik_quickstart.rst
|
|----
|mapwindow_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12125@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst&old=10229@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapwindow_quickstart.rst
|
|----
|marble_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12139@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/marble_quickstart.rst
|
|---- style="background-color:Yellow"
|mb-system_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mb-system_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10833@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mb-system_quickstart.rst
|
|----
|ncWMS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_quickstart.rst
|
|
|
|----
|opencpn_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/opencpn_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11774@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/opencpn_quickstart.rst
|
|----
|openlayers_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12226@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/openlayers_quickstart.rst
|
|----
|osgeolive_install_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_install_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_install_quickstart.rst
|
|---- style="background-color:Yellow"
|osgeolive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11771@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_quickstart.rst
|
|----
|osm_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osm_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10267@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osm_quickstart.rst
|
|----
|ossim_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ossim_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10841@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ossim_quickstart.rst
|
|---- style="background-color:LightGreen"
|otb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12357@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/otb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pgrouting_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pgrouting_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10527@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pgrouting_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|postgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/postgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11134@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst&old=10691@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/postgis_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|pycsw_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12418@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pycsw_quickstart.rst
|
|----
|pywps_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|qgis_mapserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11941@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_mapserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|qgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12407@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_quickstart.rst
|
|----
|rasdaman_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/rasdaman_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12199@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/rasdaman_quickstart.rst
|
|----
|saga_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/saga_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11959@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/saga_quickstart.rst
|
|---- style="background-color:Yellow"
|sahana_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sahana_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11378@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/sahana_quickstart.rst
|
|----
|spatialite_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/spatialite_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11777@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/spatialite_quickstart.rst
|
|---- style="background-color:Yellow"
|tilemill_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|tinyows_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/tinyows_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10845@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/tinyows_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|udig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/udig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12425@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst&old=10607@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/udig_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|usb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/usb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11773@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/usb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ushahidi_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ushahidi_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9940@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ushahidi_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|viking_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/viking_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9764@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/viking_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|virtualbox_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/virtualbox_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11782@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/virtualbox_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|zoo-project_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zoo-project_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zoo-project_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|zygrib_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zygrib_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9744@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zygrib_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| download.rst
| https://raw.githubusercontent.com/amuriy/OSGeoLive-doc/master/en/download.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|}

== Как переводим? ==
=== Главные правила ===

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:
* НЕ переводятся имена файлов;
* оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
* ВСЕ отступы в тексте должны сохраняться;
* НЕ переносим строки в списках;
* в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
* НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
* НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа
<pre>
:scale: 80
</pre>
, кроме строк с ":alt:", которые представляют собой подписи к рисункам:
<pre>
:alt: Web services framework of OGC geoprocessing standards
</pre>
* в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,
"image" здесь
<pre>
.. image:: ../../images/screenshots/800x600/saga_fullextent.png
</pre>
или "tip" здесь
<pre>
.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.
</pre>
* также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

=== Повторяющиеся фрагменты ===
В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:
<pre>
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_
</pre>

Такие части надо переводить единообразно:

{| class="wikitable" border="1" width="40%"
|-
| Quickstart
| Начало работы
|-
| Quickstart documentation
| Введение
|-
| Details
| Дополнительная информация
|-
| Core features
| Базовые функции
|-
| Version
| Версия
|-
| Website
| Веб-сайт
|-
| Licence
| Лицензия
|-
| Software Version
| Версия ПО
|-
| Supported Platforms
| Поддерживаемые платформы
|-
| Support
| Поддержка
|-
| Documentation
| Документация
|-
| API Interfaces
| Интерфейсы API
|-
| Commercial Support
| Коммерческая поддержка
|-
| Community Support
| Поддержка сообщества
|-
| Community Website
| Сайт сообщества
|-
| Programing language support
| Поддержка языков программирования
|-
| Developers
| Разработчики
|-
| What Next?
| Что дальше?
|-
| Implemented Standards
| Реализованные стандарты
|}

В текстах упоминается много '''лицензий''' (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

'''Предложение по названиям лицензий''':

{| class="wikitable" border="1" width="70%"
! class="head" | Исходно
! class="head" | Меняем на:
! class="head" | Ссылка
|-
| AGPL
| AGPL
| http://www.fsf.org/news/agplv3-pr
|-
| Apache License, Version 2.0
| Apache, версия 2.0
| http://www.apache.org/licenses/LICENSE-2.0
|-
| BSD / BSD License / New BSD License / Simplified BSD license
| BSD
| http://ru.wikipedia.org/wiki/BSD_License
|-
| CeCILL
| CeCILL
| http://www.cecill.info/licences.en.html
|-
| custom
| собственная
| ссылка указана в тексте, оставляем её
|-
| GNU General Public License (GPL) version 2
| GPL версия 2
| http://www.gnu.org/licenses/gpl-2.0.html
|-
| GNU General Public License (GPL) version 3
| GPL версия 3
| http://www.gnu.org/licenses/gpl.html
|-
| GPL
| GPL
| http://www.gnu.org/licenses/gpl.html
|-
| GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)
| LGPL
| http://www.gnu.org/copyleft/lesser.html
|-
| MIT / MIT License / MIT x/11
| MIT
| http://opensource.org/licenses/mit-license.php
|-
| MIT based license / MIT-style license
| основанная на MIT
| ссылка указана в тексте, оставляем её
|-
| X/MIT style Open Source license
| в стиле X/MIT
| ссылка указана в тексте, оставляем её
|-
| MPLv1.1
| MPL версия 1.1
| http://www.mozilla.org/MPL/1.1/
|}

=== Найденные ошибки ===
Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на [http://wiki.gis-lab.info/w/%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8_OSGeo_Live--%D0%BD%D0%B0%D0%B9%D0%B4%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8 специальной странице] в вики.

Обновление перевода документации OSGeo Live

2015-11-18T05:11:39Z

Denis Rykov:

== О чём речь? ==

[http://live.osgeo.org/ru/index.html OSGeo-Live] — LiveCD на базе Ubuntu Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц.
В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой [http://ru.wikipedia.org/wiki/ReStructuredText reStructuredText].

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация [http://gis-lab.info/qa/osgeo-live-docs-coord.html была переведена] на русский язык.

Цель данного мини-проекта — '''обновление''' русскоязычного перевода документации, которые значительно устарел.
Обновлённая документация появится на диске с OSGeo-Live 9.0, который будет раздаваться на конференции [http://gisconf.ru/ "Открытые ГИС 2015"]. Имена переводчиков будут (при их желании, естественно) увековечены в специальном файле ''translators.csv'' в следующем релизе OSGeo-Live.

== Схема работы ==
# Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка ''"рус. текст старый"'' пустая, то это новый файл, если не пустая - устаревший файл.
# Выбрать (никем не занятые) файлы для перевода (где пусто в графе ''"кто делает"'').
# Сообщить, что берёте такой-то файл, в [http://gis-lab.info/forum/viewtopic.php?f=51&t=20051 специальной теме] на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
# Скачать файл по ссылке в колонке ''"англ. текст новый" ''.
# Если файл новый, то надо просто перевести его, оставив имя файла таким же.
# Если файл устаревший, надо открыть ссылку в колонке ''"разница англ. текст старый/новый"'', там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке ''"рус. текст старый"'' и править его.
# При переводе желательно соблюдать правила, перечисленные ниже.
# Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 координатору].

'''Пожелание''': русский текст желательно присылать в кодировке UTF-8!

<big>Просьба: прислать переводы желательно '''НЕ ПОЗДНЕЕ 16 ноября'''!</big> Это связано с подготовкой к конференции "[http://gisconf.ru/ru/ Открытые ГИС - 2015]".

== Обновляемая онлайн-версия ==
[http://gis-lab.info/docs/osgeo/ru/ '''Онлайн-версия'''] переведённой документации будет обновляться по мере перевода.

== Координационная таблица ==

<span style="background-color:Yellow">Жёлтым</span> цветом отмечены файлы, находящиеся в переводе (занятые), <span style="background-color:LightGreen">зелёным</span> — переведённые и отредактированные.

<big>Всего: 85 файлов, в работе: 11, готово: 50, свободно: 24.</big>






{| class="wikitable" border="1" width="70%"
! class="head" | имя файла
! class="head" | англ. текст новый
! class="head" | разница англ. текст старый/новый
! class="head" | рус. текст старый
! class="head" | кто делает

|---- style="background-color:LightGreen"
| index.rst
|
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| overview.rst
| http://gis-lab.info/docs/osgeo/update_2015/edits/overview.rst
|
| http://gis-lab.info/docs/osgeo/update_2015/ru/overview/overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]

|---- style="background-color:LightGreen"
| mac_installers.rst
| http://gis-lab.info/docs/osgeo/update_2015/new/mac_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|metrics.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/metrics.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12297@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst&old=9149@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors_osgeo.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors_osgeo.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10081@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst&old=9974@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors_osgeo.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|win_installers.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/win_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|R_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|cartaro_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|cesium_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|geomajas_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12025@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomajas_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geomoose_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomoose_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonetwork_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12064@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonode_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:Yellow"
|grass_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12322@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/grass_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|ipython_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|iris_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|josm_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/josm_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|jts_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/jts_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|leaflet_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|mapwindow_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12237@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst&old=10725@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/mapwindow_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|marble_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12240@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/marble_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ncWMS_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|netcdf_dataset_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|openlayers_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12215@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst&old=11374@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/openlayers_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|otb_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12320@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/otb_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pycsw_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12419@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/pycsw_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|pywps_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|qgis_mapserver_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12278@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/qgis_mapserver_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|tilemill_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|52nSOS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nSOS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst&old=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nSOS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWPS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWPS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11624@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst&old=10606@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWPS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWSS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWSS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWSS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|IPython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/IPython_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|cartaro_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|cesium_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|deegree_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/deegree_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12028@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst&old=11685@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/deegree_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|eoxserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/eoxserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11866@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst&old=10819@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/eoxserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gdal_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gdal_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9908@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gdal_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:Yellow"
|geokettle_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geokettle_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10557@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geokettle_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomajas_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12026@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomajas_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geomoose_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomoose_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonetwork_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12307@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geonetwork_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonode_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|gmt_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gmt_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9730@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gmt_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|gpsdrive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsdrive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11315@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsdrive_quickstart.rst
|
|----
|gpsprune_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsprune_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11871@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsprune_quickstart.rst
|
|---- style="background-color:Yellow"
|grass_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12264@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/grass_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|----
|gvsig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gvsig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11060@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gvsig_quickstart.rst
|
|----
|internationalisation_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/internationalisation_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11951@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/internationalisation_quickstart.rst
|
|----
|iris_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|leaflet_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|mapfish_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapfish_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11351@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst&old=9163@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapfish_quickstart.rst
|
|---- style="background-color:Yellow"
|mapnik_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapnik_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11300@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst&old=10835@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapnik_quickstart.rst
|
|----
|mapwindow_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12125@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst&old=10229@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapwindow_quickstart.rst
|
|----
|marble_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12139@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/marble_quickstart.rst
|
|---- style="background-color:Yellow"
|mb-system_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mb-system_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10833@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mb-system_quickstart.rst
|
|----
|ncWMS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_quickstart.rst
|
|
|
|----
|opencpn_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/opencpn_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11774@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/opencpn_quickstart.rst
|
|----
|openlayers_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12226@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/openlayers_quickstart.rst
|
|----
|osgeolive_install_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_install_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_install_quickstart.rst
|
|---- style="background-color:Yellow"
|osgeolive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11771@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_quickstart.rst
|
|----
|osm_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osm_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10267@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osm_quickstart.rst
|
|----
|ossim_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ossim_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10841@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ossim_quickstart.rst
|
|---- style="background-color:LightGreen"
|otb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12357@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/otb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pgrouting_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pgrouting_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10527@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pgrouting_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|postgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/postgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11134@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst&old=10691@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/postgis_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|pycsw_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12418@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pycsw_quickstart.rst
|
|----
|pywps_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|qgis_mapserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11941@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_mapserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|qgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12407@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_quickstart.rst
|
|----
|rasdaman_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/rasdaman_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12199@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/rasdaman_quickstart.rst
|
|----
|saga_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/saga_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11959@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/saga_quickstart.rst
|
|---- style="background-color:Yellow"
|sahana_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sahana_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11378@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/sahana_quickstart.rst
|
|----
|spatialite_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/spatialite_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11777@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/spatialite_quickstart.rst
|
|---- style="background-color:Yellow"
|tilemill_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|tinyows_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/tinyows_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10845@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/tinyows_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|udig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/udig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12425@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst&old=10607@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/udig_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|usb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/usb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11773@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/usb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ushahidi_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ushahidi_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9940@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ushahidi_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|viking_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/viking_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9764@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/viking_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|virtualbox_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/virtualbox_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11782@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/virtualbox_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|zoo-project_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zoo-project_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zoo-project_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|zygrib_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zygrib_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9744@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zygrib_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
| download.rst
| https://raw.githubusercontent.com/amuriy/OSGeoLive-doc/master/en/download.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|}

== Как переводим? ==
=== Главные правила ===

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:
* НЕ переводятся имена файлов;
* оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
* ВСЕ отступы в тексте должны сохраняться;
* НЕ переносим строки в списках;
* в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
* НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
* НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа
<pre>
:scale: 80
</pre>
, кроме строк с ":alt:", которые представляют собой подписи к рисункам:
<pre>
:alt: Web services framework of OGC geoprocessing standards
</pre>
* в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,
"image" здесь
<pre>
.. image:: ../../images/screenshots/800x600/saga_fullextent.png
</pre>
или "tip" здесь
<pre>
.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.
</pre>
* также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

=== Повторяющиеся фрагменты ===
В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:
<pre>
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_
</pre>

Такие части надо переводить единообразно:

{| class="wikitable" border="1" width="40%"
|-
| Quickstart
| Начало работы
|-
| Quickstart documentation
| Введение
|-
| Details
| Дополнительная информация
|-
| Core features
| Базовые функции
|-
| Version
| Версия
|-
| Website
| Веб-сайт
|-
| Licence
| Лицензия
|-
| Software Version
| Версия ПО
|-
| Supported Platforms
| Поддерживаемые платформы
|-
| Support
| Поддержка
|-
| Documentation
| Документация
|-
| API Interfaces
| Интерфейсы API
|-
| Commercial Support
| Коммерческая поддержка
|-
| Community Support
| Поддержка сообщества
|-
| Community Website
| Сайт сообщества
|-
| Programing language support
| Поддержка языков программирования
|-
| Developers
| Разработчики
|-
| What Next?
| Что дальше?
|-
| Implemented Standards
| Реализованные стандарты
|}

В текстах упоминается много '''лицензий''' (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

'''Предложение по названиям лицензий''':

{| class="wikitable" border="1" width="70%"
! class="head" | Исходно
! class="head" | Меняем на:
! class="head" | Ссылка
|-
| AGPL
| AGPL
| http://www.fsf.org/news/agplv3-pr
|-
| Apache License, Version 2.0
| Apache, версия 2.0
| http://www.apache.org/licenses/LICENSE-2.0
|-
| BSD / BSD License / New BSD License / Simplified BSD license
| BSD
| http://ru.wikipedia.org/wiki/BSD_License
|-
| CeCILL
| CeCILL
| http://www.cecill.info/licences.en.html
|-
| custom
| собственная
| ссылка указана в тексте, оставляем её
|-
| GNU General Public License (GPL) version 2
| GPL версия 2
| http://www.gnu.org/licenses/gpl-2.0.html
|-
| GNU General Public License (GPL) version 3
| GPL версия 3
| http://www.gnu.org/licenses/gpl.html
|-
| GPL
| GPL
| http://www.gnu.org/licenses/gpl.html
|-
| GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)
| LGPL
| http://www.gnu.org/copyleft/lesser.html
|-
| MIT / MIT License / MIT x/11
| MIT
| http://opensource.org/licenses/mit-license.php
|-
| MIT based license / MIT-style license
| основанная на MIT
| ссылка указана в тексте, оставляем её
|-
| X/MIT style Open Source license
| в стиле X/MIT
| ссылка указана в тексте, оставляем её
|-
| MPLv1.1
| MPL версия 1.1
| http://www.mozilla.org/MPL/1.1/
|}

=== Найденные ошибки ===
Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на [http://wiki.gis-lab.info/w/%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8_OSGeo_Live--%D0%BD%D0%B0%D0%B9%D0%B4%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8 специальной странице] в вики.

Обновление перевода документации OSGeo Live

2015-11-11T22:34:53Z

Denis Rykov: /* Координационная таблица */

== О чём речь? ==

[http://live.osgeo.org/ru/index.html OSGeo-Live] — LiveCD на базе Ubuntu Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц.
В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой [http://ru.wikipedia.org/wiki/ReStructuredText reStructuredText].

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация [http://gis-lab.info/qa/osgeo-live-docs-coord.html была переведена] на русский язык.

Цель данного мини-проекта — '''обновление''' русскоязычного перевода документации, которые значительно устарел.
Обновлённая документация появится на диске с OSGeo-Live 9.0, который будет раздаваться на конференции [http://gisconf.ru/ "Открытые ГИС 2015"]. Имена переводчиков будут (при их желании, естественно) увековечены в специальном файле ''translators.csv'' в следующем релизе OSGeo-Live.

== Схема работы ==
# Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка ''"рус. текст старый"'' пустая, то это новый файл, если не пустая - устаревший файл.
# Выбрать (никем не занятые) файлы для перевода (где пусто в графе ''"кто делает"'').
# Сообщить, что берёте такой-то файл, в [http://gis-lab.info/forum/viewtopic.php?f=3&t=11526&p=71535#p71479 специальной теме] на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
# Скачать файл по ссылке в колонке ''"англ. текст новый" ''.
# Если файл новый, то надо просто перевести его, оставив имя файла таким же.
# Если файл устаревший, надо открыть ссылку в колонке ''"разница англ. текст старый/новый"'', там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке ''"рус. текст старый"'' и править его.
# При переводе желательно соблюдать правила, перечисленные ниже.
# Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 координатору].

'''Пожелание''': русский текст желательно присылать в кодировке UTF-8!

<big>Просьба: прислать переводы желательно '''НЕ ПОЗДНЕЕ 16 ноября'''!</big> Это связано с подготовкой к конференции "[http://gisconf.ru/ru/ Открытые ГИС - 2015]".

== Обновляемая онлайн-версия ==
[http://gis-lab.info/docs/osgeo/ru/ '''Онлайн-версия'''] переведённой документации будет обновляться по мере перевода.

== Координационная таблица ==

<span style="background-color:Yellow">Жёлтым</span> цветом отмечены файлы, находящиеся в переводе (занятые), <span style="background-color:LightGreen">зелёным</span> — переведённые и отредактированные.

<big>Всего: 83 файла, в работе: 18, готово: 32, свободно: 33.</big>






{| class="wikitable" border="1" width="70%"
! class="head" | имя файла
! class="head" | англ. текст новый
! class="head" | разница англ. текст старый/новый
! class="head" | рус. текст старый
! class="head" | кто делает

|---- style="background-color:LightGreen"
| overview.rst
| http://gis-lab.info/docs/osgeo/update_2015/edits/overview.rst
|
| http://gis-lab.info/docs/osgeo/update_2015/ru/overview/overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]

|---- style="background-color:LightGreen"
| mac_installers.rst
| http://gis-lab.info/docs/osgeo/update_2015/new/mac_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|metrics.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/metrics.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12297@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst&old=9149@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|sponsors_osgeo.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors_osgeo.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10081@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst&old=9974@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors_osgeo.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|win_installers.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/win_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|R_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|cartaro_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:Yellow"
|cesium_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|geomajas_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12025@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomajas_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geomoose_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomoose_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|geonetwork_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12064@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|geonode_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:Yellow"
|grass_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12322@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/grass_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|ipython_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|iris_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|josm_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/josm_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|---- style="background-color:LightGreen"
|jts_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/jts_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|leaflet_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|mapwindow_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12237@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst&old=10725@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/mapwindow_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|marble_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12240@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/marble_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|ncWMS_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|netcdf_dataset_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:LightGreen"
|openlayers_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12215@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst&old=11374@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/openlayers_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:Yellow"
|otb_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12320@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/otb_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pycsw_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12419@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/pycsw_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|pywps_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|qgis_mapserver_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12278@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/qgis_mapserver_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|tilemill_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_overview.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:LightGreen"
|52nSOS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nSOS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst&old=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nSOS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWPS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWPS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11624@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst&old=10606@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWPS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|52nWSS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWSS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWSS_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|IPython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/IPython_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:Yellow"
|cartaro_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|cesium_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=2 Максим Дубинин]
|---- style="background-color:Yellow"
|deegree_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/deegree_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12028@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst&old=11685@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/deegree_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|eoxserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/eoxserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11866@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst&old=10819@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/eoxserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|gdal_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gdal_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9908@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gdal_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|----
|geokettle_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geokettle_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10557@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geokettle_quickstart.rst
|
|----
|geomajas_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12026@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomajas_quickstart.rst
|
|----
|geomoose_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomoose_quickstart.rst
|
|----
|geonetwork_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12307@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geonetwork_quickstart.rst
|
|----
|geonode_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|gmt_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gmt_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9730@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gmt_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|gpsdrive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsdrive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11315@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsdrive_quickstart.rst
|
|----
|gpsprune_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsprune_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11871@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsprune_quickstart.rst
|
|---- style="background-color:Yellow"
|grass_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12264@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/grass_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|----
|gvsig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gvsig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11060@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gvsig_quickstart.rst
|
|----
|internationalisation_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/internationalisation_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11951@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/internationalisation_quickstart.rst
|
|----
|iris_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_quickstart.rst
|
|
|
|---- style="background-color:LightGreen"
|leaflet_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|----
|mapfish_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapfish_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11351@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst&old=9163@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapfish_quickstart.rst
|
|----
|mapnik_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapnik_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11300@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst&old=10835@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapnik_quickstart.rst
|
|----
|mapwindow_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12125@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst&old=10229@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapwindow_quickstart.rst
|
|----
|marble_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12139@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/marble_quickstart.rst
|
|----
|mb-system_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mb-system_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10833@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mb-system_quickstart.rst
|
|----
|ncWMS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_quickstart.rst
|
|
|
|----
|opencpn_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/opencpn_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11774@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/opencpn_quickstart.rst
|
|----
|openlayers_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12226@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/openlayers_quickstart.rst
|
|----
|osgeolive_install_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_install_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_install_quickstart.rst
|
|----
|osgeolive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11771@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_quickstart.rst
|
|----
|osm_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osm_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10267@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osm_quickstart.rst
|
|----
|ossim_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ossim_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10841@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ossim_quickstart.rst
|
|---- style="background-color:Yellow"
|otb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12357@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/otb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=10486 Ariki]
|---- style="background-color:LightGreen"
|pgrouting_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pgrouting_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10527@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pgrouting_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:Yellow"
|postgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/postgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11134@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst&old=10691@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/postgis_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|pycsw_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12418@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pycsw_quickstart.rst
|
|----
|pywps_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_quickstart.rst
|
|
|
|---- style="background-color:Yellow"
|qgis_mapserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11941@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_mapserver_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|qgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12407@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_quickstart.rst
|
|----
|rasdaman_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/rasdaman_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12199@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/rasdaman_quickstart.rst
|
|----
|saga_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/saga_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11959@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/saga_quickstart.rst
|
|----
|sahana_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sahana_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11378@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/sahana_quickstart.rst
|
|----
|spatialite_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/spatialite_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11777@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/spatialite_quickstart.rst
|
|---- style="background-color:Yellow"
|tilemill_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_quickstart.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8761 Andrey Zhukov]
|---- style="background-color:Yellow"
|tinyows_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/tinyows_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10845@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/tinyows_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|---- style="background-color:LightGreen"
|udig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/udig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12425@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst&old=10607@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/udig_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:LightGreen"
|usb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/usb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11773@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/usb_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|ushahidi_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ushahidi_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9940@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ushahidi_quickstart.rst
|
|----
|viking_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/viking_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9764@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/viking_quickstart.rst
|
|---- style="background-color:LightGreen"
|virtualbox_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/virtualbox_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11782@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/virtualbox_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=12787 ANAT01]
|----
|zoo-project_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zoo-project_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zoo-project_quickstart.rst
|
|---- style="background-color:LightGreen"
|zygrib_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zygrib_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9744@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zygrib_quickstart.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|}

== Как переводим? ==
=== Главные правила ===

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:
* НЕ переводятся имена файлов;
* оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
* ВСЕ отступы в тексте должны сохраняться;
* НЕ переносим строки в списках;
* в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
* НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
* НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа
<pre>
:scale: 80
</pre>
, кроме строк с ":alt:", которые представляют собой подписи к рисункам:
<pre>
:alt: Web services framework of OGC geoprocessing standards
</pre>
* в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,
"image" здесь
<pre>
.. image:: ../../images/screenshots/800x600/saga_fullextent.png
</pre>
или "tip" здесь
<pre>
.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.
</pre>
* также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

=== Повторяющиеся фрагменты ===
В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:
<pre>
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_
</pre>

Такие части надо переводить единообразно:

{| class="wikitable" border="1" width="40%"
|-
| Quickstart
| Начало работы
|-
| Quickstart documentation
| Введение
|-
| Details
| Дополнительная информация
|-
| Core features
| Базовые функции
|-
| Version
| Версия
|-
| Website
| Веб-сайт
|-
| Licence
| Лицензия
|-
| Software Version
| Версия ПО
|-
| Supported Platforms
| Поддерживаемые платформы
|-
| Support
| Поддержка
|-
| Documentation
| Документация
|-
| API Interfaces
| Интерфейсы API
|-
| Commercial Support
| Коммерческая поддержка
|-
| Community Support
| Поддержка сообщества
|-
| Community Website
| Сайт сообщества
|-
| Programing language support
| Поддержка языков программирования
|-
| Developers
| Разработчики
|-
| What Next?
| Что дальше?
|-
| Implemented Standards
| Реализованные стандарты
|}

В текстах упоминается много '''лицензий''' (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

'''Предложение по названиям лицензий''':

{| class="wikitable" border="1" width="70%"
! class="head" | Исходно
! class="head" | Меняем на:
! class="head" | Ссылка
|-
| AGPL
| AGPL
| http://www.fsf.org/news/agplv3-pr
|-
| Apache License, Version 2.0
| Apache, версия 2.0
| http://www.apache.org/licenses/LICENSE-2.0
|-
| BSD / BSD License / New BSD License / Simplified BSD license
| BSD
| http://ru.wikipedia.org/wiki/BSD_License
|-
| CeCILL
| CeCILL
| http://www.cecill.info/licences.en.html
|-
| custom
| собственная
| ссылка указана в тексте, оставляем её
|-
| GNU General Public License (GPL) version 2
| GPL версия 2
| http://www.gnu.org/licenses/gpl-2.0.html
|-
| GNU General Public License (GPL) version 3
| GPL версия 3
| http://www.gnu.org/licenses/gpl.html
|-
| GPL
| GPL
| http://www.gnu.org/licenses/gpl.html
|-
| GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)
| LGPL
| http://www.gnu.org/copyleft/lesser.html
|-
| MIT / MIT License / MIT x/11
| MIT
| http://opensource.org/licenses/mit-license.php
|-
| MIT based license / MIT-style license
| основанная на MIT
| ссылка указана в тексте, оставляем её
|-
| X/MIT style Open Source license
| в стиле X/MIT
| ссылка указана в тексте, оставляем её
|-
| MPLv1.1
| MPL версия 1.1
| http://www.mozilla.org/MPL/1.1/
|}

=== Найденные ошибки ===
Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на [http://wiki.gis-lab.info/w/%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8_OSGeo_Live--%D0%BD%D0%B0%D0%B9%D0%B4%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8 специальной странице] в вики.

Обновление перевода документации OSGeo Live

2015-11-03T02:15:14Z

Denis Rykov: /* Координационная таблица */

== О чём речь? ==

[http://live.osgeo.org/ru/index.html OSGeo-Live] — LiveCD на базе Ubuntu Linux с большим набором открытых/свободных ГИС (в т.ч. веб), открытых геоданных и документацией. Используется в основном в образовательных или демонстрационных целях.

Пользовательская документация на диске распространяется под свободной лицензией (CC BY 3.0 и CC BY-SA 3.0), представлена в виде набора веб-страниц.
В исходном виде документация OSGeo-Live представляет собой текстовые файлы с разметкой [http://ru.wikipedia.org/wiki/ReStructuredText reStructuredText].

В 2012 г. в рамках подготовки к конференции "Открытые ГИС - 2012" документация [http://gis-lab.info/qa/osgeo-live-docs-coord.html была переведена] на русский язык.

Цель данного мини-проекта — '''обновление''' русскоязычного перевода документации, которые значительно устарел.
Обновлённая документация появится на диске с OSGeo-Live 9.0, который будет раздаваться на конференции [http://gisconf.ru/ "Открытые ГИС 2015"]. Имена переводчиков будут (при их желании, естественно) увековечены в специальном файле ''translators.csv'' в следующем релизе OSGeo-Live.

== Схема работы ==
# Файлы делятся на 2 типа: новые (которые ещё не были переведены) и устаревшие (которые надо поправить). Если колонка ''"рус. текст старый"'' пустая, то это новый файл, если не пустая - устаревший файл.
# Выбрать (никем не занятые) файлы для перевода (где пусто в графе ''"кто делает"'').
# Сообщить, что берёте такой-то файл, в [http://gis-lab.info/forum/viewtopic.php?f=3&t=11526&p=71535#p71479 специальной теме] на форуме; скоро ваше имя появится в таблице (можно записаться и самостоятельно).
# Скачать файл по ссылке в колонке ''"англ. текст новый" ''.
# Если файл новый, то надо просто перевести его, оставив имя файла таким же.
# Если файл устаревший, надо открыть ссылку в колонке ''"разница англ. текст старый/новый"'', там будет наглядно показана разница между текущей версией документа на англ. языке и старой его версией, которую переводили в 2012 г. Нужно скачать файл в колонке ''"рус. текст старый"'' и править его.
# При переводе желательно соблюдать правила, перечисленные ниже.
# Выложить переведённые файлы в той же теме на форуме или прислать в личном сообщении [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 координатору].

'''Пожелание''': русский текст желательно присылать в кодировке UTF-8!

<big>Просьба: прислать переводы желательно '''НЕ ПОЗДНЕЕ 16 ноября'''!</big> Это связано с подготовкой к конференции "[http://gisconf.ru/ru/ Открытые ГИС - 2015]".

== Координационная таблица ==

<span style="background-color:Yellow">Жёлтым</span> цветом отмечены файлы, находящиеся в переводе (занятые), <span style="background-color:Salmon">красным</span> цветом — переведённые файлы, <span style="background-color:LightGreen">зелёным</span> — переведённые и отредактированные.

<big>Всего: 83 файла, в работе: 11, готово: 0, свободно: 72.</big>








{| class="wikitable" border="1" width="70%"
! class="head" | имя файла
! class="head" | англ. текст новый
! class="head" | разница англ. текст старый/новый
! class="head" | рус. текст старый
! class="head" | кто делает
|---- style="background-color:Yellow"
| mac_installers.rst
| http://gis-lab.info/docs/osgeo/update_2015/new/mac_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|metrics.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/metrics.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|sponsors.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12297@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst&old=9149@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|sponsors_osgeo.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sponsors_osgeo.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10081@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst&old=9974@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fsponsors_osgeo.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/sponsors_osgeo.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|---- style="background-color:Yellow"
|win_installers.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/win_installers.rst
|
|
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=8430 Александр Мурый]
|----
|R_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/R_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12279@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst&old=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2FR_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/R_overview.rst
|
|----
|cartaro_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_overview.rst
|
|
|
|----
|cesium_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_overview.rst
|
|
|
|----
|geomajas_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12025@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomajas_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomajas_overview.rst
|
|----
|geomoose_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeomoose_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geomoose_overview.rst
|
|----
|geonetwork_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12064@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgeonetwork_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/geonetwork_overview.rst
|
|----
|geonode_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_overview.rst
|
|
|
|----
|grass_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12322@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fgrass_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/grass_overview.rst
|
|---- style="background-color:Yellow"
|ipython_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|iris_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_overview.rst
|
|
|
|----
|josm_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/josm_overview.rst
|
|
|
|----
|jts_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/jts_overview.rst
|
|
|
|---- style="background-color:Yellow"
|leaflet_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_overview.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|mapwindow_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12237@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst&old=10725@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmapwindow_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/mapwindow_overview.rst
|
|----
|marble_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12240@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fmarble_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/marble_overview.rst
|
|----
|ncWMS_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_overview.rst
|
|
|
|----
|netcdf_dataset_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/netcdf_dataset_overview.rst
|
|
|
|---- style="background-color:Yellow"
|openlayers_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12215@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst&old=11374@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fopenlayers_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/openlayers_overview.rst
| [http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|otb_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12320@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fotb_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/otb_overview.rst
|
|----
|pycsw_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12419@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fpycsw_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/pycsw_overview.rst
|
|----
|pywps_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_overview.rst
|
|
|
|----
|qgis_mapserver_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_overview.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12278@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst&old=11989@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Foverview%2Fqgis_mapserver_overview.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/overview/qgis_mapserver_overview.rst
|
|----
|tilemill_overview.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_overview.rst
|
|
|
|----
|52nSOS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nSOS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11984@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst&old=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nSOS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nSOS_quickstart.rst
|
|----
|52nWPS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWPS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11624@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst&old=10606@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWPS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWPS_quickstart.rst
|
|----
|52nWSS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/52nWSS_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2F52nWSS_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/52nWSS_quickstart.rst
|
|---- style="background-color:Yellow"
|IPython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/IPython_quickstart.rst
|
|
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|cartaro_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cartaro_quickstart.rst
|
|
|
|----
|cesium_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/cesium_quickstart.rst
|
|
|
|----
|deegree_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/deegree_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12028@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst&old=11685@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fdeegree_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/deegree_quickstart.rst
|
|----
|eoxserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/eoxserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11866@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst&old=10819@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Feoxserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/eoxserver_quickstart.rst
|
|----
|gdal_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gdal_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9908@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgdal_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gdal_quickstart.rst
|
|----
|geokettle_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geokettle_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10557@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeokettle_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geokettle_quickstart.rst
|
|----
|geomajas_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomajas_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12026@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomajas_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomajas_quickstart.rst
|
|----
|geomoose_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geomoose_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12009@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeomoose_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geomoose_quickstart.rst
|
|----
|geonetwork_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/geonetwork_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12307@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgeonetwork_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/geonetwork_quickstart.rst
|
|----
|geonode_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/geonode_quickstart.rst
|
|
|
|----
|gmt_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gmt_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9730@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgmt_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gmt_quickstart.rst
|
|----
|gpsdrive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsdrive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11315@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsdrive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsdrive_quickstart.rst
|
|----
|gpsprune_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gpsprune_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11871@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgpsprune_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gpsprune_quickstart.rst
|
|----
|grass_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/grass_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12264@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst&old=12253@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgrass_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/grass_quickstart.rst
|
|----
|gvsig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/gvsig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11060@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fgvsig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/gvsig_quickstart.rst
|
|----
|internationalisation_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/internationalisation_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11951@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Finternationalisation_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/internationalisation_quickstart.rst
|
|----
|ipython_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ipython_quickstart.rst
|
|
|
|----
|iris_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/iris_quickstart.rst
|
|
|
|----
|leaflet_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/leaflet_quickstart.rst
|
|
|
|----
|mapfish_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapfish_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11351@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst&old=9163@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapfish_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapfish_quickstart.rst
|
|----
|mapnik_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapnik_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11300@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst&old=10835@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapnik_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapnik_quickstart.rst
|
|----
|mapwindow_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mapwindow_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12125@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst&old=10229@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmapwindow_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mapwindow_quickstart.rst
|
|----
|marble_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/marble_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12139@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmarble_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/marble_quickstart.rst
|
|----
|mb-system_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/mb-system_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10833@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fmb-system_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/mb-system_quickstart.rst
|
|----
|ncWMS_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/ncWMS_quickstart.rst
|
|
|
|----
|opencpn_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/opencpn_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11774@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopencpn_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/opencpn_quickstart.rst
|
|----
|openlayers_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/openlayers_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12226@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fopenlayers_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/openlayers_quickstart.rst
|
|----
|osgeolive_install_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_install_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10736@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_install_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_install_quickstart.rst
|
|----
|osgeolive_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osgeolive_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11771@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosgeolive_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osgeolive_quickstart.rst
|
|----
|osm_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/osm_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10267@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fosm_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/osm_quickstart.rst
|
|----
|ossim_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ossim_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10841@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fossim_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ossim_quickstart.rst
|
|----
|otb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/otb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12357@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fotb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/otb_quickstart.rst
|
|---- style="background-color:Yellow"
|pgrouting_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pgrouting_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10527@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpgrouting_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pgrouting_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|postgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/postgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11134@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst&old=10691@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpostgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/postgis_quickstart.rst
|
|----
|pycsw_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/pycsw_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12418@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fpycsw_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/pycsw_quickstart.rst
|
|----
|pywps_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/pywps_quickstart.rst
|
|
|
|----
|qgis_mapserver_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_mapserver_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11941@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_mapserver_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_mapserver_quickstart.rst
|
|----
|qgis_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/qgis_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12407@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fqgis_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/qgis_quickstart.rst
|
|----
|rasdaman_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/rasdaman_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12199@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Frasdaman_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/rasdaman_quickstart.rst
|
|----
|saga_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/saga_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11959@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsaga_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/saga_quickstart.rst
|
|----
|sahana_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/sahana_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11378@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fsahana_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/sahana_quickstart.rst
|
|----
|spatialite_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/spatialite_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11777@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fspatialite_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/spatialite_quickstart.rst
|
|----
|tilemill_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/new/tilemill_quickstart.rst
|
|
|
|---- style="background-color:Yellow"
|tinyows_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/tinyows_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=10845@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Ftinyows_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/tinyows_quickstart.rst
|[http://gis-lab.info/forum/memberlist.php?mode=viewprofile&u=6901 DR]
|----
|udig_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/udig_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=12425@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst&old=10607@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fudig_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/udig_quickstart.rst
|
|----
|usb_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/usb_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11773@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst&old=11528@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fusb_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/usb_quickstart.rst
|
|----
|ushahidi_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/ushahidi_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9940@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fushahidi_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/ushahidi_quickstart.rst
|
|----
|viking_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/viking_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9764@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fviking_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/viking_quickstart.rst
|
|----
|virtualbox_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/virtualbox_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11782@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fvirtualbox_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/virtualbox_quickstart.rst
|
|----
|zoo-project_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zoo-project_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=11834@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzoo-project_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zoo-project_quickstart.rst
|
|----
|zygrib_quickstart.rst
|http://gis-lab.info/docs/osgeo/update_2015/edits/zygrib_quickstart.rst
|[http://trac.osgeo.org/osgeo/changeset?new=9744@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst&old=9616@livedvd%2Fgisvm%2Ftrunk%2Fdoc%2Fen%2Fquickstart%2Fzygrib_quickstart.rst link]
|http://gis-lab.info/docs/osgeo/update_2015/ru/quickstart/zygrib_quickstart.rst
|
|----
|}

== Как переводим? ==
=== Главные правила ===

Главная мысль состоит в том, чтобы переводить собственно текст, не трогая по возможности разметку документа. Для этого нужно соблюдать несколько несложных правил:
* НЕ переводятся имена файлов;
* оставляем пустые строки и строки, содержащие только знаки пунктуации, как есть;
* ВСЕ отступы в тексте должны сохраняться;
* НЕ переносим строки в списках;
* в тексте не трогаем знак нижнего подчеркивания (_), "звёздочку" (*), двойную "звёздочку" (**), обратный апостроф (`), двойной обратный апостроф (``), двойное двоеточие (::), двойной обратный слеш (\\);
* НЕ переводится текст, заключённый между двумя знаками вертикальной черты (|текст|);
* НЕ переводятся строки, в которых есть слова с двумя двоеточиями (:текст:) типа
<pre>
:scale: 80
</pre>
, кроме строк с ":alt:", которые представляют собой подписи к рисункам:
<pre>
:alt: Web services framework of OGC geoprocessing standards
</pre>
* в строках, которые начинаются с двух точек (..), не переводится текст до двойных двоеточий, например,
"image" здесь
<pre>
.. image:: ../../images/screenshots/800x600/saga_fullextent.png
</pre>
или "tip" здесь
<pre>
.. tip:: Open the file with a Desktop GIS like QGIS. And have a look.
</pre>
* также НЕ переводятся: ссылки на рисунки (".. image::", ".. figure::"), ссылки на другие документы (:doc: и т.п.).

=== Повторяющиеся фрагменты ===
В текстах (особенно в разделе "Overview") имеются стандартные повторяющиеся фрагменты, например:
<pre>
**Website:** http://mapproxy.org/

**Licence:** `Apache Software License 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>`_

**Software Version:** 1.4.0

**Supported Platforms:** Linux, Mac, Windows

**Support:** http://mapproxy.org/support.html

**Documentation:** <../../mapproxy/index.html>`_
</pre>

Такие части надо переводить единообразно:

{| class="wikitable" border="1" width="40%"
|-
| Quickstart
| Начало работы
|-
| Quickstart documentation
| Введение
|-
| Details
| Дополнительная информация
|-
| Core features
| Базовые функции
|-
| Version
| Версия
|-
| Website
| Веб-сайт
|-
| Licence
| Лицензия
|-
| Software Version
| Версия ПО
|-
| Supported Platforms
| Поддерживаемые платформы
|-
| Support
| Поддержка
|-
| Documentation
| Документация
|-
| API Interfaces
| Интерфейсы API
|-
| Commercial Support
| Коммерческая поддержка
|-
| Community Support
| Поддержка сообщества
|-
| Community Website
| Сайт сообщества
|-
| Programing language support
| Поддержка языков программирования
|-
| Developers
| Разработчики
|-
| What Next?
| Что дальше?
|-
| Implemented Standards
| Реализованные стандарты
|}

В текстах упоминается много '''лицензий''' (часто одна и та же по-разному), где-то со ссылкой на её официальный текст, где-то без. Логично было бы писать их аббревиатуру без расшифровки и давать таки ссылку на лицензию. Ниже в таблице дан перечень лицензий со ссылками.

'''Предложение по названиям лицензий''':

{| class="wikitable" border="1" width="70%"
! class="head" | Исходно
! class="head" | Меняем на:
! class="head" | Ссылка
|-
| AGPL
| AGPL
| http://www.fsf.org/news/agplv3-pr
|-
| Apache License, Version 2.0
| Apache, версия 2.0
| http://www.apache.org/licenses/LICENSE-2.0
|-
| BSD / BSD License / New BSD License / Simplified BSD license
| BSD
| http://ru.wikipedia.org/wiki/BSD_License
|-
| CeCILL
| CeCILL
| http://www.cecill.info/licences.en.html
|-
| custom
| собственная
| ссылка указана в тексте, оставляем её
|-
| GNU General Public License (GPL) version 2
| GPL версия 2
| http://www.gnu.org/licenses/gpl-2.0.html
|-
| GNU General Public License (GPL) version 3
| GPL версия 3
| http://www.gnu.org/licenses/gpl.html
|-
| GPL
| GPL
| http://www.gnu.org/licenses/gpl.html
|-
| GNU Lesser General Public License (LGPL) (version 2, 2.1, 3.0)
| LGPL
| http://www.gnu.org/copyleft/lesser.html
|-
| MIT / MIT License / MIT x/11
| MIT
| http://opensource.org/licenses/mit-license.php
|-
| MIT based license / MIT-style license
| основанная на MIT
| ссылка указана в тексте, оставляем её
|-
| X/MIT style Open Source license
| в стиле X/MIT
| ссылка указана в тексте, оставляем её
|-
| MPLv1.1
| MPL версия 1.1
| http://www.mozilla.org/MPL/1.1/
|}

=== Найденные ошибки ===
Если вы нашли фактическую (смысловую) ошибку в исходных текстах -- просьба отметить это на [http://wiki.gis-lab.info/w/%D0%9F%D0%B5%D1%80%D0%B5%D0%B2%D0%BE%D0%B4_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8_OSGeo_Live--%D0%BD%D0%B0%D0%B9%D0%B4%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5_%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8 специальной странице] в вики.

Создание автономного картографического приложения на базе изображений без привязки

2015-07-11T08:03:18Z

Denis Rykov: /* Подключение тайлов в Leaflet */

{{Статья|Опубликована|zoomable-image-leaflet}}
{{Аннотация|Рассмотрен процесс подготовки и подключения изображений без привязки в картографический JavaScript-движок Leaflet}}

== Введение ==

Картографические JavaScript-движки, такие как [http://openlayers.org/ OpenLayers]
или [http://leafletjs.com/ Leaflet], порой находят своё применение в таких областях,
для которых они изначально вроде бы и не предназначались. Так, например,
международное агентство Reuter [http://mediacdn.reuters.com/media/global/editorial/oscars-history/oscars-history-v10.html продемонстрировало] использование Leaflet для интерактивного взаимодействия с
фотографиями из зала вручения кинопремии «Оскар»:

[[Файл:Non-geographical-imagery-01.png|640px|thumb|center|<center>Пример №1 нестандартного использования картографического движка</center>]]

Еще один необычный [http://apps.npr.org/okkervil-river/ пример] - интерактивный
тур по городу на базе его вымышленной карты:

[[Файл:Non-geographical-imagery-02.png|640px|thumb|center|<center>Пример №2 нестандартного использования картографического движка</center>]]

Таких примеров можно привести много, их объединяет то, что все они построены на базе изображений, которые не имеют
никакой географической привязки. Использование картографических движков для таких изображений добавляет возможность навигации (pan), а после небольшой предварительной обработки - возможность их масштабирования (zoom).

Именно вопросу такой предварительной подготовки и посвящена основная часть данной статьи. В качестве языка программирования будем использовать Python, в качестве JavaScript-движка - Leaflet.

Если перед вами стоит схожая задача, но вы не хотите вникать в технические моменты, тогда просто воспользуйтесь одним из онлайн-сервисов (например [http://hugepic.io/ HUGEpic]). Принцип работы с такими сервисами заключается в том, что вы загружаете свое изображение, а на выходе получаете готовую "карту", [http://hugepic.io/34f7e5716/2.00/47.3/6.7 пример].

== Обработка исходного изображения ==

=== Постановка задачи ===

Исходное изображение в принципе можно подключить "как есть", в OpenLayers для этого есть класс [http://dev.openlayers.org/docs/files/OpenLayers/Layer/Image-js.html OpenLayers.Layer.Image], а в Leaflet - [http://leafletjs.com/reference.html#imageoverlay L.ImageOverlay], однако в общем случае это плохая идея, так как изображение может быть большим и пользователю придется очень долго ждать, пока оно загрузится, поэтому первое, что нужно сделать с изображением - это разбить его на тайлы. Поскольку мы хотим иметь возможность не только двигать наше изображение, но и изменять масштаб, то тайлы должны быть построены для нескольких масштабных уровней.

=== Рабочее изображения ===

Работать будем с [http://www.flickr.com/photos/idvsolutions/7439877658/sizes/o/in/photostream/ визуализацией землетрясений], произошедших с 1898 года. Подробнее об изображении [http://uxblog.idvsolutions.com/2012/06/earthquakes-since-1898.html тут]. Размер изображения - 3410 x 2058.

[[Файл:Non-geographical-imagery-03.jpg|500px|thumb|center|<center>Исходное изображение (не оригинал, размер уменьшен)</center>]]

=== Разбивка на тайлы ===

Переходим к написанию скрипта, который будет разбивать на тайлы наше изображение. Мы будем использовать инструменты стандартной библиотеки Python, а также одну стороннюю библиотеку - библиотеку для работы с изображениями - [https://pypi.python.org/pypi/PIL PIL], поэтому прежде чем продолжить работу, убедитесь, что у вас установлен PIL.

Используемая в дальнейшем схема разбивки на тайлы - как в OpenStreetMap (то есть нумерация строк и столбцов тайлов начинается с левого верхнего угла). Алгоритм разбивки изображения на тайлы достаточно прост, но имеет некоторую особенность. Представьте, что мы взяли наше изображение размера 3410 x 2058 и пытаемся разбить его на тайлы 256 x 256. Очевидно, что 3410 и 2058 не делятся без остатка на 256, а это означает, что тайлы последнего столбца и последней строки получатся не квадратными (82 x 256 и 256 x 10 соответственно). Поэтому, прежде чем переходить к нарезке тайлов, изображение должно быть приведено к такому виду, что его ширина и высота будут кратны размеру тайла. Размеры поправок вычисляются следующим образом (src_width, src_height - ширина и высота исходного изображения, tile_size - размер тайла, % - операция получения остатка от деления). В Python это записывается так:

<syntaxhighlight lang="python">
dw = tile_size - src_width % tile_size
dh = tile_size - src_height % tile_size
</syntaxhighlight>

Области расширения за счет поправок следует сделать прозрачными, в нашем коде за эту операцию будет отвечать функция ''adjustBounds''.

Одним из важных параметров процедуры разбивки на тайлы - это максимальный масштабный уровень. Рассчитывается он как логарифм по основанию 2 числа max(w,h), округленный до ближайшего большего целого, где w - ширина изображения, h - высота. В Python это записывается так:

<syntaxhighlight lang="python">
max_zoom = int(math.ceil(math.log((max(w, h) / tile_size), 2)))
</syntaxhighlight>

Если посчитать, то мы получим:

<syntaxhighlight lang="python">
max_zoom = int(math.ceil(math.log((max(3410, 2058) / 256), 2))) = 4
</syntaxhighlight>

В итоге алгоритм разбивки на тайлы сводится к циклу от самого детального масштабного уровня (в нашем случае от 4) до 0. В цикле выполняются следующие операции: на 4-м уровне берется исходное изображение, к нему применяется функция ''adjustBounds'', нарезаются тайлы и раскладываются по соответствующим каталогам, после чего размер исходного изображения (не того, к которому применена функция ''adjustBounds'') уменьшается в 2 раза и так далее.

Полная версия скрипта:

<syntaxhighlight lang="python">
# -*- coding: utf-8 -*-
import sys
import os
import math
from PIL import Image

# source path
img_path = sys.argv[1]

# tile size
tile_size = 256

# tile directory
tile_path = 'tiles'

def adjustBounds(src_img):

# get size of original image
src_width, src_height = src_img.size

# calculate size of target image (background)
target_width = src_width + (tile_size - src_width % tile_size)
target_height = src_height + (tile_size - src_height % tile_size)

# create transparent background
target_img = Image.new('RGBA', (target_width, target_height))

# combine original image and background
target_img.paste(src_img, (0, 0))

return target_img

img = Image.open(img_path)
w, h = img.size[0], img.size[1]

# calculate max zoom level
max_zoom = int(math.ceil(math.log((max(w, h) / tile_size), 2)))

for z in range(max_zoom, -1, -1):

adjusted_image = adjustBounds(img)

numcolumns = adjusted_image.size[0] / tile_size
numrows = adjusted_image.size[1] / tile_size

for x in range(numcolumns):

# create z/x/ directory
path = os.path.join(tile_path, str(z), str(x))
if not os.path.isdir(path):
os.makedirs(path)

for y in range(numrows):
bounds = (x * tile_size, y * tile_size, (x + 1) * tile_size, (y + 1) * tile_size)
tile = adjusted_image.crop(bounds)
tile.save('%s/%s.png' % (path, y))

w, h = img.size[0], img.size[1]
img = img.resize((w / 2, h / 2), Image.ANTIALIAS)
</syntaxhighlight>

Поместим файл со скриптом (''tiling.py'') в ту же папку, где лежит исходное изображение (''earthquakes.jpg'') и запускаем обработку:

<syntaxhighlight lang="bash">
python tiling.py earthquakes.jpg
</syntaxhighlight>

После выполнения данного скрипта в этой же папке будет создан каталог ''tiles'', в который будут помещены тайлы.

== Подключение тайлов в Leaflet ==

В этой же директории, где находится файл ''tiling.py'' и каталог ''tiles'' создадим файл ''display.html'' и поместим в него следующий код:

<syntaxhighlight lang="html5">
<html>
<head>
<link rel="stylesheet" href="http://cdnjs.cloudflare.com/ajax/libs/leaflet/0.7.3/leaflet.css" />
<script src="http://cdnjs.cloudflare.com/ajax/libs/leaflet/0.7.3/leaflet.js"></script>
</head>
<body>
<div id="map" style="width: 750px; height: 350px;"></div>
<script>
map = L.map('map', {
crs: L.CRS.Simple,
maxZoom: 4,
minZoom: 0
}).setView([-60,100], 1);

L.tileLayer('./tiles/{z}/{x}/{y}.png', {
attribution: 'These bicycles are for other drivers ©',
continuousWorld: true,
noWrap: true
}).addTo(map);
</script>
</body>
</html>
</syntaxhighlight>

Отметим, что проекция объекта карты выставлена в значение ''L.CRS.Simple''. Согласно [http://leafletjs.com/reference.html#icrs документации], именно это значение используется в случае опубликования изображений, не имеющих географической привязки. Открываем созданный файл в браузере и наблюдаем следующий результат:

{{#widget:Iframe
|url=http://gis-lab.info/share/DR/public_html/non-geographical-imagery-ex.html
|width=767
|height=367
|border=0
}}

== Заключение ==

В ходе данной статьи была описана процедура разбивки изображения без привязки на тайлы, а также подключение их в Leaflet. Отметим, что операцию по тайлированию изображения можно было выполнить, используя утилиту [http://www.gdal.org/gdal2tiles.html gdal2tiles], которая входит в состав библиотеки [http://www.gdal.org/ GDAL]:

<syntaxhighlight lang="bash">
gdal2tiles.py -p raster -z 0-4 earthquakes.jpg
</syntaxhighlight>

Описанный в статье вариант решения задачи не требует использования GDAL, плюс (что самое, наверное, важное) код довольно простой и наглядно дает понимание того, как вычисляются масштабные уровни и как выполняется непосредственно сама разбивка на тайлы. По коду gdal2tiles разбираться в этих вопросах гораздо сложнее, так как это более универсальный инструмент. И еще, gdal2tiles помимо генерирования тайлов также создает html-файлы с включенными в них движками OpenLayers и Google (но не Leaflet) и подключает на карту набор созданных тайлов, то есть по-сути делает все то же самое о чем идет речь в данной статье, но как-бы за кадром, мы же попытались представить этот процесс более наглядно.

== Полезные ссылки ==
# [http://omarriott.com/aux/leaflet-js-non-geographical-imagery/ Using leaflet.js with non-geographic imagery]
# [http://build-failed.blogspot.ru/2012/11/zoomable-image-with-leaflet.html Zoomable image with Leaflet]
# [http://macwright.org/2012/08/13/images-as-maps.html Images as Maps]

QuickMapServices - быстрая работа с базовыми картами в QGIS

2015-01-30T11:09:12Z

Denis Rykov:

{{Статья|Опубликована|quickmapservices}}
{{Аннотация|Описание инструмента.}}

Этот инструмент может применяться для быстрого добавления базовой карты (т.н. подложки) в проект QGIS.

Растровая картографическая подложка часто выступает в качестве первого слоя, добавляемого для работы в проект. Подложка может быть представлена в виде различных интернет-сервисов: TMS, WMS, WMTS, ESRI ArcGIS Service или просто в виде тайлов XYZ.

В настольных ГИС существуют различные средства добавления подложек.

В QGIS, например, есть и собственные провайдеры данных и сторонние расширения для доступа к этим сервисам. WMS и WMTS протоколы реализованы в ядре QGIS. Доступ к TMS сервисам и тайлам XYZ можно организовать используя GDAL WMS Driver. В этом случае нужно подготавливать специальный XML-файл с описанием для GDAL. Это не удобно, так как запомнить адреса сложно, а процесс их ввода каждый раз при смене рабочего места отнимает достаточно много времени.

Существующие расширения для оптимизации работы нас не устроили и мы сделали [http://plugins.qgis.org/plugins/quick_map_services/ QuickMapServices] — расширение, которое позволяет быстро и удобно работать с подложками, получаемыми из различных интернет-сервисов.

{{NextGIS}}

=== Замечания по установке ===

Расширение доступно из [http://plugins.qgis.org/plugins/plugins.xml официального репозитория].

QuickMapServices находится в разработке и протестирован с QGIS 2.6 и выше.

Исходный код модуля можно получить выполнив команду

<pre>git clone git@github.com:nextgis/quickmapservices.git</pre>

=== Работа с расширением ===

После установки расширения в панели инструментов "Интернет" появится кнопка расширения. Так же появится группа QuickMapServices в одноименном меню.

[[Файл:Файл:Quickmapservices-button.png|center]]

Кнопка является контейнером для базовых карт из различных источников.

[[Файл:multiqml-01.png|center]]

При выборе одной из них, карта автоматически подключается в проект в качестве слоя. Слой подключается в конец списка слоёв.

=== Почему QuickMapServices ===

Для удобной работы с подложками на данный момент существует несколько модулей расширения QGIS: OpenLayers plugin, Tile Map Scale Plugin, TileLayer. QuickMapServices наследует преимущества этих модулей и одновременно исправляет их недостатки:

* Использует нативную управляемую реализацию доступа к данным (в отличие от OpenLayers Plugin)
* Имеет готовый список адресов сервисов и умеет добавлять подложки в один клик (как OpenLayers Plugin, но у последнего скачивание данных фактически происходит через браузер webkit, что не оптимально).
* Не испытывает проблем с масштабированием надписей на нестандартных масштабах (как Tile Map Scale Plugin, последний использует универсальный драйвер GDAL, что приводит к проблемам с качеством отображения и печати на нестандартных масштабных уровнях в QGIS).
* Использует реализацию доступа к тайлам со сглаживанием на нестандартных масштабных уровнях, что решает проблему отображения подписей на нестандартных масштабных уровнях (как TileLayer Plugin, но последний не имеет удобного способа добавлять готовые подложки).
* Cписок сервисов может легко расширяться путем добавления простых ini файлов.

=== Добавление сервисов ===

Для добавления сервиса в модуль нужны два файла, используйте примеры:

# Иконка в формате SVG ([https://github.com/nextgis/quickmapservices/blob/master/src/data_sources/osm_mapnik/osm.svg пример])
# Файл описания сервиса metadata.ini ([https://github.com/nextgis/quickmapservices/blob/master/src/data_sources/osm_mapnik/metadata.ini пример])

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

* Если есть аккаунт на Github - пул реквестом к нашему [https://github.com/nextgis/quickmapservices репозиторию]
* Если нет аккаунта - завести аккаунт и сделать пул реквест
* Если нет аккаунта, нет желания заводить аккаунт, не знаете что такое пул реквест и нет желания выяснять то можно так же:
** Приложить файлы к [http://gis-lab.info/forum/viewtopic.php?f=27&t=18464 теме обсуждения модуля] на форуме GIS-Lab
** Просто отправить по [http://nextgis.ru/contact/ почте]

Полная версия руководства по добавлению сервисов ([https://github.com/nextgis/quickmapservices/wiki/Adding-data-source на английском]).

=== Известные ограничения ===

На текущий момент модуль имеет следующие ограничения:

* При использовании HTTP прокси-сервера на уровне ОС должны быть заданы необходимые [http://trac.osgeo.org/gdal/wiki/ConfigOptions#GDALOGRHTTPoptions переменные окружения], обеспечивающие корректную работу утилит GDAL, используемых при работе QuickMapServices. Если используется прокси-сервер без аутентификации, то достаточно задать только переменную GDAL_HTTP_PROXY. В ОС Windows это выглядит так:
<pre>SET GDAL_HTTP_PROXY = host:port</pre>
* Сервисы на базе ArcGIS Server MapServices через модуль можно загружать только в [http://nextgis.ru/nextgis-qgis/ NextGIS QGIS Future]

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

=== Контакты ===

Если вы нашли ошибку или у вас есть предложения по улучшению расширения — воспользуйтесь [https://github.com/nextgis/quickmapservices/issues багтрекером]. Кроме того, вопросы по использованию расширения можно задать авторам [http://nextgis.ru/contact/ напрямую].

=== Ссылки по теме ===

* [http://gis-lab.info/qa/qgis-install-plugin.html Установка модулей расширения в QGIS]
* [http://gis-lab.info/docs/qgis/ Документация по QGIS]

QuickMapServices - быстрая работа с базовыми картами в QGIS

2015-01-30T10:58:37Z

Denis Rykov:

{{Статья|Опубликована|quickmapservices}}
{{Аннотация|Описание инструмента.}}

Этот инструмент может применяться для быстрого добавления базовой карты (т.н. подложки) в проект QGIS.

Растровая картографическая подложка часто выступает в качестве первого слоя, добавляемого для работы в проект. Подложка может быть представлена в виде различных интернет-сервисов: TMS, WMS, WMTS, ESRI ArcGIS Service или просто в виде тайлов XYZ.

В настольных ГИС существуют различные средства добавления подложек.

В QGIS, например, есть и собственные провайдеры данных и сторонние расширения для доступа к этим сервисам. WMS и WMTS протоколы реализованы в ядре QGIS. Доступ к TMS сервисам и тайлам XYZ можно организовать используя GDAL WMS Driver. В этом случае нужно подготавливать специальный XML-файл с описанием для GDAL. Это не удобно, так как запомнить адреса сложно, а процесс их ввода каждый раз при смене рабочего места отнимает достаточно много времени.

Существующие расширения для оптимизации работы нас не устроили и мы сделали [http://plugins.qgis.org/plugins/quick_map_services/ QuickMapServices] — расширение, которое позволяет быстро и удобно работать с подложками, получаемыми из различных интернет-сервисов.

{{NextGIS}}

=== Замечания по установке ===

Расширение доступно из [http://plugins.qgis.org/plugins/plugins.xml официального репозитория].

QuickMapServices находится в разработке и протестирован с QGIS 2.6 и выше.

Исходный код модуля можно получить выполнив команду

<pre>git clone git@github.com:nextgis/quickmapservices.git</pre>

=== Работа с расширением ===

После установки расширения в панели инструментов "Интернет" появится кнопка расширения. Так же появится группа QuickMapServices в одноименном меню.

[[Файл:Файл:Quickmapservices-button.png|center]]

Кнопка является контейнером для базовых карт из различных источников.

[[Файл:multiqml-01.png|center]]

При выборе одной из них, карта автоматически подключается в проект в качестве слоя. Слой подключается в конец списка слоёв.

=== Почему QuickMapServices ===

Для удобной работы с подложками на данный момент существует несколько модулей расширения QGIS: OpenLayers plugin, Tile Map Scale Plugin, TileLayer. QuickMapServices наследует преимущества этих модулей и одновременно исправляет их недостатки:

* Использует нативную управляемую реализацию доступа к данным (в отличие от OpenLayers Plugin)
* Имеет готовый список адресов сервисов и умеет добавлять подложки в один клик (как OpenLayers Plugin, но у последнего скачивание данных фактически происходит через браузер webkit, что не оптимально).
* Не испытывает проблем с масштабированием надписей на нестандартных масштабах (как Tile Map Scale Plugin, последний использует универсальный драйвер GDAL, что приводит к проблемам с качеством отображения и печати на нестандартных масштабных уровнях в QGIS).
* Использует реализацию доступа к тайлам со сглаживанием на нестандартных масштабных уровнях, что решает проблему отображения подписей на нестандартных масштабных уровнях (как TileLayer Plugin, но последний не имеет удобного способа добавлять готовые подложки).
* Cписок сервисов может легко расширяться путем добавления простых ini файлов.

=== Добавление сервисов ===

Для добавления сервиса в модуль нужны два файла, используйте примеры:

# Иконка в формате SVG ([https://github.com/nextgis/quickmapservices/blob/master/src/data_sources/osm_mapnik/osm.svg пример])
# Файл описания сервиса metadata.ini ([https://github.com/nextgis/quickmapservices/blob/master/src/data_sources/osm_mapnik/metadata.ini пример])

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

* Если есть аккаунт на Github - пул реквестом к нашему [https://github.com/nextgis/quickmapservices репозиторию]
* Если нет аккаунта - завести аккаунт и сделать пул реквест
* Если нет аккаунта, нет желания заводить аккаунт, не знаете что такое пул реквест и нет желания выяснять то можно так же:
** Приложить файлы к [http://gis-lab.info/forum/viewtopic.php?f=27&t=18464 теме обсуждения модуля] на форуме GIS-Lab
** Просто отправить по [http://nextgis.ru/contact/ почте]

Полная версия руководства по добавлению сервисов ([https://github.com/nextgis/quickmapservices/wiki/Adding-data-source на английском]).

=== Известные ограничения ===

На текущий момент модуль имеет следующие ограничения:

* При использовании HTTP прокси-сервера на уровне ОС должны быть заданы необходимые [http://trac.osgeo.org/gdal/wiki/ConfigOptions#GDALOGRHTTPoptions переменные окружения], обеспечивающие корректную работу утилит GDAL, используемых при работе QuickMapServices. Если используется прокси-сервер без аутентификации, то достаточно задать только переменную GDAL_HTTP_PROXY.
* Сервисы на базе ArcGIS Server MapServices через модуль можно загружать только в [http://nextgis.ru/nextgis-qgis/ NextGIS QGIS Future]

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

=== Контакты ===

Если вы нашли ошибку или у вас есть предложения по улучшению расширения — воспользуйтесь [https://github.com/nextgis/quickmapservices/issues багтрекером]. Кроме того, вопросы по использованию расширения можно задать авторам [http://nextgis.ru/contact/ напрямую].

=== Ссылки по теме ===

* [http://gis-lab.info/qa/qgis-install-plugin.html Установка модулей расширения в QGIS]
* [http://gis-lab.info/docs/qgis/ Документация по QGIS]

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

2015-01-11T05:59:26Z

Denis Rykov: /* Введение */

{{Статья|Опубликована|graphhopper-deployment}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

К роутинговым движкам относится программное обеспечение, позволяющее прокладывать маршрут на карте из одной точки в другую по имеющемуся графу. Существует большое количество программ данного рода, одна из наиболее известных - [http://project-osrm.org/ Open Source Routing Machine (OSRM)], написанная на С++.

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/blob/master/docs/core/quickstart-from-source.md#routing-service-deployment тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/index.md GraphHopper docs]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]
# [http://shtosm.ru/all/grasshopper/ ШТОСМ: Graphhopper]

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

2015-01-11T05:57:33Z

Denis Rykov: /* Ссылки */

{{Статья|Опубликована|graphhopper-deployment}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

К роутинговым движкам относится программное обеспечение, позволяющее прокладывать маршрут на карте из одной точки в другую по имеющемуся графу. Существует большое количество программ данного рода, одна из наиболее известных - [http://project-osrm.org/ Open Source Routing Machine (OSRM)], написанная на С++.

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/index.md GraphHopper docs]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]
# [http://shtosm.ru/all/grasshopper/ ШТОСМ: Graphhopper]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-18T15:46:03Z

Denis Rykov: /* Ежеминутное обновление */

{{Статья|Опубликована|mod_tile}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения) или, будучи основанной на тех же исходных данных, имела совсем другое представление. Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, данный вариант не позволит настроить собственную символику подложки, отличную от стандартной. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного набора тайлов. Решению данной задачи и посвящена данная статья.

Набор тайлов может быть подготовлен различными способами, но наиболее универсальный вариант предоставления доступа к тайлам - это использование тайлового сервера - программного обеспечения, работающего по следующим принципами:
* при запросе тайла - сервер проверяет его наличие в своём кэше, если тайл найден - он возвращается клиенту;
* если тайл не найден, то осуществляется его рендеринг, после чего он сохраняется в кэше и только после этого возвращается клиенту.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных.
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы в репозиториях по-умолчанию отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно.

Поэтому для удобной установки необходимых пакетов лучше использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее. Руководство по самостоятельной сборке RPM-пакетов можно почитать [https://github.com/nextgis/gis_packages_centos здесь].

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

Для получения списка тайлов в прямоугольнике с координатами WGS-84, либо по произвольному полигону обрезки, воспользуйтесь [https://github.com/zverik/polytiles polytiles.py]. Пример команды:

./polytiles.py --poly russia.poly --zooms 6 10 --export russia_tiles.lst -q
render_list -s /run/renderd/renderd.sock < russia_tiles.lst

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Ежеминутное обновление ==

Чтобы обновлять данные в базе, не обязательно каждый раз обрабатывать всю выгрузку (а то и планету) целиком: достаточно настроить ежеминутное обновление данных базы. На сервер OSM выкладываются [http://planet.osm.org/replication/ файлы изменений] за эти периоды, и с помощью osmosis и osm2pgsql их можно накатить на рабочую базу. Если вы планируете подобного рода обновления, то данные должны быть загружены в базу с помощью osm2pgsql без использования ключа ''--drop''.

Если вы собирали mod_tile из исходников, найдите там файл <tt>openstreetmap-tiles-update-expire</tt>, иначе скачайте его c [https://github.com/openstreetmap/mod_tile/blob/master/openstreetmap-tiles-update-expire github]. Поправьте пути в начале файла. Запускать скрипт нужно от имени пользователя, который запускает renderd и прочее (по инструкции выше — <tt>dr</tt>). Сначала нужно инициализировать рабочие каталоги: запустите

./openstreetmap-tiles-update-expire YYYY-MM-DD

где дата — день, когда был подготовлен загруженный в базу данных дамп. Если будет на день-два раньше — ничего страшного, дублирования не произойдёт. Дальше всё просто: запустите <tt>crontab -e</tt> от пользователя <tt>dr</tt> и добавьте строку:

* * * * * /путь/к/openstreetmap-tiles-update-expire

Проверить, что обновление идёт без ошибок, можно по логу в <tt>/var/log/tiles/run.log</tt>. При полном обновлении базы данных не забывайте отключать вызов скрипта в crontab. Пока он остановлен, можно скачать правильный state.NNN.txt в <tt>/var/lib/mod_tile/.osmosis/state.txt</tt>, чтобы начать обновление с более ранней даты. Максимальный интервал, на который обновляется база за один вызов скрипта, указывается в файле <tt>/var/lib/mod_tile/.osmosis/configuration.txt</tt> в ключе <tt>maxInterval</tt>, по умолчанию — один час.

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T20:03:28Z

Denis Rykov: /* Введение */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения) или, будучи основанной на тех же исходных данных, имела совсем другое представление. Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, данный вариант не позволит настроить собственную символику подложки, отличную от стандартной. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного набора тайлов. Решению данной задачи и посвящена данная статья.

Набор тайлов может быть подготовлен различными способами, но наиболее универсальный вариант предоставления доступа к тайлам - это использование тайлового сервера - программного обеспечения, работающего по следующим принципами:
* при запросе тайла - сервер проверяет его наличие в своём кэше, если тайл найден - он возвращается клиенту;
* если тайл не найден, то осуществляется его рендеринг, после чего он сохраняется в кэше и только после этого возвращается клиенту.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных.
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы в репозиториях по-умолчанию отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно.

Поэтому для удобной установки необходимых пакетов лучше использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее. Руководство по самостоятельной сборке RPM-пакетов можно почитать [https://github.com/nextgis/gis_packages_centos здесь].

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T19:39:20Z

Denis Rykov: /* Введение */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения) или, будучи основанной на тех же исходных данных, имела совсем другое представление. Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, данный вариант не позволит настроить собственную символику подложки, отличную от стандартной. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного набора тайлов. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных.
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы в репозиториях по-умолчанию отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно.

Поэтому для удобной установки необходимых пакетов лучше использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее. Руководство по самостоятельной сборке RPM-пакетов можно почитать [https://github.com/nextgis/gis_packages_centos здесь].

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T19:32:05Z

Denis Rykov: /* Стек программных продуктов тайлового сервера openstreetmap.org */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения) или, будучи основанной на тех же исходных данных, имела совсем другое представление. Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, данный вариант не позволит настроить собственную символику подложки, отличную от стандартной. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных.
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы в репозиториях по-умолчанию отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно.

Поэтому для удобной установки необходимых пакетов лучше использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее. Руководство по самостоятельной сборке RPM-пакетов можно почитать [https://github.com/nextgis/gis_packages_centos здесь].

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T19:31:39Z

Denis Rykov: /* Введение */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения) или, будучи основанной на тех же исходных данных, имела совсем другое представление. Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, данный вариант не позволит настроить собственную символику подложки, отличную от стандартной. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы в репозиториях по-умолчанию отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно.

Поэтому для удобной установки необходимых пакетов лучше использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее. Руководство по самостоятельной сборке RPM-пакетов можно почитать [https://github.com/nextgis/gis_packages_centos здесь].

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T19:30:42Z

Denis Rykov: /* Введение */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения) или, будучи основана на тех же исходных данных, имела совсем другое представление. Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, данный вариант не позволит настроить собственную символику подложки, отличную от стандартной. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы в репозиториях по-умолчанию отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно.

Поэтому для удобной установки необходимых пакетов лучше использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее. Руководство по самостоятельной сборке RPM-пакетов можно почитать [https://github.com/nextgis/gis_packages_centos здесь].

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T18:42:53Z

Denis Rykov: /* Создание базы данных и загрузка данных */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты].

Для их удобной установки можно использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - ежедневные выгрузки данных на территорию бывшего СССР в форматах XML и PBF, расположенные [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T18:42:03Z

Denis Rykov: /* Создание базы данных и загрузка данных */

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты].

Для их удобной установки можно использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - проект ежедневных выгрузок на территорию бывшего СССР в форматах XML и PBF [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T18:41:19Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap на примере операционной системы CentOS 6.}}

== Введение ==

Сегодня во многих картографических веб-приложениях в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS.

*'''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности).
*'''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами.
*'''Mapnik''' - рендерер, превращающий векторные данные в растровые тайлы и используемый renderd.
*'''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных
*'''PostgreSQL/PostGIS''' - собственно СУБД.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень удобно, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты].

Для их удобной установки можно использовать [http://nextgis.ru/programs/centos/ специальный репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, расположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis, содержащий все остальные необходимые компоненты: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ. Существует несколько способов получения исходных данных OpenStreetMap, один из них - получить данные на странице проекта ежедневных выгрузок на территорию бывшего СССР в форматах XML и PBF [http://gis-lab.info/projects/osm_dump/ здесь].

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она выглядит так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-11T03:58:40Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDSOCKDIR=/var/run/$NAME
PIDFILE=$PIDSOCKDIR/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
[ -d "$PIDSOCKDIR" ] || mkdir -p $PIDSOCKDIR && chown $RUNASUSER $PIDSOCKDIR
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T18:30:51Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.6</Parameter>
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T12:27:07Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=1
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T06:53:48Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Список всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T06:52:52Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Описание всех настроек, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/renderd.conf здесь].

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T06:30:24Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

Описание всех инструкций, которые могут быть добавлены в этот файл можно найти [https://github.com/openstreetmap/mod_tile/blob/master/mod_tile.conf здесь].

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T04:12:09Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

'''Замечание:''' начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T04:11:37Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

**Замечание:** начиная с [https://blog.openstreetmap.org/2013/08/26/%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D1%81%D0%B5%D1%80%D0%B2%D0%B5%D1%80-%D1%82%D0%B0%D0%B9%D0%BB%D0%BE%D0%B2-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B9-%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%81%D1%82%D0%B8%D0%BB%D1%8C/?lang=ru августа 2013] года, тайлы на сайте openstreetmap.org отрисовываются не с помощью XML-стиля, а с помощью стиля в формате [https://github.com/gravitystorm/openstreetmap-carto CartoCSS]. Это полностью переписанный на CartoCSS старый XML-стиль, что значительно упрощает его модификацию. Стиль сделан как можно более похожим на старый.

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T03:18:09Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik.html Подготовка карт для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/07/mapnik_29.html Настройка базы данных для генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/mapnik.html Установка генератора тайлов Mapnik]
* [http://vladimir-stupin.blogspot.ru/2012/08/renderd-modtile.html Установка renderd и mod_tile - системы отрисовки тайлов по запросу]
* [http://vladimir-stupin.blogspot.ru/2012/08/blog-post.html Тайловый сервер - что с ним делать?]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-10T02:08:07Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Если Apache ещё не установлен, то установите его:

<pre>yum install httpd</pre>

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T19:44:19Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64, но вся последовательность шагов может быть легко адаптирована и под любой другой Linux-дистрибутив. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T19:39:50Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

== Автоматический запуск renderd ==

Очевидно, что каждый раз вручную запускать renderd после перезагрузки сервера - это не дело, поэтому нам необходима возможность автоматического запуска renderd. В репозитории mod_tile (renderd входит в его состав) присутствует [https://github.com/openstreetmap/mod_tile/blob/master/debian/renderd.init init-скрипт], выполняющий эту задачу. Однако он Debian-специфичен и нам не подходит. Напишем свой.

Создаём файл ''/etc/init.d/renderd'' следующего содержания:

<syntaxhighlight lang="bash">
#!/bin/bash
#
# renderd Mapnik rendering daemon
#
# chkconfig: 345 70 30
# description: Mapnik rendering daemon
# processname: renderd

# Source function library.
. /etc/init.d/functions

PATH=/sbin:/usr/sbin:/bin:/usr/bin
DESC="Mapnik rendering daemon"
NAME=renderd
DAEMON=/usr/bin/$NAME
DAEMON_ARGS="-c /etc/renderd.conf"
PIDFILE=/var/run/$NAME/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME
RUNASUSER=dr

start() {
if [ -e $PIDFILE ];
then
echo -n "$NAME already started"
RETVAL=$?
else
echo -n "Starting $NAME: "
mkdir -p /var/run/renderd
chown $RUNASUSER /var/run/renderd
daemon --user $RUNASUSER $DAEMON $DAEMON_ARGS 2> /dev/null
RETVAL=$?
[ $RETVAL -eq 0 ] && touch $PIDFILE
fi
echo
return $RETVAL
}

stop() {
echo -n "Shutting down $NAME: "
killproc $DAEMON && success || failure
RETVAL=$?
[ $RETVAL -eq 0 ] && rm -f $PIDFILE
echo
return $RETVAL
}

case "$1" in
start)
start
;;
stop)
stop
;;
restart)
stop
start
;;
*)
echo "Usage: $SCRIPTNAME {start|stop|restart}"
exit 1
;;
esac
exit $RETVAL
</syntaxhighlight>

Делаем его исполняемым:

<pre>chmod u+x /etc/init.d/renderd</pre>

Запускаем сервис и добавляем его в автозагрузку:

<pre>
service renderd start
chkconfig renderd on
</pre>

== Предварительный рендеринг тайлов ==

В текущей конфигурации тайлы будут отрисовываться по запросу. То есть если mod_tile не найдёт запрашиваемый тайл в кэше, то он обратится за ним к renderd. Однако процесс отрисовки тайлов требует определенного времени и чтобы не заставлять ждать клиента, запрашивающего тайл, пока этот тайл отрисуется, можно подготовить необходимые тайлы заранее. В состав пакета renderd помимо самого демона входит еще несколько вспомогательных утилит, среди которых ''render_list''. С помощью данной утилиты можно указать масштабный уровень и диапазоны x и y координат тайлов и осуществить предварительный рендеринг. Пример рендеринга тайлов 7 уровня на территорию России:

<pre>render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=7 --min-zoom=7 --min-x=73 --max-x=127 --min-y=18 --max-y=47 --num-threads=4</pre>

Пример Python-скрипта расчета координат тайлов по охвату интересующей области:

<syntaxhighlight lang="python">
# Russia bbox
XMIN = 2989951.00
XMAX = 20037508.34
YMIN = 5039930.86
YMAX = 14222184.29

# Sphere radius
R = 20037508.342789244

for z in range(19):
r = 2*R/(256*2**z)

tile_w = tile_h = 256*r

x_min = (R+XMIN)/tile_w
x_max = (R+XMAX)/tile_w
y_min = (R-YMAX)/tile_h
y_max = (R-YMIN)/tile_h

print "render_list --socket=/var/run/renderd/renderd.sock --all --max-zoom=%d --min-zoom=%d --min-x=%d --max-x=%d --min-y=%d --max-y=%d --num-threads=4" % (z, z, int(x_min), int(x_max), int(y_min), int(y_max))
</syntaxhighlight>

== Актуальность тайлов ==

Чтобы поддерживать тайлы в актуальном состоянии, mod_tile должен знать дату на которую были загружены исходные данные в базу PostGIS. В случае, если дата загрузки данных в базу свежее даты создания тайла, то при следующем обращении к этому тайлу он будет отрисован заново. Дата загрузки данных в базу хранится как timestamp файла ''planet-import-complete'', который должен находиться в директории с тайлами:

<pre>touch /var/lib/mod_tile/planet-import-complete</pre>

== Полезные ссылки ==

* [https://github.com/openstreetmap/mod_tile mod_tile]
* [https://github.com/openstreetmap/osm2pgsql osm2pgsql]
* [https://github.com/mapnik/mapnik Mapnik]
* [http://switch2osm.org/ switch2osm]

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T19:28:47Z

Denis Rykov:

{{Статья|Черновик}}
{{Аннотация|Рассматривается процесс создания собственного тайлового сервера на основе данных OpenStreetMap в операционной системе CentOS 6.}}

== Введение ==

На сегодняшний день в подавляющем большинство картографических веб-приложений в качестве одной из подложек используется слой на базе тайлов [http://www.openstreetmap.org/ OpenStreetMap]. Такая популярность данной подложки обусловлена во-первых [http://wiki.openstreetmap.org/wiki/Tile_usage_policy политикой] предоставления тайлов, позволяющей свободно использовать тайлы OpenStreetMap в своих приложениях, а во-вторых - простотой их подключения в современных веб-клиентах, таких как Leaflet и OpenLayers.

Однако иногда возникает необходимость, чтобы данная подложка функционировала в том числе и при отсутствии Интернета (Интранет-приложения). Первым решением данной задачи, которое приходит в голову - это скачать необходимые тайлы с сайта OpenStreetMap. Однако это не очень удачное решение, так как политика использования тайлов запрещает их массовое скачивание и, кроме того, это не гибкий вариант, например, если вы вдруг решите использовать какой-то стиль, отличный от стандартного. Правильным решением данной задачи является получение исходных данных OpenStreetMap и построение на их основе собственного тайлового сервера. Решению данной задачи и посвящена данная статья.

== Стек программных продуктов тайлового сервера openstreetmap.org ==

Существуют различные инструменты создания тайловых серверов со своими плюсами и минусами, мы же рассмотрим данный процесс в разрезе стека технологий, применяемых для создания тайлов на сервере openstreetmap.org. Данный стек состоит из 5 компонентов: mod_tile, renderd, Mapnik, osm2pgsql и PostgreSQL/PostGIS. '''mod_tile''' - это модуль веб-сервера Apache, который отдаёт кэшированные тайлы и определяет нуждаются ли те или иные тайлы в отрисовке (в зависимости от того есть ли они в кэше и не истек ли срок их актуальности). '''renderd''' представляет собой систему управления очередью запросов на рендеринг, предназначенную для оптимизации нагрузки такими запросами. '''Mapnik''' - рендерер, используемый renderd. '''osm2pgsql''' - инструмент загрузки исходных данных OpenStreetMap в базу данных '''PostgreSQL/PostGIS'''.

Данный стек технологий работает только в UNIX-подобных операционных системах и не работает в Windows, так как использует для связи mod_tile и renderd доменные сокеты Unix.

Если в качестве операционной системы вы планируете использовать Debian или Ubuntu, то вам лучше обратиться к [http://switch2osm.org/serving-tiles/building-a-tile-server-from-packages/ инструкции] по развертыванию тайлового сервера для данных операционных систем из пакетов. На том же ресурсе имеется [http://switch2osm.org/serving-tiles/manually-building-a-tile-server-12-04/ инструкция] как развернуть тайловый сервер на Ubuntu (Debian) из исходных кодов. В случае же если ваша операционная система отличается от вышеназванных, то полностью следовать описанным в них шагам не получится, так как некоторые из них довольно Debian-специфичны. Вот тут, возможно, и пригодится вам данная статья.

== Установка программного обеспечения ==

В качестве базового дистрибутива мы будем рассматривать операционную систему CentOS 6 x86_64. Так как большинство из необходимого ПО (mod_tile, renderd, Mapnik, osm2pgsql) для данной операционной системы отсутствуют (либо устарели), а ставить из исходных кодов не очень хорошо, то предварительно соберем их в [https://github.com/nextgis/gis_packages_centos RPM-пакеты]. Для их удобной установки нами был организован тестовый [http://nextgis.ru/programs/centos/ репозиторий]. Как его подключить и работать с ним будет рассмотрено далее.

=== Подключение необходимых репозиториев ===

Подключаем репозиторий EPEL 6:

<pre>yum localinstall http://fedora-mirror01.rbc.ru/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm</pre>

Подключаем репозиторий с PostgreSQL:

<pre>yum localinstall http://yum.postgresql.org/9.3/redhat/rhel-6-x86_64/pgdg-centos93-9.3-1.noarch.rpm</pre>

В файле конфигурации стандартного репозитория, раположенного по адресу ''/etc/yum.repos.d/CentOS-Base.repo'' в секции ''[base]'' и ''[updates]'' добавьте строку:

<pre>exclude=postgresql*</pre>

Подключаем репозиторий enetres, содержащий свежую версию библиотеку Boost C++ 1.55, используемую при сборке Mapnik. Для подключения данного репозитория скопируйте [http://repo.enetres.net/enetres.repo файл] в директорию ''/etc/yum.repos.d/''.

Подключаем репозиторий nextgis: скопируйте [http://nextgis.ru/programs/centos/nextgis.repo файл] в директорию ''/etc/yum.repos.d/''.

=== Установка PostgreSQL/PostGIS ===

Устанавливаем PostgreSQL:

<pre>yum install postgresql93-server
service postgresql-9.3 initdb
service postgresql-9.3 start
chkconfig postgresql-9.3 on</pre>

Устанавливаем PostGIS:

<pre>yum install postgis2_93</pre>

=== Установка mod_tile, renderd, Mapnik, osm2pgsql ===

Устанавливаем основные инструменты:

<pre>yum install apache2-mod_tile renderd mapnik mapnik-python osm2pgsql</pre>

== Создание базы данных и загрузка данных ==

Создаём суперпользователя от имени которого будет вестись работа с базой данных(назовём его ''dr'', а базу данных ''gis''):

<pre>su - postgres -c "createuser dr -s -P -e"
su - postgres -c "createdb -E UTF8 -O dr gis"</pre>

Загружаем функции PostGIS:

<pre>su - postgres -c "psql -d gis -c 'CREATE EXTENSION postgis;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE geometry_columns OWNER TO dr;'"
su - postgres -c "psql -d gis -c 'ALTER TABLE spatial_ref_sys OWNER TO dr;'"</pre>

Загружаем данные в базу. Будем загружать данные на территорию СНГ:

<pre>
mkdir ~/src
cd ~/src
wget http://data.gis-lab.info/osm_dump/dump/latest/local.osm.pbf
osm2pgsql -U dr -W --slim -C 1500 --number-processes 4 -d gis --drop local.osm.pbf
</pre>

При использовании osm2pgsql мы указали объём выделяемой оперативной памяти 1.5 Гб (''-C'' 1500), включили slim-режим (''--slim'', подробности о режимах загрузки данных можно найти в документации) и активировали загрузку в 4 процесса (''--number-processes'' 4). Кроме того, так как мы не планируем diff-обновления наших данных, то используя ключ ''--drop'', мы автоматически удаляем создаваемые при загрузке данных slim-таблицы, что значительно уменьшает размер нашей базы данных. Загрузка данных будет продолжаться несколько часов, сколько конкретно - зависит от аппаратной част и настроек программного обеспечения, более подробную информацию можно получить в данной [http://www.geofabrik.de/media/2012-09-08-osm2pgsql-performance.pdf презентации].

== Настройка стилей Mapnik ==

В качестве стилей тайлов будем использовать стандартный стиль OpenStreetMap. Скачиваем файлы с описанием стиля:

<pre>
cd ~/src
svn co http://svn.openstreetmap.org/applications/rendering/mapnik mapnik-style
</pre>

Стандартный файл стилей Mapnik подразумевает, что для создания тайлов, содержащих береговые линии и территории, занимаемые океанами, на мелких масштабах используются отдельные файлы, а не данные из базы, поскольку так гораздо быстрее. Загружаем эти файлы (порядка 400 Мб):

<pre>
cd ~/src/mapnik-style
./get-coastlines.sh /usr/local/share
</pre>

При выполнении данной команды вы получите сообщение об ошибке следующего вида:

<pre>bunzip2 is not installed in /bin/bunzip2, it is needed by this script</pre>

Чтобы узнать, куда у вас в системе установлен ''bunzip2'', выполните команду:

<pre>which bunzip2</pre>

После чего откройте файл ''get-coastlines.sh'' и отредактируйте следующую строку:

<pre>BUNZIP2=/bin/bunzip2</pre>

В нашем случае она будет выглядеть так:

<pre>BUNZIP2=/usr/bin/bunzip2</pre>

После этого снова запускайте этот файл. Должен начаться процесс загрузки данных:

<pre>./get-coastlines.sh /usr/local/share</pre>

После того как все необходимые файлы были получены, необходимо осуществить небольшую правку конфигурационных файлов для адаптации их под свою систему:

<pre>
cd ~/src/mapnik-style/inc
cp fontset-settings.xml.inc.template fontset-settings.xml.inc
cp datasource-settings.xml.inc.template datasource-settings.xml.inc
cp settings.xml.inc.template settings.xml.inc
</pre>

Открываем файл ''settings.xml.inc'' и приводим его к следующему виду:

<syntaxhighlight lang="xml">



<!ENTITY symbols "symbols">


<!ENTITY osm2pgsql_projection "&srs900913;">




<!ENTITY dwithin_900913 "0.1">
<!ENTITY dwithin_4326 "0.00001">
<!ENTITY dwithin_node_way "&dwithin_900913;">


<!ENTITY world_boundaries "/usr/local/share/world_boundaries">


<!ENTITY prefix "planet_osm">
</syntaxhighlight>

Открываем файл ''datasource-settings.xml.inc'' и приводим его к следующему виду (указав собственный пароль и охват, соответствующий загруженным в базу данным):

<syntaxhighlight lang="xml">


<Parameter name="type">postgis</Parameter>
<Parameter name="password">Ijdg83wk</Parameter>


<Parameter name="user">dr</Parameter>
<Parameter name="dbname">gis</Parameter>

<Parameter name="estimate_extent">false</Parameter>


<Parameter name="extent">-20037508.33,4183149.83,20037508.34,17014106.
</syntaxhighlight>

== Настройка renderd ==

Откройте файл, содержащий настройки renderd. Данный файл расположен по адресу ''/etc/renderd.conf''. Приведите его к следующему виду (так как в нашем примере файл стилей Mapnik находится в домашнем каталоге пользователя, то отредактируйте значение параметра ''XML'' в соответствии со своим пользователем (в нашем примере имя пользователя в системе и имя пользователя в базе данных совпадают, у вас это могут быть совершенно разные пользователи)):

<syntaxhighlight lang="ini">
[renderd]
socketname=/var/run/renderd/renderd.sock
num_threads=4
tile_dir=/var/lib/mod_tile
stats_file=/var/run/renderd/renderd.stats

[mapnik]
plugins_dir=/usr/lib64/mapnik/input
font_dir=/usr/share/fonts/dejavu
font_dir_recurse=1

[default]
URI=/osm_tiles/
TILEDIR=/var/lib/mod_tile
XML=/home/dr/src/mapnik-style/osm.xml
HOST=localhost
CORS=*
TILESIZE=256
</syntaxhighlight>

Создадим директорию в которую будет помещён Unix-сокет для взаимодействия mod_tile и renderd и директорию, в которой будут храниться кэшированные тайлы (соответствующие пути мы прописали в файле ''renderd.conf''):

<pre>
mkdir /var/run/renderd
mkdir /var/lib/mod_tile
</pre>

Сделаем владельцами данных каталогов пользователя, от имени которого будет запускаться renderd. Пусть в нашем случае это будет системный пользователь dr:

<pre>
chown dr /var/run/renderd
chown dr /var/lib/mod_tile
</pre>

== Настройка mod_tile ==

Перейдите в директорию с настройками Apache ''/etc/httpd/conf.d'' и создайте там файл ''mod_tile.conf'' следующего содержания:

<syntaxhighlight lang="xml">
LoadModule tile_module /usr/lib64/httpd/modules/mod_tile.so

<VirtualHost *:80>
ServerName localhost
ServerAdmin webmaster@localhost

LoadTileConfigFile /etc/renderd.conf
ModTileRenderdSocketName /var/run/renderd/renderd.sock
# Timeout before giving up for a tile to be rendered
ModTileRequestTimeout 0
# Timeout before giving up for a tile to be rendered that is otherwise missing
ModTileMissingRequestTimeout 30

ErrorLog /var/log/httpd/error_log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn

CustomLog /var/log/httpd/access_log combined

</VirtualHost>
</syntaxhighlight>

== Проверка корректности произведённых настроек ==

Запускаем renderd вручную:

<pre>renderd -f -c /etc/renderd.conf</pre>

Если при запуске вы столкнётесь с [http://gis.stackexchange.com/q/91759/3420 подобной] проблемой, то поставьте в систему пакет ''proj-epsg'':

<pre>yum install proj-epsg</pre>

Включаем возможность автоматической загрузки Apache после перезагрузки системы:

<pre>chkconfig httpd on</pre>

При запущенном renderd в отдельной консоли перезапускаем Apache:

<pre>service httpd restart</pre>

Должно появиться сообщение следующего содержания:

<pre>Starting httpd: [Wed Jul 09 19:45:29 2014] [notice] Loading tile config default at /osm_tiles/ for zooms 0 - 20 from tile directory /var/lib/mod_tile with extension .png and mime type image/png</pre>

Пробуем открыть какой-нибудь тайл, например:

<pre>http://localhost/osm_tiles/0/0/0.png</pre>

Если вы получили тайл с первого раза - значит вам повезло. Если нет, то смотрите интерактивные логи запущенного renderd и логи Apache:

<pre>tail /var/log/httpd/error_log</pre>

Наиболее распространённая ошибка в логах Apache:

<pre>socket connect failed for: /var/run/renderd/renderd.sock with reason: Permission denied</pre>

Проверьте права доступа к сокету для пользователя, от имени которого запущен Apache:

<pre>sudo -u apache ls -lh /var/run/renderd/renderd.sock</pre>

В документации по mod_tile сказано, что SELinux блокирует соединение mod_tile и renderd, поэтому должен быть отключен (требуется перезагрузка). Также в случае возникновения подобных проблем попробуйте отключить сервис iptables, если он запущен.

Как только вам удастся получить готовый тайл - останавливайте renderd (''Ctrl+C''), запущенный в foreground-режиме.

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T19:21:50Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T19:15:40Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T19:05:03Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T18:53:15Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T18:46:32Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T18:44:55Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T18:41:51Z

Denis Rykov:

Создание тайлового сервера на основе данных OpenStreetMap и mod tile

2014-07-09T18:40:53Z

Denis Rykov: Новая страница: «{{Статья|Черновик}} {{Аннотация|Рассматривается процесс создания собственного тайлового …»

Встреча GIS-Lab 17, Хакатон, АТД

2014-06-01T13:09:24Z

Denis Rykov:

{{Организационное|meet17}}

В рамках 17-й встречи GIS-Lab состоялся хакатон посвященный работе над рядом задач по административно-территориальному делению РФ (АТД).

==Участники==
http://doodle.com/a56e6wichdta9k3b

==Обсуждение в форуме==
http://gis-lab.info/forum/viewtopic.php?t=16654

==Место проведения==
Место проведения: офис NextGIS

==Задачи для хакатона==
Планируется приложить усилия для решения следующих задач (подписывайтесь, можно несколько человек на задачу):

{| class="wikitable"
|-
! Задача !! Описание !! Кто берется !! Сделано !! Итог
|-
| Исправить ошибки в границах Москвы
| Ручное редактирование, частности, нужно исправить пересечения с домами, коих выявлено аж 216 штук
| МД, МК
|
|
|-
| Проверить границы Москвы
| Ручное редактирование, исходные данные - ([http://docs.cntd.ru/document/3608167 ФЗ г. Москвы])
| МД, МК
|
|
|-
| Обновить наборы данных по АТД Москвы
| http://gis-lab.info/qa/moscow-atd.html
|
|
|
|-
| Инструмент для QGIS для разбития полигонов
| На входе слой полигонов и слой линий, на выходе слой полигонов разбитых линиями
| ДР
|
|
|-
| Обновить процесс генерализации АТД
|
|
|
|
|-
| Обновить наборы генерализованных данных
|
|
|
|
|-
| Обновить и улучшить наборы данных по делению на избирательные округа
|
|
|
|
|-
| Починка и наладка сервиса выгрузок границ и регцентров
| http://gis-lab.info/qa/osm-adm.html<br>
http://gis-lab.info/qa/osm-regcenter.html
| ДК
|
|
|-
| Разбивка полигонов линиями
|
|
|
|
|}

{| class="wikitable sortable"
|-
! Код
! Административный округ
! Сокращение
! Код ОКАТО
|-
|1
|Восточный
|ВАО
|45263000
|-
|2
|Западный
|ЗАО
|45268000
|-
|3
|Зеленоградский
|ЗелАО
|45272000
|-
|4
|Новомосковский
|???
|45297000
|-
|5 - NI
|Северный
|САО
|45277000
|-
|6 - EF
|Северо-Восточный
|СВАО
|45280000
|-
|7
|Северо-Западный
|СЗАО
|45283000
|-
|8
|Троицкий
|???
|45298000
|-
|9
|Центральный
|ЦАО
|45286000
|-
|10
|Юго-Восточный
|ЮВАО
|45290000
|-
|11 - NL
|Юго-Западный
|ЮЗАО
|45293000
|-
|12 - MK
|Южный
|ЮАО
|45296000
|-
|}

== Инструмент для QGIS для разбития полигонов ==

Для решения данной задачи можно создать модель в QGIS, использующую алгоритм ''Polygon-line intersection'' из SAGA.

[[Файл:Poly-split-model.png]]

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

==Отчет о результатах==
[http://gis-lab.info/blog/2013-07/hack-uik-results/ О результатах хакатона]

[[Категория:Уточнение расположения УИКов]]
[[Категория:Служебные]]

Файл:Poly-split-model.png

2014-06-01T13:05:33Z

Denis Rykov:

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

2014-03-26T09:06:16Z

Denis Rykov:

{{Статья|Черновик|graphhopper-deploy}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

К роутинговым движкам относится программное обеспечение, позволяющее прокладывать маршрут на карте из одной точки в другую по имеющемуся графу. Существует большое количество программ данного рода, одна из наиболее известных - [http://project-osrm.org/ Open Source Routing Machine (OSRM)], написанная на С++.

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/wiki/Quickstart Quickstart]
# [https://github.com/graphhopper/graphhopper/wiki/Developers Developers]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]
# [http://shtosm.ru/all/grasshopper/ ШТОСМ: Graphhopper]

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

2014-03-25T06:10:05Z

Denis Rykov:

{{Статья|Черновик|graphhopper-deploy}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

К роутинговым движкам относится программное обеспечение, позволяющее прокладывать маршрут на карте из одной точки в другую по имеющемуся графу. Существует большое количество программ данного рода, одна из наиболее известных - [http://project-osrm.org/ Open Source Routing Machine (OSRM)], написанная на С++.

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/wiki/Quickstart Quickstart]
# [https://github.com/graphhopper/graphhopper/wiki/Developers Developers]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]
# [http://shtosm.ru/all/grasshopper/ ШТОСМ: Graphhopper]

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

2014-03-25T06:08:40Z

Denis Rykov:

{{Статья|Черновик|graphhopper-deploy}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

Программное обеспечение данного типа позволяет прокладывать маршрут на карте из одной точки в другую по имеющемуся графу. Существует большое количество программ данного рода, одна из наиболее известных - [http://project-osrm.org/ Open Source Routing Machine (OSRM)], написанная на С++.

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/wiki/Quickstart Quickstart]
# [https://github.com/graphhopper/graphhopper/wiki/Developers Developers]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]
# [http://shtosm.ru/all/grasshopper/ ШТОСМ: Graphhopper]

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

2014-03-23T12:19:50Z

Denis Rykov:

{{Статья|Черновик|graphhopper-deploy}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/wiki/Quickstart Quickstart]
# [https://github.com/graphhopper/graphhopper/wiki/Developers Developers]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]
# [http://shtosm.ru/all/grasshopper/ ШТОСМ: Graphhopper]

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

2014-03-23T12:04:30Z

Denis Rykov:

{{Статья|Черновик|graphhopper-deploy}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/wiki/Quickstart Quickstart]
# [https://github.com/graphhopper/graphhopper/wiki/Developers Developers]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]

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

2014-03-23T11:58:03Z

Denis Rykov: /* Запуск GraphHopper с помощью Jetty */

{{Статья|Черновик|graphhopper-deploy}}
{{Аннотация|Рассмотрен процесс развертывания GraphHopper в качестве Веб-сервиса.}}

== Введение ==

[http://graphhopper.com/ GraphHopper] - это быстрый роутинговый движок, написанный на Java. К его отличительным особенностям можно отнести:

* работу с данными OpenStreetMap
* эффективное использования памяти
* широкие возможности по настройке
* свободная лицензия Apache

Так как код GraphHopper полностью [https://github.com/graphhopper/graphhopper открыт], то вы можете использовать необходимые Java-классы в своём собственном приложении. Кроме того, GraphHopper может быть использован в качестве Веб-сервиса маршрутизации, предоставляющего соответствующий HTTP API. Именно процедуре развертывания GraphHopper в качестве сервиса маршрутизации и посвящена в данная статья. Пример Веб-приложения, использующего GraphHopper в качестве роутингового движка можно посмотреть [http://graphhopper.com/maps/?point=madrid&point=moscow тут]. Отметим, что данное приложение вы получаете автоматически при разворачивании GraphHopper в качестве Веб-сервиса.

Для того, чтобы использовать GraphHopper в качестве Веб-сервиса можно самостоятельно собрать собственный [http://ru.wikipedia.org/wiki/WAR_(%D1%82%D0%B8%D0%BF_%D1%84%D0%B0%D0%B9%D0%BB%D0%B0) WAR-файл] либо воспользоваться уже готовой сборкой. Мы будем использовать как раз готовую сборку. К первому варианту следует прибегать в тех случаях, если готовая сборка вас чем-то не устраивает и вы хотите что-то в ней изменить. Подробнее про сборку GraphHopper [https://github.com/graphhopper/graphhopper/wiki/Developers тут].

Для развертывания WAR-файла нам потребуется воспользоваться каким-либо контейнером сервлетов. Мы рассмотрим два варианта: развертывание GraphHopper: с помощью [http://www.eclipse.org/jetty/documentation/current/jetty-runner.html Jetty Runner] и [http://www.eclipse.org/jetty/ Jetty]. Первый вариант следует использовать, если вы хотите "по-быстрому" оценить, что из себя представляет GraphHopeer. Второй же вариант подходит для промышленного использования.

== Запуск 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.

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

Jetty — это свободный контейнер сервлетов, написанный полностью на Java. Может использоваться как HTTP-сервер или в паре со специализированным HTTP-сервером. Если у вас еще не установлен Jetty, то установите его. Дальнейшие инструкции предполагают, что установлен Jetty версии 9, который слушает порт 8180.

<ol>
<li>В директорию ''webapps'' контейнера Jetty поместите WAR-файл GraphHopper, [http://oss.sonatype.org/content/groups/public/com/graphhopper/graphhopper-web/0.2/graphhopper-web-0.2.war graphhopper-web-0.2.war], переименовав его в ''graphhopper.war''.</li>
<li>Сюда же поместим файл с данными OpenStreetMap, [http://be.gis-lab.info/data/osm_dump/dump/RU-MOS/RU-MOS-140322.osm.pbf Москва].</li>
<li>В корень директории, куда установлен Jetty (уровень вложенности на котором находится директория ''webapps''), поместите файл с настройками GraphHopper [https://raw.github.com/graphhopper/graphhopper/master/config-example.properties config-example.properties], переименовав его в ''config.properties''.</li>
<li>Отредактируйте файл ''config.properties'', добавив в него полный путь до файла с данными OpenStreetMap (замените путь на свой):

<pre># where to find osm/pbf file
osmreader.osm=/usr/local/jetty/webapps/RU-MOS-140322.osm.pbf</pre>
</li>
<li>Перезапустите Jetty. В Linux: <pre>sudo service jetty restart</pre>

После того как вы перезапустили Jetty, в директории webapps будет создана новая директория, содержащая роутинговый граф, в нашем случае это будет директория ''RU-MOS-140322.osm-gh''. Если вы сразу же после перезапуска Jetty попытаетесь перейти по адресу http://localhost:8180/graphhopper/ (либо Jetty вообще не запустился), то ничего не увидите. Нужно подождать некоторое время, пока граф построится (директория ''RU-MOS-140322.osm-gh'' будет непустой), либо если Jetty не запустился, то тоже подождать и запустить его еще раз.</li>
<li>Откройте страницу http://localhost:8180/graphhopper/. Вы должны увидеть карту и следующее сообщение:

<pre>GraphHopper API offline? http://localhost:8180</pre>

Причина возникновения этого сообщения заключается в том, что Веб-приложение ожидает, что HTTP API доступно по адресу http://localhost:8180, а не по http://localhost:8180/graphhopper/. Данную проблему можно решить двумя путями: либо взять исходники GraphHopper, отредактировать там путь и собрать собственный WAR-файл, либо настроить Jetty таким образом, чтобы GraphHopper открывался по адресу http://localhost:8180. Этим способом мы и воспользуемся: просто переименуйте файл ''graphhopper.war'' в ''root.war'' и перезапустите Jetty.</li>
</ol>

== Ссылки ==

# [http://graphhopper.com/ GraphHopper]
# [https://github.com/graphhopper/graphhopper/wiki/Quickstart Quickstart]
# [https://github.com/graphhopper/graphhopper/wiki/Developers Developers]
# [https://github.com/graphhopper/graphhopper/blob/master/docs/web/api-doc.md Routing Web API Docs]