Changes between Version 18 and Version 77 of Help/Menu/Imagery


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified

  • Help/Menu/Imagery

    v18 v77  
    1 [[TranslatedPages(outdated=This page is incomplete. The Offset function is not described\, yet.)]]
    2 = Main menu > Imagery =
     1[[TranslatedPages]]
    32
    4 This menu allows you to use various sources as a background layer in the main window.  Clicking on a green imagery menu item will automatically download the image from the server. Servers can be added and edited using the preference tab in the [wiki:/Help/Action/Preferences preferences]. Any new servers or changes would then displayed on the main imagery menu. By default, the major image providers are added.
    5 To use Yahoo! aerial imagery you will need to [wiki:/Help/Menu/ImageryDownloadTool install a tool] for interfacing with Yahoo to download tiles.
     3= Imagery menu =
     4This menu allows you to use various sources as a background layer in the [wikitr:/Help/MapView Mapview] such as aerial imagery, cadastral plans or maps rendered from OpenStreetMap data.
    65
    7 At present, the menu has following sections:
     6[[PageOutline(2-2,Table of contents)]]
    87
    9 == Image source ==
     8== Menu items ==
     9The Imagery menu has the following items:
    1010
    11 [[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||= **Icon** =||= **Name** =||= **Keyboard 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||  [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]]  || OpenStreetMap Carto (Standard layer) ||||  ||
     25||||
     26||||||||=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]. =||
     27||||
     28||||||||=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: =||
     29||= **Icon** =||= **Name** =||||= **Description** =||
     30||  [[JOSMImage(data/imagery/elevation,link=,28,middle)]]  || Elevation map |||| Map of digital terrain model, digital surface model or contour lines. ||
     31||  [[JOSMImage(data/imagery/map,link=,28,middle)]]  || Map |||| A map. ||
     32||  [[JOSMImage(data/imagery/historicmap,link=,28,middle)]]  || Historic or otherwise outdated map |||| A historic or otherwise outdated map. ||
     33||  [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]]  || Map based on OSM data |||| A map based on OSM data. ||
     34||  [[JOSMImage(data/imagery/historicphoto,link=,28,middle)]]  || Historic or otherwise outdated aerial or satellite photo |||| A historic or otherwise outdated aerial or satellite photo. ||
     35||  [[JOSMImage(data/imagery/qa,link=,28,middle)]]  || Map for quality assurance |||| A map for quality assurance ||
     36||  [[JOSMImage(data/imagery/other,link=,28,middle)]]  || Imagery not matching any other category |||| Any other type of imagery ||
     37||||
     38||= **Icon** =||= **Name** =||= **Keyboard Shortcut** =||= **Description** =||
     39||  [[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.
     40||  || 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]) ||
     41||  || New picture layer from clipboard ||  || Allows to add and rectify custom images directly from the clipboard (optional from the  PicLayer Plugin) ||
     42||  [[Image(mapillary-logo.png,link=,28,middle)]]  || Mapillary ||  `Shift+,`  || Adds the mappilary layer. (optional from the [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]) ||
     43||  [[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) ||
     44||||
     45|| || More... || || If the list becomes too long entries of plugins will appear in this ''More...'' submenu. ||
    1246
    13 == Metacarta Rectified Image ==
    14 
    15 [[Image(source:/trunk/images/OLmarker.png)]] For use with Metacarta's [http://labs.metacarta.com/rectifier/ Map Rectifier].
    16 
    17 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,
    18 http://labs.metacarta.com/rectifier/rectify/73 -  the id would be 73)
    19 
    20 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.
    21 
    22 == Blank layer ==
    23 
    24 [[Image(source:/trunk/images/blankmenu.png)]] In certain situations a blank imagery layer is needed (e.g. loading saved layers).
    25 
    26 
    27 = Using the WMS images =
    28 
    29 * Load / Download openstreetmap data and go to your favourite area
    30 * Show the 'Layers' panel if it isn't showing already (Click the toggle button: [[Image:Liste aller Ebenen.png]])
    31 * 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.
    32 * Wait a few moments for it to begin fetching image tiles.
    33 
    34 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.
    35 
    36 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.
    37 
    38 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.
    39 
    40 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.
    41 
    42 You may need to adjust your map colours ('Edit' menu -> 'Preferences') to be darker or lighter, to contrast with the images you are using.
    43 
    44 == Basic troubleshooting ==
     47== WMS basic troubleshooting ==
    4548Things to try in case of problem.
    4649
    47 === no image appears, even after waiting a bit ===
    48 * 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.
    49 * 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.
     50=== No image appears, even after waiting a bit (message No tiles at this zoom level) ===
     51* Adjust zoom level so that the scale in the top left says ~300m.
    5052
    51 === images at bad resolution from Yahoo ===
    52 * adjust zoom level as decribed above. Note that in most regions Yahoo imagery has a lesser resolution than Google Maps.
     53=== Error: Could not load images from tile server ===
     54* The imagery server address can be outdated.
     55* The imagery server address can temporarily be not available.
     56
     57=== Images at bad resolution ===
     58* Check if other aerial imageries are available. Make sure OSM has the permission to trace from it!
    5359
    5460=== Exception occurred - red tiles ===
    55 * 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.
     61* This can mean the imagery 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.
    5662
    57 === error : bad parameters - red tiles ===
    58 * Check that configuration -> projection is set to EPSG:4326 or Mercator.
     63=== Error: bad parameters - red tiles ===
     64* Check that ''Preferences'' -> [wikitr:/Help/Preferences/Map Map Projection] is set to `EPSG:4326` or `Mercator`.
    5965
    6066=== gray tiles ===
    61 * 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
    62  dir /x "C:\Documents and Settings"
    63 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:
     67* 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
     68{{{
     69#!console
     70 dir /x C:\Documents and Settings
     71}}}
     72In 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:
     73{{{
     74#!batch
    6475 rem   Contents of start_JOSM.cmd
    65  set APPDATA=C:\Documents and Settings\''9335~1''\Application Data
     76 set APPDATA=C:\Documents and Settings\9335~1\Application Data
    6677 start javaw -jar josm.jar
     78}}}
    6779
    6880== Caching ==
    69 To reuse the tiles over JOSM sessions without having the reload them from the server, right click on the WMS layer and set a bookmark. During the next session, select the new WMS created by the bookmark in the WMS memu. Additionally, you may want to modify the following values in the preferences :
    70 * cache.wmsplugin.expire -1 : this is a time in second until the tiles are invalidated. -1 means "never flush".
    71 * cache.wmsplugin.maxsize 999999999 : maximal size of the cache (probably in MB)
    72 Even though you have to download an area "manually", you can work offline using this technique.
     81To reuse the tiles over JOSM sessions without having the reload them from the server, right click on the WMS layer and set a bookmark. During the next session, select the new WMS created by the bookmark in the WMS menu. Additionally, you may want to modify the following values in the preferences:
     82* `cache.wmsplugin.expire` to `-1`: this is a time in second until the tiles are invalidated. `-1` means ''never flush''.
     83* `cache.wmsplugin.maxsize` to `999999999`: maximal size of the cache (probably in MB).
     84Even though you have to download an area manually, you can work offline using this technique.
    7385
    74 == Using a "Rectified Image" ==
    75 
    76 '''Do not use copyrighted material, unless you have the right/permission to do so (see the Licensing section below)!'''
     86== Using a Rectified Image ==#UsingaRectifiedImage
     87**Do not use copyrighted material, unless you have the right/permission to do so ! **
     88{{{#!comment
     89(see the Licensing section below)
     90}}}
    7791
    7892Before you start with your own images, it might be a good idea to start with Landsat data so you'll learn how to work with these downloaded images.
    7993
    8094To work with your own images in JOSM:
    81 
    8295* upload your aerial image / scanned old map to either
    83  * Geothings at http://warper.geothings.net/ or
    84  * MetaCarta at http://labs.metacarta.com/rectifier/
    85  * '''Note:''' please read their privacy/copyright notes first
    86 * rectify it on their site so it "fits with reality"
     96 * [https://mapwarper.net/ Map Warper]
     97{{{#!comment
     98 or
     99 * [https://labs.metacarta.com/rectifier/ MetaCarta]]
     100}}}
     101 * **Note**: please read their privacy/copyright notes first
     102* rectify it on their site so it ''fits with reality''
    87103* XXX - wait for the image to be processed?
    88104* remember the metacarta id (look at the URL in your browser)
    89 * in JOSM, load some openstreetmap data of the expected image area (to be in the right "clipping range")
     105* in JOSM, load some openstreetmap data of the expected image area (to be in the right ''clipping range'')
    90106* click on Rectified Image and enter the id in the upcoming dialog
    91107
    92 If the "clipping range" was wrong, you might see just nothing. In this case zoom out and retry the download.
     108If the ''clipping range'' was wrong, you might see just nothing. In this case zoom out and retry the download.
    93109
    94 == Adding a WMS Server ==
    95 
    96 '''Do not use copyrighted material, unless you have the right/permission to do so (see the Licensing section below)!'''
    97 
    98 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.
    99 
    100 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.
    101 
    102 == Remote control ==
    103 
    104 The "wms" remote control command instructs JOSM to open a WMS layer in the same way as with the "rectified image" menu command.
    105 
    106   GET /wms?title=foobar&urldecode=false&url=...
    107 
    108 where
    109 
    110 ||=parameter=||=required/optional=||=meaning=||
    111 ||url||R||WMS URL in the usual format. This must be the last parameter.||
    112 ||title||O||Title (name) of WMS layer. If not specified the title will be "remote WMS".||
    113 ||urldecode||O||Disable URL-decoding of URL value if true. All other values will be URL-decoded anyway.||
    114 ||cookies||O||Can be used to specify cookies for the WMS request.||
    115 
    116 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.
    117 
    118 This remote control function can be disabled by setting preferences value
    119 
    120   wmsplugin.remotecontrol=false
    121 
    122 or by using the checkbox "Allow remote control" in the preferences editor.
     110== See also ==
     111* [wikitr:/Help/RemoteControlCommands#imagery RemoteControlCommands] - imagery command
    123112
    124113----
    125 
    126 Back to [wiki:/Help Main Help]
     114Back to [wikitr:/Help/Dialog/LayerList Layer List Dialog] \\
     115Back to [wikitr:/Help/Menu/ImageryContextMenu Imagery Context Menu] \\
     116Back to [wikitr:/Help/Menu Main menu] \\
     117Back to [wikitr:/Help Main Help]