JOSM/Plugins/Scanaerial

Windows

1. Unzip the archive and put it in a directory you like (e.g. C:\scanaerial\);
2. Install Python, version 2.7 recommended (in our example installed to C:\python27\) :
   • python-2.7.10.msi for Win32 (works for Win64, too)
3. Install needed Python libraries:
   • Python Imaging Library (PIL/Pillow)
   • Python Projection Library (PyProj) (related issue):
     • use this command to install it: C:\python27\Scripts\pip.exe install pyproj==1.9.6
4. Install ext_tools Plugin in JOSM (more information on JOSM/Plugins#Installation) & Restart JOSM
5. In JOSM press F12 and go to Ext_Tools configuration
6. Add a new tool by clicking the button saying so. Give the tool a good name (scanaerial would be an idea) and paste this as commandline:

C:\python27\python.exe C:\scanaerial\scanaerial.py {lat} {lon} {TZoom}

If there is a space in the name of the directory (e.g. C:\scan aerial\) use this:

C:\python27\python.exe "C:\SCANAE~1\scanaerial.py" {lat} {lon} {TZoom}

To always use Config-File setting fixedzoomlevel, use it without {TZoom}:

C:\python27\python.exe C:\scanaerial\scanaerial.py {lat} {lon}

It will create a new menu item in the tools menu.

See also JOSM/Plugins/Scanaerial/Windows

Linux

• Unzip the contents of the downloaded archive to the JOSM Plugin directory. Put it to: ~/.josm/plugins/ext_tools/scanaerial
• Install Python + needed libraries:
  • Fedora: yum install pyproj python-pillow
  • Ubuntu: sudo apt-get install python-pyproj python-pil
• Install Ext_tools-Plugin in JOSM (more information on JOSM/Plugins#Installation) & Restart JOSM
• In JOSM press F12 and go to Ext_tools configuration
• Add a new tool by clicking the button saying so. Give the tool a good name (scanaerial would be an idea) and paste this as commandline:

/home/<username>/.josm/plugins/ext_tools/scanaerial/scanaerial.py {lat} {lon} {TZoom}

It will create a new menu item in the tools menu. (NB: Syntax may change soon. Due to a bug in Ext_tools you can not write “~” instead of “home”)

If you have python3 also installed on your system it may be the default python version, so you should add python2 interpreter at the beginning of commandline e.g. in Arch

python2 /home/<username>/.josm/plugins/ext_tools/scanaerial/scanaerial.py {lat} {lon} {TZoom}

Multiple configurations

It is possible to configure Scanaerial to work with several distinct config files. To do so create a separate tool with distinct names for each configuration. The name of the configuration file is passed as the fourth argument to scanaerial.py

Example commandline:

/home/<username>/.josm/plugins/ext_tools/scanaerial/scanaerial.py {lat} {lon} {TZoom} myconfig1.cfg