polylines
v3.0.0
Pelias — это геокодер, полностью основанный на открытых данных, доступных каждому бесплатно.
Локальная установка · Облачный веб-сервис · Документация · Чат сообщества
Импортер полилиний облегчает импорт данных дорожной сети в Pelias из списка строк, закодированных полилиниями.
Требуется Node.js. См. требования к программному обеспечению Pelias для получения информации о поддерживаемых версиях.
Поскольку этот модуль является лишь частью нашего геокодера, мы рекомендуем начать с файлов Dockerfile для быстрой настройки или с полной документации по установке, чтобы использовать этот модуль.
$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm installПредварительно обработанные файлы дорожной сети всей планеты доступны для загрузки с Geocode Earth.
Примечание. Расширения файлов
.0svи.polylinesвзаимозаменяемы, оба они относятся к одному и тому же формату файла; однако существует код, который ищет расширение.0sv, поэтому оно предпочтительнее.
Для получения дополнительной информации о том, как был создан фрагмент, см. статью вики: Генерация полилиний из Валгаллы.
У нас также есть несколько небольших отрывков для целей тестирования, небольшое количество было вручную вырезано из PBF для географических регионов наших основных участников. Дополнительную информацию о том, как создавать собственные фрагменты, см. в разделе «Создание пользовательского извлечения полилиний из извлечения PBF» ниже:
примечание: эти экстракты были созданы с использованием метода, отличного от метода планеты, вырезанного выше.
После того, как вы загрузили и извлекли данные, вам нужно будет выполнить приведенные ниже шаги настройки , чтобы сообщить Pelias, где их можно найти.
Если вы хотите использовать другой источник данных полилиний, вам может потребоваться настроить значения по умолчанию в ./stream/pipeline.js , откройте проблему, если вы застряли.
Вы можете создать файл полилиний из собственных данных, данные ДОЛЖНЫ быть закодированы в следующем формате:
n ). ). Геометрия кодируется с использованием алгоритма полилиний Google с точностью 6 .
ПРИМЕЧАНИЕ. Во многих библиотеках точность по умолчанию равна 5 , это приведет к ошибкам. Обязательно выберите правильную точность полилинии.
В этот репозиторий включен скрипт, который способен перекодировать файлы, созданные с точностью от 5 до точности 6 Его можно найти в bin/reencode.js .
Каждая строка начинается с закодированной ломаной линии, за которой следует нулевой байт ( ), затем следует одно или несколько имен (отделенных нулевым байтом) и, наконец, заканчивается символом новой строки ( n ).
Пример:
{polyline6} {name} {name}n
oozdnAwvbsBoA?g@{@SoAf@{@nAg@Plaça de la Creu
00000000: 6f6f 7a64 6e41 7776 6273 426f 413f 6740 oozdnAwvbsBoA?g@
00000010: 7b40 536f 4166 407b 406e 4167 4000 506c {@SoAf@{@[email protected]
00000020: 61c3 a761 2064 6520 6c61 2043 7265 750a a..a de la Creu.
Чтобы сообщить импортеру расположение ваших загрузок и настройки среды, вам сначала необходимо создать файл ~/pelias.json .
Подробную информацию о структуре этого файла смотрите в документации по конфигурации. Соответствующая информация о конфигурации для модуля полилинии может выглядеть примерно так:
примечание: в настоящее время импортер поддерживает только одну запись в массиве files . Кроме того, файл конфигурации принимает только «полилинию» (без «s»).
"imports" : {
"polyline" : {
"datapath" : "/data" ,
"files" : [ "road_network.0sv" ]
}
} Данные полилиний не имеют полной административной иерархии (т. е. названий стран, штатов, округов и т. д.), но их можно рассчитать с использованием данных из раздела «Кто на первом месте». Дополнительную информацию см. в файле readme для pelias/wof-admin-lookup. По умолчанию adminLookup включен. Чтобы отключить, установите для imports.adminLookup.enabled значение false в конфигурации Pelias.
Примечание. Для поиска администратора требуется загрузить в память около 5 ГБ данных.
Это запустит процесс импорта, загрузка данных в память займет около 30 секунд, а затем вы должны увидеть регулярные выходные данные отладки в терминале.
$ PELIAS_CONFIG= < path_to_config_json > npm startВы можете использовать инструмент CLI для запуска импорта и в целях отладки:
примечание: по умолчанию инструмент cli будет читать со stdin и записывать на stdout .
$ node ./bin/cli.js --help
Usage: cli.js [options]
Options:
--file read from file instead of stdin
--config read filename from pelias config (overrides --file)
--pretty indent output (stdout only)
--db save to elasticsearch instead of printing to stdout
Запустите «пробный прогон» процесса импорта:
node ./bin/cli.js --config --prettyИмпортируйте определенный файл в elasticsearch:
node ./bin/cli.js --file=/tmp/myfile.polylines --dbВы можете создать собственный фрагмент полилиний с помощью этого инструмента OSM PBF.
Примечание. Требуется golang 1.9+. Прежде чем продолжить, убедитесь, что он установлен правильно.
$ go version
go version go1.10 linux/amd64
$ go install github.com/missinglink/pbf@latest
$ pbf --help
$ wget https://s3.amazonaws.com/metro-extracts.nextzen.org/chicago_illinois.osm.pbf
$ pbf streets chicago_illinois.osm.pbf | head
yop}nApvc_gDqAywAEast Altgeld Avenue
wto}nAfpl_gDqFuzEEast Altgeld Avenue
_mr}nAbvb~fDkFmQ}BkQ}AkdBEast Altgeld Avenue
mwp}nAt{q~fDKkW]yFi@mDwBcIeS_f@qE}LmDyMwAaH_AoE}C{Uy@mMYaHyCwlDSsFi@iFwEaUEast Altgeld Avenue
smvaoAzxdmfDwbAtyB}cAvzBscAzxBmcAhyB{j@pnAmE|HNorth Navarre Avenue
wq~hoAvt~dgD?hGJfDfCl@zBr@dBrBbDv@jBx@hCpBtBBbCDnB@`@gBpC]jBEzCF~BL~AdBxH?VKpSHidden Lakes Boulevard
o~cooAb~}xfDn_@i^Taggert Court
{garnA|_~zfDo@qdA}@kEWater Tower Lane
ka|}nAh`jlgDdD{C~MmNrByHTall Grass Court
onvdnAbntyfDpMvOhHtCTall Grass Court
$ pbf streets chicago_illinois.osm.pbf > chicago_illinois.polylines
Если у вас возникли проблемы с настройкой или что-то не хватает в документации, откройте проблему здесь: https://github.com/pelias/polylines/issues.
Пожалуйста, сделайте форк и запрос на вытягивание к восходящему мастеру в функциональной ветке.
Красиво, пожалуйста; предоставить модульные тесты и скрипты в test каталоге.
Предоставляется файл .jshintrc , содержащий конфигурацию проверки. Обычно ваш текстовый редактор понимает эту конфигурацию и дает вам встроенные подсказки по стилю и читабельности кода.
Эти настройки строго соблюдаются при выполнении git commit , вы можете выполнить git commit в любое время, чтобы запустить линтер для вашего кода.
$ npm testТрэвис тестирует каждое изменение на поддерживаемых нами версиях Node.js.
