Changes between Version 47 and Version 72 of Help/Menu/Imagery


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Menu/Imagery

    v47 v72  
    11[[TranslatedPages]]
    2 = Main menu > Imagery =
    3 [[PageOutline(2-10,Table of contents)]]
    42
    5 This menu allows you to use various sources as a background layer in the [[MapView]] such as aerial imagery, cadastral plans or Maps rendered from OpenStreetMap data.
     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 == Menu entries ==
     6[[PageOutline(2-2,Table of contents,inline)]]
    87
    9 The Imagery menu has following entries:
    10 ||= Icon =||= Name =||= Shortcut =||= Description =||
    11 || [[Image(source:/trunk/images/preference.png,24)]] || [wiki:Help/Preferences/Imagery Imagery preferences] ||  || Opens the respective tab in the preferences. Imagery servers can be added and edited there. ||
    12 || [[Image(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/getoffset.png,24)]] || Get Imagery Offset... ||  || Opens a window, where you can download offsets of Imageries (optional from the [[Image(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/iodb.png,24)]] [osmwiki:Imagery_Offset_Database Imagery Offset Database Plugin]) ||
    13 || [[Image(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/storeoffset.png,24)]] || Store Imagery Offset... ||  || Saves an offset in the offset database (optional from the [[Image(osm:source:/applications/editors/josm/plugins/imagery_offset_db/images/iodb.png,24)]] Imagery Offset Database Plugin) ||
    14 || [[Image(https://raw.githubusercontent.com/mapillary/josm-mapillary-plugin/master/images/icon24.png,24)]] || Mapillary || {{{Shift+,}}} || Adds the mappilary layer. (optional from the [[Image(https://raw.githubusercontent.com/mapillary/josm-mapillary-plugin/master/images/icon24.png,24)]] [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]) ||
    15 || [[Image(source:/trunk/images/mapmode/adjustimg.png,24)]] || [wiki:Help/Action/ImageryAdjust New offset] ||  || Opens a window to adjust the offset of an Imagery. ||
    16 ||||||||||
    17 |||||||| Here will appear all Imageries, which are activated in the [wiki:Help/Preferences/Imagery Imagery preferences]. The following 7 entries are already activated from the beginning. Clicking on one of the entries will add the imagery to the [wiki:Help/Dialog/LayerList Layer list]. Adding an imagery is also illustrated at [wiki:Introduction#EnableAerialimagery]. ||
    18 || [[Image(bing.png,24)]] || Bing aerial imagery ||  ||  ||
    19 || [[Image(DigitalGlobe.png,24)]] || DigitalGlobe Premium Imagery ||  ||  ||
    20 || [[Image(DigitalGlobe.png,24)]] || DigitalGlobe Standard Imagery ||  ||  ||
    21 || [[Image(esri.png,24)]] || Esri World Imagery ||  ||  ||
    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, which are available at the current center position and zoom of the [[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 || [[Image(source:/trunk/images/OLmarker.png)]] || [#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. ||
     8== Menu items ==
     9The Imagery menu has the following items:
     10
     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||= **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||  [[Image(maxar.png,link=,28,middle)]]  || Maxar Premium Imagery (Beta) ||||  ||
     25||  [[Image(maxar.png,link=,28,middle)]]  || Maxar Standard Imagery (Beta) ||||  ||
     26||  [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]]  || OpenStreetMap Carto (Standard layer) ||||  ||
     27||  [[Image(black_white.png,link=,28,middle)]]  || OpenStreetMap (Standard Black & White) ||||  ||
     28||||
     29||||||||=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]. =||
     30||||
     31||||||||=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: =||
     32||= **Icon** =||= **Name** =||||= **Description** =||
     33||  [[JOSMImage(data/imagery/elevation,link=,28,middle)]]  || Elevation map |||| Map of digital terrain model, digital surface model or contour lines. ||
     34||  [[JOSMImage(data/imagery/map,link=,28,middle)]]  || Map |||| A map. ||
     35||  [[JOSMImage(data/imagery/historicmap,link=,28,middle)]]  || Historic or otherwise outdated map |||| A historic or otherwise outdated map. ||
     36||  [[JOSMImage(data/imagery/osmbasedmap,link=,28,middle)]]  || Map based on OSM data |||| A map based on OSM data. ||
     37||  [[JOSMImage(data/imagery/historicphoto,link=,28,middle)]]  || Historic or otherwise outdated aerial or satellite photo |||| A historic or otherwise outdated aerial or satellite photo. ||
     38||  [[JOSMImage(data/imagery/qa,link=,28,middle)]]  || Map for quality assurance |||| A map for quality assurance ||
     39||  [[JOSMImage(data/imagery/other,link=,28,middle)]]  || Imagery not matching any other category |||| Any other type of imagery ||
     40||||
     41||= **Icon** =||= **Name** =||= **Shortcut** =||= **Description** =||
     42||  [[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.
     43||  [[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]) ||
     44||  [[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) ||
     45||  [[Image(mapillary-logo.png,link=,28,middle)]]  || Mapillary ||  `Shift+,`  || Adds the mappilary layer. (optional from the [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]) ||
     46||  [[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) ||
     47||||
     48|| || More... || || If the list becomes too long entries of plugins will appear in this ''More...'' submenu. ||
    2949
    3050
     
    3656
    3757=== Error: Could not load images from tile server ===
    38 * The Imagery server address can be outdated.
    39 * The Imagery server address can temporarily be not available.
     58* The imagery server address can be outdated.
     59* The imagery server address can temporarily be not available.
    4060
    4161=== Images at bad resolution ===
     
    4363
    4464=== Exception occurred - red tiles ===
    45 * 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.
     65* 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.
    4666
    4767=== Error: bad parameters - red tiles ===
    48 * Check that configuration -> projection is set to EPSG:4326 or Mercator.
     68* Check that ''Preferences'' -> [wikitr:/Help/Preferences/Map Map Projection] is set to `EPSG:4326` or `Mercator`.
    4969
    5070=== gray tiles ===
    51 * 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
    52  dir /x "C:\Documents and Settings"
    53 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:
     71* 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
     72{{{
     73#!console
     74 dir /x C:\Documents and Settings
     75}}}
     76In 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:
     77{{{
     78#!batch
    5479 rem   Contents of start_JOSM.cmd
    55  set APPDATA=C:\Documents and Settings\''9335~1''\Application Data
     80 set APPDATA=C:\Documents and Settings\9335~1\Application Data
    5681 start javaw -jar josm.jar
     82}}}
     83
    5784
    5885== Caching ==
    59 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 :
    60 * cache.wmsplugin.expire -1 : this is a time in second until the tiles are invalidated. -1 means "never flush".
    61 * cache.wmsplugin.maxsize 999999999 : maximal size of the cache (probably in MB)
    62 Even though you have to download an area "manually", you can work offline using this technique.
     86To 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:
     87* `cache.wmsplugin.expire` to `-1`: this is a time in second until the tiles are invalidated. `-1` means ''never flush''.
     88* `cache.wmsplugin.maxsize` to `999999999`: maximal size of the cache (probably in MB).
     89Even though you have to download an area manually, you can work offline using this technique.
    6390
    64 == Using a "Rectified Image" ==
    65 
    66 '''Do not use copyrighted material, unless you have the right/permission to do so (see the Licensing section below)! '''
     91== Using a Rectified Image ==#UsingaRectifiedImage
     92**Do not use copyrighted material, unless you have the right/permission to do so ! **
     93{{{#!comment
     94(see the Licensing section below)
     95}}}
    6796
    6897Before 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.
    6998
    7099To work with your own images in JOSM:
    71 
    72100* upload your aerial image / scanned old map to either
    73  * Map Warper at http://mapwarper.net/ or
    74  * MetaCarta at http://labs.metacarta.com/rectifier/
    75  * '''Note:''' please read their privacy/copyright notes first
    76 * rectify it on their site so it "fits with reality"
     101 * [https://mapwarper.net/ Map Warper]
     102{{{#!comment
     103 or
     104 * [https://labs.metacarta.com/rectifier/ MetaCarta]]
     105}}}
     106 * **Note**: please read their privacy/copyright notes first
     107* rectify it on their site so it ''fits with reality''
    77108* XXX - wait for the image to be processed?
    78109* remember the metacarta id (look at the URL in your browser)
    79 * in JOSM, load some openstreetmap data of the expected image area (to be in the right "clipping range")
     110* in JOSM, load some openstreetmap data of the expected image area (to be in the right ''clipping range'')
    80111* click on Rectified Image and enter the id in the upcoming dialog
    81112
    82 If the "clipping range" was wrong, you might see just nothing. In this case zoom out and retry the download.
     113If the ''clipping range'' was wrong, you might see just nothing. In this case zoom out and retry the download.
    83114
    84115== See also ==
    85 
    86 * [[Help/RemoteControlCommands#imagery]] - {{{imagery}}} command
     116* [wikitr:/Help/RemoteControlCommands#imagery RemoteControlCommands] - imagery command
    87117
    88118----
    89 Back to [wiki:/Help/Menu Main menu][[BR]]
    90 Back to [wiki:/Help/Dialog/LayerList Layer List Dialog][[BR]]
    91 Back to [wiki:/Help/Menu/ImageryContextMenu Imagery Context Menu][[BR]]
    92 Back to [wiki:/Help Main Help]
     119Back to [wikitr:/Help/Dialog/LayerList Layer List Dialog] \\
     120Back to [wikitr:/Help/Menu/ImageryContextMenu Imagery Context Menu] \\
     121Back to [wikitr:/Help/Menu Main menu] \\
     122Back to [wikitr:/Help Main Help]