Giter Club home page Giter Club logo

Taginfo

Brings together information about OpenStreetMap tags and makes it searchable and browsable.

Documentation: See the Taginfo page at the OpenStreetMap wiki.

Live System: taginfo.openstreetmap.org

There is no versioning of these tools. The official site always runs the version tagged osmorg-taginfo-live. If you are using the tools, we encourage you to stay up-to-date with that version also. But monitor your setup closely when you switch to a new version, sometimes things can break.

Files

  • /sources - import scripts
  • /web - web user interface and API
  • /examples - some misc example stuff

Prerequisites

It uses:

  • Ruby (must be at least 3.0)
  • Sinatra web framework and other ruby libraries
  • curl binary
  • sqlite3 binary (version 3.33 or above with FTS5 and regexp support)
  • Optional: Parallel bzip (pbzip2)

Install the Debian/Ubuntu packages:

$ sudo apt-get install curl sqlite3 sqlite3-pcre
$ sudo apt-get install ruby-passenger libapache2-mod-passenger

Install the Gems:

$ sudo gem install bundler
$ sudo bundle install

Depending on your setup you might want to install an application server like

  • uWSGI or
  • Apache2 mod_passenger

If you want to create the taginfo database yourself, you need to have https://github.com/taginfo/taginfo-tools installed. See there for details. If you only want to run the UI and get the database from somewhere else, you do not need this.

Data Import

See Taginfo/Installation at OpenStreetMap's wiki.

Web User Interface

You need a /data directory (in the parent directory of the directory where this README.md is). It must contain the sqlite database files created in the data import step or downloaded from page taginfo.openstreetmap.org/download.

To start the web user interface:

cd web
./taginfo.rb

You can also use it via uWSGI.

(On Debian install these packages: uwsgi uwsgi-core uwsgi-plugin-rack-ruby3.1.)

cd web
bundle exec uwsgi uwsgi.ini

You can change various settings in the config file and use it through a web server like Apache2 or Nginx.

Tests

There are a few tests for the Ruby code. Call rake in the web directory to run the tests.

Rubocop

There is a configuration for Rubocop. You can run Rubocop with rubocop FILENAME.rb... to check one or more Ruby files. Fixing issues is currently an ongoing process.

Javascript

Taginfo uses the following Javascript libraries:

All the Javascript and CSS needed is already included.

Thanks

To the many people helping with bug reports, code and translations.

Contact

There is a mailing list for developers and people running their own instances of taginfo: taginfo-dev

Author

Jochen Topf ([email protected]) - https://jochentopf.com/

taginfo's Projects

taginfo icon taginfo

Brings together information about OpenStreetMap tags and makes it searchable and browsable

testserver icon testserver

Set up test server for taginfo (for developers)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.