Unduhan polylines - pengunduhan kode sumber polylines

polylines

Kode sumber lainnya

v3.0.0

Unduh

Mesin pencari sumber terbuka dan modular untuk dunia kita.

Pelias adalah geocoder yang didukung sepenuhnya oleh data terbuka, tersedia gratis untuk semua orang.

Instalasi Lokal · Layanan Web Cloud · Dokumentasi · Obrolan Komunitas

Apa itu Pelia?

Pelias adalah mesin pencari tempat di seluruh dunia, yang didukung oleh data terbuka. Ini mengubah alamat dan nama tempat menjadi koordinat geografis, dan mengubah koordinat geografis menjadi tempat dan alamat. Dengan Pelias, Anda dapat mengubah penelusuran tempat pengguna menjadi geodata yang dapat ditindaklanjuti dan mengubah geodata Anda menjadi tempat nyata.

Kami berpendapat data terbuka, sumber terbuka, dan strategi terbuka memenangkan solusi kepemilikan di bagian mana pun dan kami ingin memastikan layanan yang kami tawarkan sejalan dengan visi tersebut. Kami percaya bahwa geocoder terbuka akan berkembang dalam jangka panjang hanya jika masyarakat dapat menggabungkan pengetahuan lokal yang benar-benar mewakili.

Importir Pelias Polyline

Pengimpor polyline memfasilitasi pengimporan data jaringan jalan ke Pelias dari daftar string garis yang dikodekan polyline.

Prasyarat

Node.js diperlukan. Lihat persyaratan perangkat lunak Pelias untuk versi yang didukung.

Kloning dan Instal dependensi

Karena modul ini hanyalah salah satu bagian dari geocoder kami, sebaiknya mulai dengan Dockerfiles kami untuk pengaturan cepat, atau dokumen instalasi lengkap kami untuk menggunakan modul ini.

$ git clone https://github.com/pelias/polylines.git && cd polylines
$ npm install

Unduh datanya

File jaringan jalan seluruh planet yang telah diproses sebelumnya tersedia untuk diunduh dari Geocode Earth.

Catatan: ekstensi file .0sv dan .polylines digunakan secara bergantian, keduanya merujuk pada format file yang sama; namun ada kode yang mencari ekstensi .0sv yang oleh karena itu lebih disukai.

Untuk informasi selengkapnya tentang cara ekstrak dihasilkan, lihat artikel wiki: Menghasilkan polyline dari Valhalla.

Kami juga memiliki beberapa ekstrak yang lebih kecil untuk tujuan pengujian, sejumlah kecil dipotong secara manual dari pbf untuk wilayah geografis kontributor utama kami. Lihat bagian 'Membuat ekstrak polyline khusus dari ekstrak PBF' di bawah untuk informasi selengkapnya tentang cara membuat ekstrak sendiri:

catatan: ekstrak ini dihasilkan menggunakan metode yang berbeda dari potongan planet di atas.

Berlin (1,9MB, 49k jalan)
New York (4,2 MB, 102 ribu jalan)
Finlandia (7,7 MB, 100 ribu jalan)
Swedia (5,9 MB, 126 ribu jalan)
London (5,6 MB, 166 ribu jalan)
Paris (2,9 MB, 81 ribu jalan)
San Francisco (1,3 MB, 27 ribu jalan)
Selandia Baru (3,1 MB, 52 ribu jalan)
Chicago (3,5 MB, 88 ribu jalan)
Singapura (0,6 MB, 16 ribu jalan)

Setelah Anda mengunduh dan mengekstrak data, Anda harus mengikuti langkah-langkah Konfigurasi di bawah ini untuk memberi tahu Pelias di mana data tersebut dapat ditemukan.

Jika Anda ingin menggunakan sumber data polyline yang berbeda, Anda mungkin perlu mengubah default di ./stream/pipeline.js , buka masalah jika Anda mengalami kebuntuan.

Menghasilkan data Anda sendiri

Anda dapat membuat file polylines dari data Anda sendiri, data HARUS dikodekan dalam format berikut:

setiap baris file mewakili satu dokumen, baris diakhiri dengan karakter baris baru ( n ).
baris berisi beberapa kolom, kolom dibatasi dengan karakter byte nol ( ).

Geometri dikodekan menggunakan algoritma polyline Google dengan presisi 6 .

CATATAN: banyak perpustakaan akan menetapkan presisi default ke 5 , ini akan menyebabkan kesalahan, pastikan untuk memilih presisi polyline yang benar.

Ada skrip yang disertakan dalam repo ini yang mampu mengkode ulang file yang dihasilkan dengan presisi 5 hingga presisi 6 , Anda dapat menemukannya di bin/reencode.js .

Setiap baris dimulai dengan polyline yang dikodekan, diikuti oleh byte nol ( ) lalu diikuti oleh satu atau lebih nama (dibatasi dengan byte nol) dan akhirnya diakhiri dengan baris baru ( n ).

Contoh:

 {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.

Konfigurasi

Untuk memberi tahu importir lokasi unduhan dan pengaturan lingkungan Anda, pertama-tama Anda harus membuat file ~/pelias.json .

Lihat dokumentasi konfigurasi untuk detail tentang struktur file ini. Info konfigurasi Anda yang relevan untuk modul polyline mungkin terlihat seperti ini:

catatan: importir saat ini hanya mendukung satu entri dalam array files . Selain itu, file konfigurasi hanya menerima "polyline" (tanpa "s").

  "imports" : {
    "polyline" : {
      "datapath" : "/data" ,
      "files" : [ "road_network.0sv" ]
    }
  }

Pencarian Hierarki Administratif

Data Polyline tidak memiliki hierarki administratif penuh (yaitu nama negara, negara bagian, kabupaten, dll.), namun dapat dihitung menggunakan data dari Who's on First. Lihat readme untuk pelias/wof-admin-lookup untuk informasi lebih lanjut. Secara default, adminLookup diaktifkan. Untuk menonaktifkan, setel imports.adminLookup.enabled ke false di konfigurasi Pelias.

Catatan: Pencarian admin memerlukan pemuatan sekitar 5 GB data ke dalam memori.

Menjalankan impor

Ini akan memulai proses impor, diperlukan waktu sekitar 30 detik untuk mengungguli data dalam memorinya dan kemudian Anda akan melihat keluaran debugging reguler di terminal.

$ PELIAS_CONFIG= < path_to_config_json > npm start

alat CLI

Anda dapat menggunakan alat CLI untuk menjalankan impor dan untuk tujuan debugging:

catatan: secara default alat cli akan membaca dari stdin dan menulis ke 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

Contoh

Jalankan 'dry-run' dari proses impor:

node ./bin/cli.js --config --pretty

Impor file tertentu ke elasticsearch:

node ./bin/cli.js --file=/tmp/myfile.polylines --db

Menghasilkan ekstrak polyline khusus dari ekstrak PBF

Anda dapat membuat ekstrak polyline khusus menggunakan alat OSM PBF ini.

Catatan: golang 1.9+ diperlukan, pastikan ini diinstal dengan benar sebelum melanjutkan.

 $ 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

Masalah

Jika Anda mengalami masalah dalam penyiapan atau ada sesuatu yang hilang dalam dokumentasi, silakan buka masalah di sini: https://github.com/pelias/polylines/issues

Berkontribusi

Silakan fork dan tarik permintaan terhadap master upstream di cabang fitur.

Tolong cantik; menyediakan pengujian unit dan perlengkapan skrip di direktori test .

Kode Linting

File .jshintrc disediakan yang berisi konfigurasi linting, biasanya editor teks Anda akan memahami konfigurasi ini dan memberi Anda petunjuk sebaris tentang gaya dan keterbacaan kode.

Pengaturan ini diterapkan secara ketat ketika Anda melakukan git commit , Anda dapat mengeksekusi git commit kapan saja untuk menjalankan linter terhadap kode Anda.