Changes between Version 68 and Version 69 of Help/Menu/Imagery


Ignore:
Timestamp:
2021-04-10T16:12:17+02:00 (4 years ago)
Author:
skyper
Comment:

Major update and harmonize table layout. Still some work to do.

Legend:

Unmodified
Added
Removed
Modified

  • Help/Menu/Imagery

    v68 v69  
    1 [[TranslatedPages]]
    2 [[PageOutline(2-2,Table of contents)]]
     1[[TranslatedPages(outdated=Icons for default imagery need an update and category icons a reckeck. photo and historicphoto icons are missing due to #20737.)]]
    32
    43= Imagery Menu=
    5 
    64This 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.
    75
     6[[PageOutline(2-2,Table of contents,inline)]]
     7
    88== Menu items ==
     9The Imagery menu has the following items:
    910
    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. ||
     11||= **Icon** =||= **Name** =||= **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(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/getoffset.png,link=,28,middle)]]  || 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,link=,28,middle)]]  || Store Imagery Offset... ||  || Saves for current imagery an offset in the offset database (optional from the 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||  [[Image(bing.png,link=,28,middle)]]  || Bing aerial imagery ||  ||  ||
     20||  [[Image(esri.png,link=,28,middle)]]  || Esri World Imagery ||  ||  ||
     21||  [[Image(esri.png,link=,28,middle)]]  || Esri World Imagery (Clarity) Beta ||  ||  ||
     22||  [[Image(mapbox.png,link=,28,middle)]]  || Mapbox Satellite ||  ||  ||
     23||  [[Image(maxar.png,link=,28,middle)]]  || Maxar Premium Imagery (Beta) ||  ||  ||
     24||  [[Image(maxar.png,link=,28,middle)]]  || Maxar Standard Imagery (Beta) ||  ||  ||
     25||  [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]]  || OpenStreetMap Carto (Standard layer) ||  ||  ||
     26||  [[Image(black_white.png,link=,28,middle)]]  || OpenStreetMap (Standard Black & White) ||  ||  ||
     27||||
     28||||||||=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 [[JOSMImage(preferences/imagery)]] [wikitr:/Help/Preferences/Imagery Imagery preferences]. =||
     29||||
     30||||||||=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: =||
     31||  [[JOSMImage(data/imagery/elevation,link=,28,middle)]]  || Elevation map ||  || Map of digital terrain model, digital surface model or contour lines. ||
     32||  [[JOSMImage(data/imagery/map,link=,28,middle)]]  || Map ||  || A map. ||
     33||  [[JOSMImage(data/imagery/historicmap,link=,28,middle)]]  || Historic or otherwise outdated map ||  || A historic or otherwise outdated map. ||
     34||  [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]]  || Map based on OSM data ||  || A map based on OSM data. ||
     35||  [[JOSMImage(data/imagery/historicphoto,link=,28,middle)]]  || Historic or otherwise outdated aerial or satellite photo ||  || A historic or otherwise outdated aerial or satellite photo. ||
     36||  [[JOSMImage(data/imagery/qa,link=,28,middle)]]  || Map for quality assurance ||  || A map for quality assurance ||
     37||  [[JOSMImage(data/imagery/other,link=,28,middle)]]  || Imagery not matching any other category ||  || Any other type of imagery ||
     38||||
     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||  [[Image(osm:source:/applications/editors/josm/plugins/piclayer/images/layericon24.png,link=,28,middle)]]  || 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||  [[Image(osm:source:/applications/editors/josm/plugins/piclayer/images/layericonclp.png,link=,28,middle)]]  || 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. ||
    4446
    4547{{{#!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.
     48The image [[JOSMImage(data/imagery/photo)]] is temporarily remove from the ''photo'' header table cell because it breaks the page in Help browser, see  [/ticket/17034#comment:16] and #20737.
    4749}}}
     50
     51
    4852== WMS basic troubleshooting ==
    4953Things to try in case of problem.
    … …  
    6064
    6165=== 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.
     66* 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.
    6367
    6468=== Error: bad parameters - red tiles ===
    65 * Check that Preferences -> Map Settings -> Map Projection is set to EPSG:4326 or Mercator.
     69* Check that ''Preferences'' -> [wikitr:/Help/Preferences/Map Map Projection] is set to `EPSG:4326` or `Mercator`.
    6670
    6771=== 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:
     72* 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
     73{{{
     74#!console
     75 dir /x C:\Documents and Settings
     76}}}
     77In 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:
     78{{{
     79#!batch
    7180 rem   Contents of start_JOSM.cmd
    72  set APPDATA=C:\Documents and Settings\''9335~1''\Application Data
     81 set APPDATA=C:\Documents and Settings\9335~1\Application Data
    7382 start javaw -jar josm.jar
     83}}}
     84
    7485
    7586== 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.
     87To 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:
     88* `cache.wmsplugin.expire` to `-1`: this is a time in second until the tiles are invalidated. `-1` means ''never flush''.
     89* `cache.wmsplugin.maxsize` to `999999999`: maximal size of the cache (probably in MB).
     90Even though you have to download an area manually, you can work offline using this technique.
    8091
    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)! '''
     92== Using a Rectified Image ==#UsingaRectifiedImage
     93**Do not use copyrighted material, unless you have the right/permission to do so ! **
     94{{{#!comment
     95(see the Licensing section below)
     96}}}
    8497
    8598Before 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.
    8699
    87100To work with your own images in JOSM:
    88 
    89101* 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"
     102 * [https://mapwarper.net/ Map Warper]
     103{{{#!comment
     104 or
     105 * [https://labs.metacarta.com/rectifier/ MetaCarta]]
     106}}}
     107 * **Note**: please read their privacy/copyright notes first
     108* rectify it on their site so it ''fits with reality''
    94109* XXX - wait for the image to be processed?
    95110* 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")
     111* in JOSM, load some openstreetmap data of the expected image area (to be in the right ''clipping range'')
    97112* click on Rectified Image and enter the id in the upcoming dialog
    98113
    99 If the "clipping range" was wrong, you might see just nothing. In this case zoom out and retry the download.
     114If the ''clipping range'' was wrong, you might see just nothing. In this case zoom out and retry the download.
    100115
    101116== See also ==
    102 
    103117* [wikitr:/Help/RemoteControlCommands#imagery RemoteControlCommands] - imagery command
    104118
    105119----
    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]]
     120Back to [wikitr:/Help/Dialog/LayerList Layer List Dialog] \\
     121Back to [wikitr:/Help/Menu/ImageryContextMenu Imagery Context Menu] \\
     122Back to [wikitr:/Help/Menu Main menu] \\
    109123Back to [wikitr:/Help Main Help]