Delete/clear ImageryDownloadTool wiki page?

[Klumbumbus]

Help/Menu/ImageryDownloadTool

The page contains a lot of information but I think it is all heavily outdated. Any opinions how to proceed with this page?

[Don-vip]

I think it can be safely deleted after all the cleanup we did in #13470.

[bastiK]

Last version of the page, for historical interest:

---

In September 2011 Yahoo partially shut down their aerial imagery service and/or replaced their imagery with such from a new source. WE DO NOT HAVE PERMISSION TO USE ANY CURRENT YAHOO IMAGERY'''

Installing Yahoo! aerial imagery downloader

To use Yahoo! aerial imagery you will need to install a tool for interfacing with Yahoo to download tiles.

Windows

webkit-image

On Windows use the ​WebKit based downloader called webkit-image as follows

• ​Download webkit-image.zip
• Unzip it.
• 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).
• Restart JOSM
• Select the Yahoo menu point.

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.

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:

• webkit/webkit-image {0} - loads webkit-image.exe from the subdirectory webkit relative to the JOSM installation directory
• D:/webkit/webkit-image {0} - uses webkit-image D:\webkit\webkit-image.exe

Linux kernel Operating Systems

On Linux you can use different downloaders: gnome-web-photo or webkit-image.

OpenSuSE, SuSE and SLES Distributions

release 11.3 (opensuse)

• gnome-web-photo : this can be installed using yast
• webkit-image : can be built for Qt if you have development tools installed. You will need to use yast to install:
  • libQTWebKit4-devel and friends
  • libqt4-devel and friends
  • pkg-config
  • other more general requirements depending on your build environment

then follow the instructions below for Build from Source

• 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:

   #include <gio-unix-2.0/gio/gunixoutputstream.h>
  

Although the tool should now compile it may not scale tiles correctly within JOSM; use one of the other tools instead

gnome-web-photo for Fedora and Ubuntu

gnome-web-photo is compiled and prepackaged for some distributions, including Fedora and Ubuntu.

Attention: You have to select gnome-web-photo --mode=photo --format=png {0} /dev/stdout at the preferences dialog of the wms plugin.

On Ubuntu 8.10 'Intrepid Ibex'

• Install gnome-web-photo through synaptic (version used 0.3-0ubuntu2)
• 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.

On Ubuntu 9.04 'Jaunty Jackalope'

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.

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.

• ​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
• Download an older version of ​gnome-web-photo from the Ubuntu Mirror.
  • gnome-web-photo_0.3-0ubuntu2_amd64.deb for 64 bit Ubuntu systems.
  • gnome-web-photo_0.3-0ubuntu2_i386.deb for 32 bit Ubuntu systems.
• 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 *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. *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)
  Package: gnome-web-photo
  Pin: version 0.3*
  Pin-Priority: 1001
  • This may introduce dependencies problems, the package requires libxul0d. Run the command sudo apt-get -f install and it should fix any problems.
• 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.

On Ubuntu 9.10 'Karmic Koala'

The gnome-web-photo package in Ubuntu 9.10 does not seem to download any data.
Repeat the steps listed above for 9.04 by installing the old version of the package and it works.

On Ubuntu 10.04 'Lucid Lynx'

• The gnome-web-photo((version used 0.8-0ubuntu2)) package in Ubuntu 10.04 does not seem to download any data.
  • Goto Preferences>WMS>Add and give this address ​http://wms.latlon.org/?layers=yhsat&

On Ubuntu 10.04.1 'Lucid Lynx'

• Install the latest gnome-web-photo((version used 0.8-0ubuntu3)) package from Synaptic (or any other way you like).

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.

Troubleshooting: if you see white stripes

• download ​gnome-web-photo-fixed from OSM SVN repository sudo cp gnome-web-photo-fixed /usr/local/bin sudo chmod a+x /usr/local/bin/gnome-web-photo-fixed
• install package netpbm
• in JOSM -> Settings -> WMS, change "gnome-web-photo" to "gnome-web-photo-fixed" in the selection for download program.

webkit-image (QT)

WebKit has some flavors, the main ones are QT-WebKit and WebKit-GTK+. See below for the GTK+ version.

On Debian unstable/sid

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:

sudo aptitude install webkit-image-qt

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:

sudo aptitude remove webkit-image-gtk

or

sudo update-alternatives --config webkit-image

or

go to the josm preferences, WMS tab and change "webkit-image {0}" to "webkit-image-qt {0}".

Building from Source

• Install the following packages: build-essential libqt4-dev (>= 4.4.3) libqt4-webkit pkg-config
• Download and compile (you may have to replace moc with moc-qt4, or /usr/include/qt4 with /usr/lib/qt4/include): wget ​http://svn.openstreetmap.org/applications/editors/josm/webgrabber/webkit-image.cpp moc webkit-image.cpp > webkit-image.h 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
• instead of the previous step, you can use the packaged Makefile: svn co ​http://svn.openstreetmap.org/applications/editors/josm/webgrabber cd webgrabber make webkit-image
• Copy it to somewhere in your path: sudo cp -v webkit-image /usr/local/bin/

: 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

​http://ftp.debian.org/debian/ testing main contrib non-free

: 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 ...

: 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.

Experimental Debian and Ubuntu Packages

There are experimental debian and ubuntu packages fro webkit :

you add to your /etc/apt/source.list

deb ​http://osm.komzpa.net/~mdupont/osm/ gjergi-osm main
deb-src ​http://osm.komzpa.net/~mdupont/osm/ gjergi-osm main

and then :

apt-get install webkitimageqt

see also : ​https://bugs.launchpad.net/ubuntu/+source/josm/+bug/509061
see also : ​http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=569040

• one person succeeded installing it and making it work with Ubuntu 10.10 (as gnome-web-photo did not work)
• one person succeeded installing it and making it work with Ubuntu 10.04
• one person succeeded installing it and making it work with Trisquel 4.0

On Mandriva 2010.0

• Prerequisites urpmi webkitkde-devel libqt4-devel urpmi subversion gcc-c++

• Get the sources and compile svn co ​http://svn.openstreetmap.org/applications/editors/josm/webgrabber cd webgrabber make webkit-image

• As root, copy it to somewhere in your path: cp webkit-image /usr/local/bin/

Gentoo webkit-image ebuild

The following code is an ebuild that installs webkit-image (QT) on a Gentoo Linux computer. See ​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.

# Copyright 1999-2010 Gentoo Foundation
# Distributed under the terms of the GNU General Public License v2
# $Header: $

inherit subversion

DESCRIPTION="JOSM tool to interface with Yahoo! imagery"
ESVN_REPO_URI="http://svn.openstreetmap.org/applications/editors/josm/webgrabber"
SRC_URI=""

KEYWORDS="x86"
LICENSE="GPL-2"
SLOT="0"
DEPEND="sci-geosciences/josm
	>=x11-libs/qt-core-4.4.3
	x11-libs/qt-webkit"

src_compile() {
	cd "${S}"
	make webkit-image || die 'Cannot make webkit-image'
}

src_install() {
	cd "${S}"
	dodir /usr /usr/bin

	into /usr

	dobin "${S}/webkit-image" || die 'Cannot install webkit-image'

	dodoc README || die 'Cannot install webkit README'
}

webkit-image (GTK+)

It requires GTK+ 2.20+ and WebKitGtk+. Compile and install
​webkit-image-gtk.c.

Libraries required: libgtk2.0-dev libwebkit-dev.

To compile it, run: gcc -W -o webkit-image webkit-image-gtk.c pkg-config --libs --cflags gtk+-2.0 webkit-1.0

(note:it builds but fails with "image == null" errors on Mandriva Linux, whereas Qt version works, on Gentoo too)

success on the following Operating Systems

comments:
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".

Mac OS X

Prerequisites

• Install XCode (free download from Apple after regstration, see ​http://developer.apple.com/mac/)
• Install Qt SDK (free download from Qt Software, see ​http://www.qtsoftware.com/downloads/ “LGPL Downloads”, “Download Qt SDK for Mac”)

Installation

Download Intel-only binary from ​http://www.lassitu.de/osm/webkit-image-r13262-qt-4.5-osx10.5.6.zip (MD5 checksum ecf2e2f044ce259af702247729468be1)

Download PPC-only binary from ​http://westpol.dnsalias.org/webkit-image-r16071-qt-4.5-osx10.5.7.zip (MD5 checksum 2d00c2dbb1222b0293f7eaeccb1d5e8c)

Or compile from source:

1. Use svn to check out the grabber from ​http://svn.openstreetmap.org/applications/editors/josm/webgrabber $ svn co ​http://svn.openstreetmap.org/applications/editors/josm/webgrabber
2. In the Makefile, change the LDFLAGS line to read: LDFLAGS=-framework QtCore -framework QtGui -framework QtWebKit -framework QtNetwork
3. Build the program with make: $ make

if it fails with webkit-image.h:15:2: error: #error "(The moc has changed too much.)"
update the header files with

$ moc webkit-image.cpp > webkit-image.h

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: $ sudo mkdir -p /usr/local/bin $ sudo cp webkit-image /usr/local/bin

: 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.

Configuration

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.

FreeBSD

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.

Source

You can get source of the WMS plugin from Subversion:

svn co http://svn.openstreetmap.org/applications/editors/josm/webgrabber/