From OpenStreetMap Wiki
Jump to: navigation, search


The Imagery XML Bounds plugin for JOSM allows to edit boundaries used to describe Aerial imagery sources coverage that can be found on

These boundaries are then displayed in the Imagery Preferences dialog:

Josm imagery preferences.png


  • Import XML files describing imagery entries, compliant with the XML Schema located at, to a JOSM data layer.
  • Export a data layer, or selected objects to such a XML file.
  • Edit boundaries, just by using classic JOSM edition tools.
  • Direct and syntax-colored view of corresponding XML code for a data layer or selected objects.


The plugin is available on OSM SVN and can be installed from Plugins tab in JOSM (version 4488 or later) preferences:

Josm plugins preferences bounds.png



Just open a file (Ctrl-O) and select a XML file using the extension *.imagery.xml:

Josm open imagery xml.png

If you want to edit, you can open it with using Ctrl-L shortcut (File -> Open Location, only with JOSM 4523 or later):

Josm open imagery xml location.png

Note that the selected XML file is first validated against the XSD. However, the plugin allows you to bypass this check if you desperately need to open an invalid file (at your own risks):

Josm open imagery xml error.png


Just save a layer using "Save" or "Save as" and select the same extension as for import:

Josm save imagery xml.png


Well, you already know how to use JOSM, right ? :)

Direct view

You can view the corresponding XML code using right click menu on any layer/closed way/multipolygon relation in JOSM main dialogs:

Josm generate xml imagery bounds.png

This opens a dialog window allowing you to copy XML code:

Josm imagery bounds ouput.png


If you find a bug, please open a ticket on JOSM trac: Remember first to check you are at least using the last stable versions of JOSM and its plugins.