| 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. |
| 147 | | |
| 148 | | |
| 149 | | ===== Experimental Debian and Ubuntu Packages ===== |
| 150 | | There are experimental debian and ubuntu packages fro webkit : |
| 151 | | |
| 152 | | you add to your /etc/apt/source.list |
| 153 | | |
| 154 | | deb http://osm.komzpa.net/~mdupont/osm/ gjergi-osm main |
| 155 | | deb-src http://osm.komzpa.net/~mdupont/osm/ gjergi-osm main |
| 156 | | |
| 157 | | and then : |
| 158 | | apt-get install webkitimageqt |
| 159 | | |
| 160 | | see also : https://bugs.launchpad.net/ubuntu/+source/josm/+bug/509061 |
| 161 | | see also : http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=569040 |
| 162 | | |
| 163 | | * '''one person succeeded installing it and making it work with Ubuntu 10.10 (as gnome-web-photo did not work)''' |
| 164 | | * '''one person succeeded installing it and making it work with Ubuntu 10.04''' |
| 165 | | * '''one person succeeded installing it and making it work with Trisquel 4.0''' |
| 166 | | |
| 167 | | ===== On Mandriva 2010.0 ===== |
| 168 | | |
| 169 | | * Prerequisites |
| 170 | | urpmi webkitkde-devel libqt4-devel |
| 171 | | urpmi subversion gcc-c++ |
| 172 | | |
| 173 | | * Get the sources and compile |
| 174 | | svn co http://svn.openstreetmap.org/applications/editors/josm/webgrabber |
| 175 | | cd webgrabber |
| 176 | | make webkit-image |
| 177 | | |
| 178 | | * As root, copy it to somewhere in your path: |
| 179 | | cp webkit-image /usr/local/bin/ |
| 180 | | |
| 181 | | ==== Gentoo webkit-image ebuild ==== |
| 182 | | |
| 183 | | The following code is an ebuild that installs webkit-image (QT) on a Gentoo Linux computer. See [http://linuxreviews.org/gentoo/ebuilds/ this Linux Reviews article] on how to install custom ebuilds. Using the path ''sci-geosciences/webkit-image/webkit-image-9999.ebuild'' to save the ebuild to within your local Portage overlay should work fine. |
| 184 | | |
| 185 | | {{{ |
| 186 | | # Copyright 1999-2010 Gentoo Foundation |
| 187 | | # Distributed under the terms of the GNU General Public License v2 |
| 188 | | # $Header: $ |
| 189 | | |
| 190 | | inherit subversion |
| 191 | | |
| 192 | | DESCRIPTION="JOSM tool to interface with Yahoo! imagery" |
| 193 | | ESVN_REPO_URI="http://svn.openstreetmap.org/applications/editors/josm/webgrabber" |
| 194 | | SRC_URI="" |
| 195 | | |
| 196 | | KEYWORDS="x86" |
| 197 | | LICENSE="GPL-2" |
| 198 | | SLOT="0" |
| 199 | | DEPEND="sci-geosciences/josm |
| 200 | | >=x11-libs/qt-core-4.4.3 |
| 201 | | x11-libs/qt-webkit" |
| 202 | | |
| 203 | | src_compile() { |
| 204 | | cd "${S}" |
| 205 | | make webkit-image || die 'Cannot make webkit-image' |
| 206 | | } |
| 207 | | |
| 208 | | src_install() { |
| 209 | | cd "${S}" |
| 210 | | dodir /usr /usr/bin |
| 211 | | |
| 212 | | into /usr |
| 213 | | |
| 214 | | dobin "${S}/webkit-image" || die 'Cannot install webkit-image' |
| 215 | | |
| 216 | | dodoc README || die 'Cannot install webkit README' |
| 217 | | } |
| 218 | | }}} |
| 219 | | |
| 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/}}} |
