Changes between Version 68 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

    v68 v77  
    11[[TranslatedPages]]
     2
     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.
     5
    26[[PageOutline(2-2,Table of contents)]]
    37
    4 = Imagery Menu=
     8== Menu items ==
     9The Imagery menu has the following items:
    510
    6 This 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.
     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. ||
    746
    8 == Menu items ==
    9 
    10 The Imagery menu has the following items:
    11 ||= Icon =||= Name =||= Shortcut =||= Description =||
    12 || [[JOSMImage(dialogs/layerlist,24)]] || [wikitr:/Help/Action/ReorderImageryLayers Reorder Imagery Layers] ||  ''various''  || Reorders non-overlay imagery layers. ||
    13 || [[JOSMImage(preference,24)]] || [wikitr:/Help/Preferences/Imagery Imagery preferences...] ||  || Opens the respective tab in the preferences. Imagery servers can be added and edited there. ||
    14 || [[Image(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/getoffset.png,24)]] || Get Imagery Offset... ||  {{{Ctrl+Alt+I}}}  || Download offsets for current Imagerie (optional from the [osmwiki:Imagery_Offset_Database Imagery Offset Database Plugin]) ||
    15 || [[Image(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/storeoffset.png,24)]] || Store Imagery Offset... ||  || Saves for current imagery an offset in the offset database (optional from the Imagery Offset Database Plugin) ||
    16 || [[JOSMImage(mapmode/adjustimg,24)]] || [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 [wikitr:/Help/Preferences/Imagery Imagery preferences]. The following six entries are already activated from the beginning. Clicking on one of the entries will add the imagery to the [wikitr:/Help/Dialog/LayerList Layer list]. Adding an imagery is also illustrated in the [wikitr:/Introduction#EnableAerialimagery introduction]. ||
    19 || [[Image(bing.png,24)]] || Bing aerial imagery ||  ||  ||
    20 || [[Image(esri.png,24)]] || Esri World Imagery ||  ||  ||
    21 || [[Image(esri.png,24)]] || Esri World Imagery (Clarity) Beta ||  ||  ||
    22 || [[Image(mapbox.png,24)]] || Mapbox Satellite ||  ||  ||
    23 || [[Image(black_white.png,24)]] || OpenStreetMap (Standard Black & White) ||  ||  ||
    24 || [[Image(carto.png,24)]] || OpenStreetMap Carto (Standard layer) ||  ||  ||
    25 ||||||||||
    26 |||||||| Here will appear all non global imageries of [wikitr:/Maps#Generalproperties category] "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 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 || [[JOSMImage(data/imagery/elevation,24)]] || Elevation map ||  || Map of digital terrain model, digital surface model or contour lines. ||
    30 || [[JOSMImage(data/imagery/map,24)]] || Map ||  || A map. ||
    31 || [[JOSMImage(data/imagery/historicmap,24)]] || Historic or otherwise outdated map ||  || A historic or otherwise outdated map. ||
    32 || [[JOSMImage(data/imagery/osmbasedmap,24)]] || Map based on OSM data ||  || A map based on OSM data. ||
    33 || [[JOSMImage(data/imagery/historicphoto,24)]] || Historic or otherwise outdated aerial or satellite photo ||  || A historic or otherwise outdated aerial or satellite photo. ||
    34 || [[JOSMImage(data/imagery/qa,24)]] || Map for quality assurance ||  || A map for quality assurance ||
    35 || [[JOSMImage(data/imagery/other,24)]] || Imagery not matching any other category ||  || Any other type of imagery ||
    36 ||||||||||
    37 || [[JOSMImage(OLmarker)]] || [#UsingaRectifiedImage Rectified Image...] ||  || For use with Metacarta's [http://labs.metacarta.com/rectifier/ Map Rectifier]. Clicking on this opens up a dialog box requesting an id. The id is obtained from either the page url or the WMS link (e.g. {{{http://labs.metacarta.com/rectifier/rectify/73}}} the id would be 73). 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. ||
    38 || [[Image(osm:source:/applications/editors/josm/plugins/piclayer/images/layericon24.png)]] || 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]) ||
    39 || [[Image(osm:source:/applications/editors/josm/plugins/piclayer/images/layericonclp.png)]] || New picture layer from clipboard ||  || Allows to add and rectify custom images directly from the clipboard (optional from the  PicLayer Plugin) ||
    40 || [[Image(mapillary-logo.png,24)]] || Mapillary ||  {{{Shift+,}}}  || Adds the mappilary layer. (optional from the [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]) ||
    41 || [[Image(mapillary-logo.png,24)]] || Mapillary object layer || || Adds a layer with map objects detected by mappilary e.g. traffic signs. (optional from the Mapillary plugin) ||
    42 ||||||||||
    43 || || More... || || If the list becomes too long entries of plugins will appear in this "More..." submenu. ||
    44 
    45 {{{#!comment
    46 The image [[JOSMImage(data/imagery/photo,middle,20)]] is temporarily remove from the "photo" header table cell beacuse it breaks the page in Help browser, see notice in #17034.
    47 }}}
    4847== WMS basic troubleshooting ==
    4948Things to try in case of problem.
    … …  
    6059
    6160=== Exception occurred - red tiles ===
    62 * 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.
     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.
    6362
    6463=== Error: bad parameters - red tiles ===
    65 * Check that Preferences -> Map Settings -> Map Projection is set to EPSG:4326 or Mercator.
     64* Check that ''Preferences'' -> [wikitr:/Help/Preferences/Map Map Projection] is set to `EPSG:4326` or `Mercator`.
    6665
    6766=== gray tiles ===
    68 * 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
    69  dir /x "C:\Documents and Settings"
    70 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
    7175 rem   Contents of start_JOSM.cmd
    72  set APPDATA=C:\Documents and Settings\''9335~1''\Application Data
     76 set APPDATA=C:\Documents and Settings\9335~1\Application Data
    7377 start javaw -jar josm.jar
     78}}}
    7479
    7580== Caching ==
    76 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 menu. Additionally, you may want to modify the following values in the preferences :
    77 * cache.wmsplugin.expire -1 : this is a time in second until the tiles are invalidated. -1 means "never flush".
    78 * cache.wmsplugin.maxsize 999999999 : maximal size of the cache (probably in MB)
    79 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.
    8085
    81 == Using a "Rectified Image" ==#UsingaRectifiedImage
    82 
    83 '''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}}}
    8491
    8592Before 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.
    8693
    8794To work with your own images in JOSM:
    88 
    8995* upload your aerial image / scanned old map to either
    90  * Map Warper at https://mapwarper.net/ or
    91  * MetaCarta at https://labs.metacarta.com/rectifier/
    92  * '''Note:''' please read their privacy/copyright notes first
    93 * 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''
    94103* XXX - wait for the image to be processed?
    95104* remember the metacarta id (look at the URL in your browser)
    96 * 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'')
    97106* click on Rectified Image and enter the id in the upcoming dialog
    98107
    99 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.
    100109
    101110== See also ==
    102 
    103111* [wikitr:/Help/RemoteControlCommands#imagery RemoteControlCommands] - imagery command
    104112
    105113----
    106 Back to [wikitr:/Help/Menu Main menu][[BR]]
    107 Back to [wikitr:/Help/Dialog/LayerList Layer List Dialog][[BR]]
    108 Back to [wikitr:/Help/Menu/ImageryContextMenu Imagery Context Menu][[BR]]
     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] \\
    109117Back to [wikitr:/Help Main Help]