| 10 | | [[Image(source:/trunk/images/imagery_menu.png)]] For each image source a menu point is added. When clicking on that menu you get a new layer with this image source. |
| 11 | | |
| 12 | | == Metacarta Rectified Image == |
| 13 | | |
| 14 | | [[Image(source:/trunk/images/OLmarker.png)]] For use with Metacarta's [http://labs.metacarta.com/rectifier/ Map Rectifier]. |
| 15 | | |
| 16 | | Clicking on this opens up a dialog box requesting an id. The id is obtained from either the page url or the WMS link. (for example, |
| 17 | | http://labs.metacarta.com/rectifier/rectify/73 - the id would be 73) |
| 18 | | |
| 19 | | Note if you are using these images for editing then you need to ensure the image, and its method of rectification, are free of any copyright issues. |
| 20 | | |
| 21 | | == Blank layer == |
| 22 | | |
| 23 | | [[Image(source:/trunk/images/blankmenu.png)]] In certain situations a blank imagery layer is needed (e.g. loading saved layers). |
| 24 | | |
| 25 | | == Installing Yahoo! aerial imagery downloader == |
| 26 | | To use Yahoo! aerial imagery you will need to install a tool for interfacing with Yahoo to download tiles. |
| 27 | | |
| 28 | | === Windows === |
| 29 | | |
| 30 | | ==== webkit-image ==== |
| 31 | | On '''Windows''' use the [http://en.wikipedia.org/wiki/WebKit WebKit] based downloader called webkit-image as follows |
| 32 | | |
| 33 | | * [http://josm.openstreetmap.de/download/windows/webkit-image.zip Download webkit-image.zip] |
| 34 | | * Unzip it. |
| 35 | | * Move the contents so that the DLL files and the EXE file are somewhere "on your system path". The best way to achieve this might be to place them alongside josm. Keep the 'imageformats' subfolder alongside too (so ''all'' the contents of the zip). |
| 36 | | * Restart JOSM |
| 37 | | * Select the Yahoo menu point. |
| 38 | | You should start to get Yahoo! imagery (may take up to 30 seconds to start showing). If not, it may not be finding the DLL files correctly. |
| 39 | | |
| 40 | | '''Note:''' If you don't want to place webkit-image in your system path or the JOSM directory you don't have to. By editing the download program you can specify an absolute or relative path to the webkit-image executable. Examples: |
| 41 | | * '''webkit/webkit-image {0}''' - loads webkit-image.exe from the subdirectory '''webkit''' relative to the JOSM installation directory |
| 42 | | * '''D:/webkit/webkit-image {0}''' - uses webkit-image '''D:\webkit\webkit-image.exe''' |
| 43 | | |
| 44 | | === Linux kernel Operating Systems === |
| 45 | | '''On Linux''' you can use different downloaders: ''gnome-web-photo'' or ''webkit-image''. |
| 46 | | |
| 47 | | ==== OpenSuSE, SuSE and SLES Distributions ==== |
| 48 | | |
| 49 | | ===== release 11.3 (opensuse) ===== |
| 50 | | * '''gnome-web-photo''' : this can be installed using '''yast''' |
| 51 | | * '''webkit-image''' : can be built for Qt if you have development tools installed. You will need to use '''yast''' to install: |
| 52 | | * libQTWebKit4-devel and friends |
| 53 | | * libqt4-devel and friends |
| 54 | | * pkg-config |
| 55 | | * other more general requirements depending on your build environment |
| 56 | | then follow the instructions below for ''Build from Source'' |
| 57 | | * '''webkit-image-gtk''' : try instructions below for ''webkit-image (GTK+)'' after installing libwebkit (+friends) and gtk2-devel; you will need to edit an ''include'' line in '''webkit-image-gtk.c''' so that it points to ''gio-unix-2.0/gio'' and not just ''gio'', it should read: |
| 58 | | {{{ |
| 59 | | #include <gio-unix-2.0/gio/gunixoutputstream.h> |
| 60 | | }}} |
| 61 | | Although the tool should now compile it may not scale tiles correctly within JOSM; use one of the other tools instead |
| 62 | | |
| 63 | | ==== gnome-web-photo for Fedora and Ubuntu ==== |
| 64 | | gnome-web-photo is compiled and prepackaged for some distributions, including Fedora and Ubuntu. |
| 65 | | |
| 66 | | '''Attention:''' You have to select ''gnome-web-photo --mode=photo --format=png {0} /dev/stdout'' at the preferences dialog of the wms plugin. |
| 67 | | |
| 68 | | ===== On Ubuntu 8.10 'Intrepid Ibex' ===== |
| 69 | | * Install gnome-web-photo through synaptic ''(version used 0.3-0ubuntu2)'' |
| 70 | | * Select ''gnome-web-photo --mode=photo --format=png {0} /dev/stdout'' as the downloader at the bottom of the WMS preferences pane. Then you can choose the "Yahoo Sat" option from the WMS pull down menu to get the background to download. You might have to zoom out a bit if data is not available at the current zoom level. |
| 71 | | |
| 72 | | ===== On Ubuntu 9.04 'Jaunty Jackalope' ===== |
| 73 | | |
| 74 | | The gnome-web-photo package in Ubuntu 9.04 has introduced bugs with JOSM, resulting in mis-aligned and distorted WMS imagery. This can be rectified by installing an older version of gnome-web-photo. |
| 75 | | |
| 76 | | While the common suggestion has been to compile and manually install gnome-web-photo, you can get away with installing the version from Ubuntu 8.10 instead. |
| 77 | | |
| 78 | | * [https://help.ubuntu.com/community/SynapticHowto#Adding%20or%20Removing%20Software Uninstall any existing version] of gnome-web-photo using Synaptic, or by issuing the following command on the command line: ''sudo apt-get remove gnome-web-photo'' |
| 79 | | * Download an older version of [http://archive.ubuntu.com/ubuntu/pool/universe/g/gnome-web-photo/ gnome-web-photo from the Ubuntu Mirror]. |
| 80 | | * gnome-web-photo_0.3-0ubuntu2_amd64.deb for 64 bit Ubuntu systems. |
| 81 | | * gnome-web-photo_0.3-0ubuntu2_i386.deb for 32 bit Ubuntu systems. |
| 82 | | * Once the file has downloaded, double click it to install it to your system. If for some reason this doesn't work, you can install it from the command line using ''sudo dpkg -i gnome-web-photo_0.3-0ubuntu2_*.deb'' |
| 83 | | *Note, this may introduce problems when you upgrade to later versions of Ubuntu, so you may need to uninstall this package before you do so. You can do this by following the instructions in step one. |
| 84 | | *Every time you update your packages Ubuntu will attempt to update this package to the broken version. To stop this from happening add the following three lines to your /etc/apt/preferences (you may have to create this file)[[br]]''Package: gnome-web-photo''[[br]]''Pin: version 0.3*''[[br]]''Pin-Priority: 1001'' |
| 85 | | * This may introduce dependencies problems, the package requires libxul0d. Run the command ''sudo apt-get -f install'' and it should fix any problems. |
| 86 | | * Select 'gnome-web-photo --mode=photo --format=png {0} /dev/stdout' as the downloader at the bottom of the WMS preferences pane. Then you can choose the "Yahoo Sat" option from the WMS pull down menu to get the background to download. You might have to zoom out a bit if data is not available at the current zoom level. |
| 87 | | |
| 88 | | ===== On Ubuntu 9.10 'Karmic Koala' ===== |
| 89 | | |
| 90 | | The gnome-web-photo package in Ubuntu 9.10 does not seem to download any data.[[br]] |
| 91 | | Repeat the steps listed above for 9.04 by installing the old version of the package and it works. |
| 92 | | |
| 93 | | ===== On Ubuntu 10.04 'Lucid Lynx' ===== |
| 94 | | * The gnome-web-photo(''(version used 0.8-0ubuntu2)'') package in Ubuntu 10.04 does not seem to download any data. |
| 95 | | * Goto Preferences>WMS>Add and give this address http://wms.latlon.org/?layers=yhsat& |
| 96 | | |
| 97 | | ===== On Ubuntu 10.04.1 'Lucid Lynx' ===== |
| 98 | | * Install the latest gnome-web-photo(''(version used 0.8-0ubuntu3)'') package from Synaptic (or any other way you like). |
| 99 | | And select 'gnome-web-photo --mode=photo --format=png {0} /dev/stdout' as the downloader at the bottom of the WMS preferences pane in JOSM. |
| 100 | | |
| 101 | | ===== Troubleshooting: if you see white stripes ===== |
| 102 | | * download [http://svn.openstreetmap.org/applications/editors/josm/webgrabber/gnome-web-photo-fixed gnome-web-photo-fixed] from OSM SVN repository |
| 103 | | sudo cp gnome-web-photo-fixed /usr/local/bin |
| 104 | | sudo chmod a+x /usr/local/bin/gnome-web-photo-fixed |
| 105 | | * install package netpbm |
| 106 | | * in JOSM -> Settings -> WMS, change "gnome-web-photo" to "gnome-web-photo-fixed" in the selection for download program. |
| 107 | | |
| 108 | | ==== webkit-image (QT) ==== |
| 109 | | WebKit has some flavors, the main ones are QT-WebKit and WebKit-GTK+. See below for the GTK+ version. |
| 110 | | |
| 111 | | ===== On Debian unstable/sid ===== |
| 112 | | |
| 113 | | If you installed josm with aptitude/apt-get you should get webkit-image-'''gtk''' installed automatically. If for some reason you don't have it, or it is not working correctly, you can install webkit-image-qt with the following command: |
| 114 | | |
| 115 | | sudo aptitude install webkit-image-qt |
| 116 | | |
| 117 | | If you have both webkit-image-qt and webkit-image-gtk installed and want to make sure that josm is using webkit-image-qt you can either: |
| 118 | | |
| 119 | | sudo aptitude remove webkit-image-gtk |
| 120 | | |
| 121 | | or |
| 122 | | |
| 123 | | sudo update-alternatives --config webkit-image |
| 124 | | |
| 125 | | or |
| 126 | | |
| 127 | | go to the josm preferences, WMS tab and change "webkit-image {0}" to "webkit-image-qt {0}". |
| 128 | | |
| 129 | | ===== Building from Source ===== |
| 130 | | * Install the following packages: build-essential libqt4-dev (>= 4.4.3) libqt4-webkit pkg-config |
| 131 | | * Download and compile (you may have to replace moc with moc-qt4, or /usr/include/qt4 with /usr/lib/qt4/include): |
| 132 | | wget http://svn.openstreetmap.org/applications/editors/josm/webgrabber/webkit-image.cpp |
| 133 | | moc webkit-image.cpp > webkit-image.h |
| 134 | | g++ -I /usr/include/qt4/ -I /usr/include/qt4/QtGui -I /usr/include/qt4/QtNetwork/ webkit-image.cpp -o webkit-image -lQtCore -lQtWebKit -lQtGui -s -O2 |
| 135 | | * instead of the previous step, you can use the packaged Makefile: |
| 136 | | svn co http://svn.openstreetmap.org/applications/editors/josm/webgrabber |
| 137 | | cd webgrabber |
| 138 | | make webkit-image |
| 139 | | * Copy it to somewhere in your path: |
| 140 | | sudo cp -v webkit-image /usr/local/bin/ |
| 141 | | |
| 142 | | : QT 4.2.1 from current Debian stable/etch is missing files, you'll absolutely need to compile. These files appear not before 4.4.3-1, that is in testing/lenny (checked in Ubuntu archives). You'll have to leave the "clean" state of our stable system to get the Debian testing or unstable package and it's dependencies. To do so, you'd like to add at least one line like |
| 143 | | http://ftp.debian.org/debian/ testing main contrib non-free |
| 144 | | : into your /etc/apt/sources.list file, or you'll not be able to even see the needed packages. Think twice before allowing any upgrade of existing packages to a more recent testing or unstable version, however, you'll have no choice to get Yahoo imagery working again with current JOSM revisions ... |
| 145 | | |
| 146 | | : Running aptitude I found following packages as mimimum additional install: libqt4-xml, libqt4-dbus, libqt4-script, libqt4-designer, libqt4-sql, libqt4-qt3support, libqt4-svg, libqt4-xmlpatterns, libqt4-help, libqt4-assistant, libqt4-test, qt4-qmake, libqt4-dev (all 4.4.3-1), but your experience may vary. |
| | 11 | ||= **Icon** =||= **Name** =||= **Shortcut** =||= **Description** =|| |
| | 12 | || [[JOSMImage(dialogs/reorderlayers,link=,28,middle)]] || [wikitr:/Help/Action/ReorderImageryLayers Reorder Imagery Layers] || ''various'' || Reorders non-overlay imagery layers. || |
| | 13 | || [[JOSMImage(preference,link=,28,middle)]] || [wikitr:/Help/Preferences/Imagery Imagery preferences...] || || Opens the respective tab in the preferences. Imagery servers can be added and edited there. || |
| | 14 | || [[Image(source:/osm/applications/editors/josm/plugins/imagery_offset_db/images/getoffset.png,link=,28,middle)]] || Get Imagery Offset... || `Ctrl+Alt+I` || Download offsets for current Imagery (''**optional**, from the [osmwiki:Imagery_Offset_Database Imagery Offset Database Plugin]'') || |
| | 15 | || [[Image(source:/osm/applications/editors/josm/plugins/imagery_offset_db/images/storeoffset.png,link=,28,middle)]] || Store Imagery Offset... || || Saves for current imagery an offset in the offset database (''**optional**, from the [osmwiki:Imagery_Offset_Database Imagery Offset Database Plugin]'') || |
| | 16 | || [[JOSMImage(mapmode/adjustimg,link=,28,middle)]] || [wikitr:/Help/Action/ImageryAdjust New offset] || || Opens a window to adjust the offset of an imagery. || |
| | 17 | |||| |
| | 18 | ||||||||=Here will appear all imageries, which are activated in the [[JOSMImage(preferences/imagery)]] [wikitr:/Help/Preferences/Imagery Imagery preferences]. The following eight entries are already activated from the beginning. Clicking on one of the entries will add the imagery to the [[JOSMImage(dialogs/layerlist)]] [wikitr:/Help/Dialog/LayerList Layer list] panel. Adding an imagery is also illustrated in the [wikitr:/Introduction#EnableAerialimagery introduction]. =|| |
| | 19 | ||= **Icon** =||= **Name** =||||= **Description** =|| |
| | 20 | || [[Image(bing.png,link=,28,middle)]] || Bing aerial imagery |||| || |
| | 21 | || [[Image(esri.png,link=,28,middle)]] || Esri World Imagery |||| || |
| | 22 | || [[Image(esri_clarity.png,link=,28,middle)]] || Esri World Imagery (Clarity) Beta |||| || |
| | 23 | || [[Image(mapbox.png,link=,28,middle)]] || Mapbox Satellite |||| || |
| | 24 | || [[Image(maxar.png,link=,28,middle)]] || Maxar Premium Imagery (Beta) |||| || |
| | 25 | || [[Image(maxar.png,link=,28,middle)]] || Maxar Standard Imagery (Beta) |||| || |
| | 26 | || [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]] || OpenStreetMap Carto (Standard layer) |||| || |
| | 27 | || [[Image(black_white.png,link=,28,middle)]] || OpenStreetMap (Standard Black & White) |||| || |
| | 28 | |||| |
| | 29 | ||||||||=Here will appear all non global imageries of [wikitr:/Maps#Generalproperties category] [[JOSMImage(data/imagery/photo,link=,28,middle)]] **''photo''**, which are available at the current center position and zoom of the [wikitr:/Help/MapView Mapview] (only if they are not already listed above). This is determined by the bounds of the imagery, which you can see in the [[JOSMImage(preferences/imagery)]] [wikitr:/Help/Preferences/Imagery Imagery preferences]. =|| |
| | 30 | |||| |
| | 31 | ||||||||=Below will appear all non global imageries of the other categories, which are available at the current center position and zoom of the Mapview. If there is more than one imagery of a category they are grouped in a submenu: =|| |
| | 32 | ||= **Icon** =||= **Name** =||||= **Description** =|| |
| | 33 | || [[JOSMImage(data/imagery/elevation,link=,28,middle)]] || Elevation map |||| Map of digital terrain model, digital surface model or contour lines. || |
| | 34 | || [[JOSMImage(data/imagery/map,link=,28,middle)]] || Map |||| A map. || |
| | 35 | || [[JOSMImage(data/imagery/historicmap,link=,28,middle)]] || Historic or otherwise outdated map |||| A historic or otherwise outdated map. || |
| | 36 | || [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]] || Map based on OSM data |||| A map based on OSM data. || |
| | 37 | || [[JOSMImage(data/imagery/historicphoto,link=,28,middle)]] || Historic or otherwise outdated aerial or satellite photo |||| A historic or otherwise outdated aerial or satellite photo. || |
| | 38 | || [[JOSMImage(data/imagery/qa,link=,28,middle)]] || Map for quality assurance |||| A map for quality assurance || |
| | 39 | || [[JOSMImage(data/imagery/other,link=,28,middle)]] || Imagery not matching any other category |||| Any other type of imagery || |
| | 40 | |||| |
| | 41 | ||= **Icon** =||= **Name** =||= **Shortcut** =||= **Description** =|| |
| | 42 | || [[JOSMImage(OLmarker,link=,28,middle)]] || [#UsingaRectifiedImage Rectified Image...] || || Note if you are using these images for editing then you need to ensure the image, and its method of rectification, are free of any copyright issues. |
| | 43 | || || New picture layer from file... || || Allows to add and rectify custom images e.g. a `.jpeg` file (optional from the [osmwiki:JOSM/Plugins/PicLayer PicLayer Plugin]) || |
| | 44 | || || New picture layer from clipboard || || Allows to add and rectify custom images directly from the clipboard (optional from the PicLayer Plugin) || |
| | 45 | || [[Image(mapillary-logo.png,link=,28,middle)]] || Mapillary || `Shift+,` || Adds the mappilary layer. (optional from the [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]) || |
| | 46 | || [[Image(mapillary-logo.png,link=,28,middle)]] || Mapillary object layer || || Adds a layer with map objects detected by mappilary e.g. traffic signs. (optional from the Mapillary plugin) || |
| | 47 | |||| |
| | 48 | || || More... || || If the list becomes too long entries of plugins will appear in this ''More...'' submenu. || |
| 220 | | ==== webkit-image (GTK+) ==== |
| 221 | | It requires GTK+ 2.20+ and WebKitGtk+. Compile and install |
| 222 | | [http://svn.openstreetmap.org/applications/editors/josm/webgrabber/webkit-image-gtk.c webkit-image-gtk.c]. |
| 223 | | |
| 224 | | Libraries required: libgtk2.0-dev libwebkit-dev. |
| 225 | | |
| 226 | | To compile it, run: gcc -W -o webkit-image webkit-image-gtk.c `pkg-config --libs --cflags gtk+-2.0 webkit-1.0` |
| 227 | | |
| 228 | | (note:it builds but fails with "image == null" errors on Mandriva Linux, whereas Qt version works, on Gentoo too) |
| 229 | | |
| 230 | | '''success on the following Operating Systems''' |
| 231 | | |
| 232 | | '''comments:''' |
| 233 | | Ubuntu 10.04: Compiling http://svn.openstreetmap.org/applications/editors/josm/webgrabber/webkit-image-gtk.c a success! Putting the resulting webkit-image(made executable) in the directory /usr/local/bin/ . Doesn't load any yahoo tiles and just says "Exception occured". Once it showed some tiles but they covered tiny rectangles while everything else was "Exception occured". |
| 234 | | |
| 235 | | === Mac OS X === |
| 236 | | |
| 237 | | ==== Prerequisites ==== |
| 238 | | * Install XCode (free download from Apple after regstration, see http://developer.apple.com/mac/) |
| 239 | | * Install Qt SDK (free download from Qt Software, see http://www.qtsoftware.com/downloads/ “LGPL Downloads”, “Download Qt SDK for Mac”) |
| 240 | | |
| 241 | | ==== Installation ==== |
| 242 | | |
| 243 | | Download Intel-only binary from http://www.lassitu.de/osm/webkit-image-r13262-qt-4.5-osx10.5.6.zip (MD5 checksum ecf2e2f044ce259af702247729468be1) |
| 244 | | |
| 245 | | Download PPC-only binary from http://westpol.dnsalias.org/webkit-image-r16071-qt-4.5-osx10.5.7.zip (MD5 checksum 2d00c2dbb1222b0293f7eaeccb1d5e8c) |
| 246 | | |
| 247 | | Or compile from source: |
| 248 | | |
| 249 | | 1. Use svn to check out the grabber from http://svn.openstreetmap.org/applications/editors/josm/webgrabber |
| 250 | | '''$''' svn co http://svn.openstreetmap.org/applications/editors/josm/webgrabber |
| 251 | | 2. In the Makefile, change the LDFLAGS line to read: |
| 252 | | LDFLAGS=-framework QtCore -framework QtGui -framework QtWebKit -framework QtNetwork |
| 253 | | 3. Build the program with make: |
| 254 | | '''$''' make |
| 255 | | if it fails with webkit-image.h:15:2: error: #error "(The moc has changed too much.)" |
| 256 | | update the header files with |
| 257 | | '''$''' moc webkit-image.cpp > webkit-image.h |
| 258 | | 4. Copy the ''webkit-image'' program to a directory that is part of the PATH. If you're not sure which directory to use, try this: |
| 259 | | '''$''' sudo mkdir -p /usr/local/bin |
| 260 | | '''$''' sudo cp webkit-image /usr/local/bin |
| 261 | | |
| 262 | | : Unix programs (and Mac OS X) look for programs to execute in a list of directories. This search list is kept in the PATH environment variable. By default, PATH is set to ''/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:/usr/X11/bin''. To check the current value of the PATH environment variable, use ''echo $PATH''. You can copy the ''webkit-image'' program to any of the directories listed in PATH, and JOSM will automatically find them. |
| 263 | | |
| 264 | | ==== Configuration ==== |
| 265 | | |
| 266 | | Since July 2009, no further configuration is necessary. If you've installed ''webkit-image'' in a directory not in the PATH, you need to modify the path given in the Downloader text box at the botton of the wemplugin preferences page. |
| 267 | | |
| 268 | | === FreeBSD === |
| 269 | | |
| 270 | | If you have JOSM installed from ports collection, then you already got webkit-image (QT) compiled and installed, and Yahoo imagery will work out of the box. |
| 271 | | |
| 272 | | == Source == |
| 273 | | You can get source of the WMS plugin from Subversion: |
| 274 | | |
| 275 | | {{{svn co http://svn.openstreetmap.org/applications/editors/josm/webgrabber/}}} |
| 276 | | |
| 277 | | = Using the WMS plugin = |
| 278 | | |
| 279 | | * Load / Download openstreetmap data and go to your favourite area |
| 280 | | * Show the 'Layers' panel if it isn't showing already (Click the toggle button: [[Image:Liste aller Ebenen.png]]) |
| 281 | | * Click the menu option "WMS → Landsat" (or whatever named WMS server you want to use) This should cause it to create a new imagery layer. |
| 282 | | * Wait a few moments for it to begin fetching image tiles. |
| 283 | | |
| 284 | | As you pan around it will download more tiles. It also seems to remove tiles which are out of viewing area, to free up memory. |
| 285 | | |
| 286 | | To remove the imagery and stop all WMS downloading, select the layer and click the trash can button. You can also temporarily toggle visibility of the layer (keeps imagery in memory). Right click on the layer (in the layers panel) to access further WMS layer options. |
| 287 | | |
| 288 | | When your WMS layer is selected, the data layer is shown as deselected (dark grey). Simply select your data layer again (often called 'unnamed') to restore normal colours. It is also possible to display the WMS layer "above" the data layer, which will hide the data layer completely. Use the up/down arrows to fix the ordering. |
| 289 | | |
| 290 | | You can adjust the positioning of the imagery by clicking [[Image:Adjust WMS-Layer.png]] button on the left. In this mode you can drag and drop the WMS layer. Press the button again to lock it in place. This can be useful if the imagery appears to be offset from reality, but note that your GPS unit isn't perfect. A bad GPS signal can cause an entire trace to have an offset from reality, so you may find it useful to check also by downloading other GPS traces recorded for the area. |
| 291 | | |
| 292 | | You may need to adjust your map colours ('Edit' menu -> 'Preferences') to be darker or lighter, to contrast with the images you are using. |
| 293 | | |
| 294 | | == Basic troubleshooting == |
| 295 | | Things to try in case of problem. |
| 296 | | |
| 297 | | === no image appears, even after waiting a bit === |
| 298 | | * adjust zoom level so that the scale in the top left says ~150m, delete the layer (trash can icon), add it again from the menu. |
| 299 | | * The plugin may not find the DLL files. Check you have placed all of the webkit-image zip file contents them somewhere on the system path. |
| 300 | | |
| 301 | | === images at bad resolution from Yahoo === |
| 302 | | * adjust zoom level as decribed above. Note that in most regions Yahoo imagery has a lesser resolution than Google Maps. |
| 303 | | |
| 304 | | === Exception occurred - red tiles === |
| 305 | | * This can mean the WMS server is temporarily not available. Landsat and OpenAerialMap seem to be prone to periods of non-availability. Delete the WMS layer and try again 10 minutes later. |
| 306 | | |
| 307 | | === error : bad parameters - red tiles === |
| 308 | | * Check that configuration -> projection is set to EPSG:4326 or Mercator. |
| 309 | | |
| 310 | | === gray tiles === |
| 311 | | * if you have non-ACSII symbols in the path to your plugin folder in Windows (e.g. cyrillic letters in ''your name'' in C:\Documents and Settings\''your name''\Application Data\JOSM\plugins), a possible solution is to change ''your name'' to an equivalent short filename. To find this open a command window and do |
| 312 | | dir /x "C:\Documents and Settings" |
| 313 | | In its output the column to the left of ''your name'' should contain short version of ''your name'', let it be for example ''9335~1''. Add a line to the batch file starting JOSM: |
| 314 | | rem Contents of start_JOSM.cmd |
| 315 | | set APPDATA=C:\Documents and Settings\''9335~1''\Application Data |
| 316 | | start javaw -jar josm.jar |
| 344 | | == Adding a WMS Server == |
| 345 | | |
| 346 | | '''Do not use copyrighted material, unless you have the right/permission to do so (see the Licensing section below)!''' |
| 347 | | |
| 348 | | To add a new WMS Server, use the Menu: 'Edit' menu -> 'Preferences' and click on the WMS tab. Now you can add / remove WMS server URL's. |
| 349 | | |
| 350 | | A WMS server typically can provide different projections, subsets of data, etc., so you may need to experiment with the URL settings to get the best results. |
| 351 | | |
| 352 | | == Adding presets for objects and {{tag|source||yahoo_wms}} == |
| 353 | | |
| 354 | | It can be useful to let other users know what your data is based on by adding {{tag|source||yahoo_wms}}. This can be quickly done by creating a JOSM [http://josm.openstreetmap.de/wiki/TaggingPresets tagging preset] for roads, woodland, etc and {{tag|source||yahoo_wms}}. |
| 355 | | |
| 356 | | Once this is setup, it is simple to apply custom combinations of tags to an node, way or area in JOSM: |
| 357 | | |
| 358 | | * Download the [[Image:Yahoo-road.png]] Yahoo road icon. |
| 359 | | * Open your favourite text editor and insert the following: |
| 360 | | <annotations> |
| 361 | | <item name="road-source" icon="[PATH TO ICON]\Yahoo-road.png"> |
| 362 | | <key key="source" value="yahoo_wms" /> |
| 363 | | <key key="highway" value="road" /> |
| 364 | | </item> |
| 365 | | </annotations> |
| 366 | | |
| 367 | | * Save it as yahoo-presets.xml |
| 368 | | * Open JOSM |
| 369 | | * Open the Preferences, go to the Map Settings (3rd tab) |
| 370 | | * Add your file at the "Tagging Preset Sources" |
| 371 | | * Restart JOSM |
| 372 | | * If you want, you can put the preset in your toolbar for quick access (Preferences, Toolbar customization) |
| 373 | | * You might also want presets for things like [[Image:Yahoo-farm.png]] {{tag|landuse||farm}} and/or [[Image:Yahoo-stream.png]] {{tag|waterway||stream}} |
| 374 | | * Download the above icons and add new <item> entries to your yahoo-presets.xml file |
| 375 | | |
| 376 | | == Remote control == |
| 377 | | |
| 378 | | Since version 22677 the WMSPlugin will register an additional remote control command "wms" if the [[{{{RemoteControl:plugin|JOSM/Plugins/RemoteControl}}} | RemoteControl]] plugin version 22675 or newer is loaded. |
| 379 | | |
| 380 | | The "wms" command instructs JOSM to open a WMS layer in the same way as with the "rectified image" menu command. |
| 381 | | |
| 382 | | GET /wms?title=foobar&urldecode=false&url=... |
| 383 | | |
| 384 | | where |
| 385 | | |
| 386 | | {|{{Prettytable}} |
| 387 | | !parameter |
| 388 | | !required/ |
| 389 | | optional |
| 390 | | !meaning |
| 391 | | |- |
| 392 | | |url |
| 393 | | |R |
| 394 | | |WMS URL in the usual format. This must be the last parameter. |
| 395 | | |- |
| 396 | | |title |
| 397 | | |O |
| 398 | | |Title (name) of WMS layer. If not specified the title will be "remote WMS". |
| 399 | | |- |
| 400 | | |urldecode |
| 401 | | |O |
| 402 | | |Disable URL-decoding of URL value if true. All other values will be URL-decoded anyway. |
| 403 | | |- |
| 404 | | |cookies |
| 405 | | |O |
| 406 | | |Can be used to specify cookies for the WMS request. |
| 407 | | |} |
| 408 | | |
| 409 | | Note: The "url" parameter must be the last one. Everything after url= will be used as the WMS URL. It is not mandatory to URL-encode the value, but the WMSPlugin will try to URL-decode it unless urldecode=false is specified. If you notice that the decoding modifies the URL in an unwanted way, add "urldecode=false" before the "url" parameter. |
| 410 | | |
| 411 | | This remote control function can be disabled by setting preferences value |
| 412 | | |
| 413 | | wmsplugin.remotecontrol=false |
| 414 | | |
| 415 | | or by using the checkbox "Allow remote control (reqires remotecontrol plugin)" in the preferences editor. |
| | 115 | == See also == |
| | 116 | * [wikitr:/Help/RemoteControlCommands#imagery RemoteControlCommands] - imagery command |
