source: osm/applications/editors/josm/wmsadapter/orthofotos-bern/README.txt@ 24504

Last change on this file since 24504 was 18836, checked in by guggis, 15 years ago

Improved README

File size: 3.4 KB
Line 
1----------------------------------------------------------------------------
2 WMS Adapter for Orthofotos of Bern
3----------------------------------------------------------------------------
4
5
6This adapter translates JOSMs tile requests for orthofotos of Bern to tile
7requests which can be handled by the WMS server of Bern.
8
9The adapter is a small web application which runs on your local computer.
10
11
12 +--------+ +-------------+ +-----------+
13 | JOSM | tile request | WMS Adapter | tile req | City Map |
14 | | ---------------> | for | -----------> | of Bern |
15 | | tile | Orthofotos | tile | |
16 | | <------------- | of Bern | <---------- | |
17 +--------+ +-------------+ +-----------+
18
19The adapter is responsible
20o for maintaining a valid session with the WMS server of Bern
21o translating lat/lon-coordinates in WGS84 to x/y-coordinates of CH1903
22
23Limitations:
24o although I tried to mimic the behaviour of a standard browser like Firefox as
25 closely as possible I wasn't able to automatically retrieve a valid session
26 ID from the WMS server of Bern. They timed out immediately.
27
28 You therefore have to configure the WMS adapter with a valid session ID which
29 you have to retrieve from the WMS server of Bern using your preferred web
30 browser (see below in section Usage).
31
32
33INSTALLATION
34------------
35
36o Download the latest orthofoto-bern-wms-adapter-<version>.zip from
37 http://www.guggis.ch/orthofoto-bern-wms-adapter/
38
39o Unzip orthofoto-bern-wms-adapter-<version>.zip
40
41
42CONFIGURING JOSM
43----------------
44o Add the WMS adapter as WMS server
45 - press F12 to launch the configuration dialog
46 - select the configuration screen for WMS server
47 - add an entry with
48 menu name = Orthofotos Bern
49 WMS-URL = http://localhost:<port>/orthofotos-bern? !!! Note the trailing '?' !!!
50 (replace <port> with the port number is listing on, see below)
51
52USAGE
53------------
54o Start the WMS adapter
55
56 c:\> java -jar winstone-0.9.10.jar --warfile=orthofoto-bern-wms-adapter.war
57
58 Use --httpPort=<port> to set another port the adapter is listening on.
59
60 Example for port 8787:
61 c:\> java -jar winstone-0.9.10.jar --warfile=orthofoto-bern-wms-adapter.war --httpPort=8787
62
63o The port number
64 The adapter runs on your computer and listens to requests on a specific port.
65 The default port is 8080.
66 If you use the commmand line option --httpPort=<port>, then the port number is
67 the number you entered instead of <port>.
68
69o Get a valid session ID
70
71 - Launch your browser and point it at
72 http://www.stadtplan.bern.ch/TBInternet/default.aspx?User=1
73
74 - View the current set of cookies in your browser and copy the cookie
75 for domain stadtplan.bern.ch
76 with name ASP.NET_SessionId
77 to the clipboard
78
79o Configure WMS adapter with the session ID
80 - Point your browser at
81 http://localhost:<port-number>/orthofotos-bern
82 for instance
83 http://localhost:8080/orthofotos-bern
84 - Enter the Session ID retrieved in the previous step and click on "Submit"
85
86o Use JOSM
87 - You may now use JOSM to retrieve orthofotos of Bern
88
89
Note: See TracBrowser for help on using the repository browser.