Geocode Tool allows to geocode an address list using a simple web interface.

Building WebMap application you often face a task of address-to-coordinates convertion for every object in your DataBase. Depending on a number of objects this task can be solved manually or by creating complex client-server system with caching and requests multiplication.

We've decided to provide this online application as a ready-made solution for small business with a few number of objects as well as an example of efficient and smart application for projects with a large amount of data.

For using this tool locally you have to install NodeJS with NPM and any kind of WebServer e.g. Nginx. Clone this repo to your Work folder and run cd geocode-tool && npm install. Start server with node server.js command.

You can use this nginx config example to setup your own server.

server {
  listen 80;

  # use your /etc/hosts file to map geocodetool.loc address to localhost
  # web-interface will work on http:https://geocodetool.loc/tools/geocode/
  server_name .geocodetool.loc;

  access_log /var/log/geocode-tool.access.log;
  error_log /var/log/geocode-tool.error.log;

  # url path of tool to use in browser
  # change %username% to your system login
  location /tools/geocode/ {
    alias /Users/%username%/Work/geocode-tool/public/;
  }
  # proxy requests to localhost on port 8887
  location /geocode-tool/ {
    proxy_pass http:https://localhost:8887/;
  }
}

For run this tool as a docker container you have to do next:

1. clone this repo
2. put your yandex API key in config/global.json
3. if you want to use web ui also put API key to public/index.html like so

<script src="//api-maps.yandex.ru/2.1/?lang=ru-RU&apikey=YOUR_APIKEY_HERE"></script>

4. build your own image

docker build -t geocode-tool:v1 .

5. and run it

docker run -d -p 8887:8887 geocode-tool:v1

P.S. I using the same nginx config as above for proxy requests from my domain name to geocode-tool