Changes between Version 43 and Version 103 of Help/Action/Download


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Action/Download

    v43 v103  
    11[[TranslatedPages]]
    22
    3 = File > Download from OSM =
     3= File > Download data =
    44
    5 [[Image(source:trunk/images/download.png)]] ''Keyboard shortcut:'' **{{{Ctrl+Shift+↓}}}**
     5[[JOSMImage(download,48,link=,middle,margin-right=20)]] ''Keyboard shortcut:'' **`Ctrl+Shift+↓`**
    66
    7 **Download data from server.**
     7**Download map data from a server of your choice.**
    88
    9 [[PageOutline(2-3,,inline)]]
     9[[PageOutline(2-10,Table of Content)]]
     10
     11Downloading data with the Download window in JOSM follows these 3 simple steps:
     121. Choose a source server and optional adjust the download options the server offers
     131. Choose an area to download
     141. Click on [[JOSMImage(download)]] Download
    1015
    1116
    12 == Type of Data ==
    13 Different type of data can be downloaded:
     17== Source server and server download options ==
     18By default there is only one source, the main OSM server. If [wikitr:/Help/ExpertMode expert mode] is enabled then you have access to other servers too. Each server has its own special download options, which are explained below.
    1419
    15 * osm data (nodes, ways, relations ...), downloaded from the OpenStreetMap server.
     20=== Download from OSM ===#Downloadfromosm
     21[[Image(SlippyMap.png,link=)]]
    1622
    17 * gps raw data, downloaded from the OpenStreetMap server.
     23This is the default download method. Different types of data can be downloaded (it is possible to download all three types at once):
    1824
    19 The type is chosen with the check boxes at the top of the window. (It is possible to download both types at once).
     25* [osmwiki:Downloading_data OpenStreetMap data] ([osmwiki:Elements nodes, ways, relations])
     26* [osmwiki:Upload Raw GPS data] (traces)
     27* [wikitr:/Help/Dialog/Notes Notes]
    2028
    21 [[Image(download_dialog.png)]]
     29There might be a red warning below the data type check boxes displayed if the selected area is probably too large for the server and will be answered with an error message. \\
     30You can download bigger areas using several smaller ones or try another source server.
     31
     32=== Download from Overpass API ([wikitr:/Help/ExpertMode expert mode]) ===#DownloadfromOverpassAPI
     33[[Image(Overpass.png,link=)]]
     34
     35The big advantage of ''Download from Overpass API'' compared to ''Download from OSM'' is that you can limit the download to specific objects, rather than "all objects in an area". If you use this download method make sure you know what you are doing, as working with incomplete data sets can lead to relation issues, incorrect or duplicate data, or server conflicts at upload time. [osmwiki:Overpass_API/Sparse_Editing Sparse Editing] explains potential issues.
     36
     37Overpass API offers download of OpenStreetMap data elements only (i.e. no gps traces or notes).
     38
     39To use ''Download from Overpass API'' put your Overpass query in the big text box. See [osmwiki:Overpass_API/Overpass_QL Overpass QL] for its syntax. [osmwiki:Overpass_turbo/Extended_Overpass_Turbo_Queries Extended Overpass Turbo Queries] are allowed. You can add, edit and delete your favorite queries in the list on the right side. Successful executed queries will automatically be added to the list with "history" and the time and date as name of this query. Type text in the small textbox above the list to filter the list.
     40
     41If `{{geocodeArea}}` is part of the query, it will be evaluated. If `{{bbox}}` is part of the query, then you need to choose the area to download (see below). If none of them is present, then it will search and download global. If the query box is left blank you can download all the data in the below specified area to download.
     42
     43JOSM silently autofixes some errors of the query (e.g. replaces `out:json` with `out:xml` or replaces `out:body` with `out:meta`), similar to the autofix function of the overpass turbo website.
     44
     45The Query Wizard that uses JOSM [wikitr:/Help/Action/Search search] syntax helps you to create an Overpass Turbo query.
     46
     47In the favorite editing window the first box contains the name and the box below the query.
     48
     49[[Image(Favorite.png,250,link=)]]
     50
     51=== Download from Sophox API ([wikitr:/Help/ExpertMode expert mode]) ===#DownloadfromSophoxAPI
     52[[Image(Sophox.png,link=)]]
     53
     54Similar to Download from Overpass API this download method uses special queries to limit the downloaded data. It has the same features to store your favorite queries.
     55
     56The usage of the Download from Sophox API is explained in the [osmwiki:Wikidata%2BOSM_SPARQL_query_service osm wiki]. To use this download method you need to install the [wikitr:/Help/Plugin/Wikipedia Wikipedia Plugin].
     57
     58=== Download from MapWithAI API ===
     59This requires the plugin [wikitr:/Help/Plugin/MapWithAI MapWithAI].
    2260
    2361
    2462== Area to download ==
    25 The dialog has multiple tabs. The exact configuration of tabs may be dependent on plugins you have installed, but you will generally at least have the following five.
     63Additional to the server choose you need to select in which area ("bounding box", "bbox") you want to download the data (except for special Overpass or Sophox queries). The area to download can be chosen in different tabs.
    2664
    27 When switching between tabs, the area shown in each tab will be the same. So if you select a bookmark for example and switch to the slippy map tab, the area of that bookmark is shown.
     65The Slippy map tab is the most intuitive one as you can simply draw a bbox rectangle with your mouse on the map. If you change the bbox in another tab and go back to the Slippy map it will display the new bbox, so you can adjust it before downloading. When the download dialog is called up with data already loaded, the bbox of the downloaded window will be the same like your current [wikitr:/Help/MapView map view].
    2866
    29 **Note**: When the download dialog is called up with data already loaded, all fields are set to the currently visible bounding box. Thus a common use scenario is to first load your GPS track from a GPX file, then zoom the view so that the portion you wish to work on is fully visible, and then call up the download dialog which will reflect the visible area.
     67=== Slippy map ===#Slippymap
     68[[Image(SlippyMap.png,400,link=)]]
    3069
    31 === Slippy map ===
    32 Slippy map provides a movable map like on the OSM front page with which you can interactively select the area to download. Only differences are that {{{Shift+Click}}} to zoom is not available, move the map the JOSM way by press and hold the right mouse button and select an area by press and hold the left mouse button.
     70The ''Slippy map'' provides a movable map like on the OSM front page with which you can interactively select the area to download. Move the map the JOSM way by press and hold the right mouse button and select an area by press and hold the left mouse button.
     71
     72Clicking on the [[JOSMImage(dialogs/layerlist)]] button on the upper right gives you the option to change the displayed map for this window. The available maps are based on your [wikitr:/Help/Preferences/Imagery Imagery preferences].
    3373
    3474=== Bookmarks ===
    35 A Bookmarks tab where you can select from your predefined bookmarks, or create a new bookmark from the current bounding box or the area defined in another tab respectively.
     75[[Image(Bookmarks.png,400)]]
     76
     77In the ''Bookmarks'' tab you can select from your predefined bookmarks, or create a new bookmark from the current bounding box (bbox) or the area defined in another tab respectively.
     78
     79There are special bookmarks, which can't be modified directly:
     80* The Home location bookmark represents the home location, which you have set in your osm profile on osm.org.
     81* With the [[JOSMImage(dialogs/changeset/downloadchangeset)]] button on the left you can download the bboxes of you last 15 changesets, which are added as bookmarks then.
     82
     83Double click on a bookmark to directly download the related bbox or single click on a bookmark, switch to the Slippy map tab and adjust the bbox before downloading.
    3684
    3785=== Bounding Box ===
    38 A Bounding Box tab where you can set the latitude/longitude bounds of the data to be downloaded, and also paste an URL from either www.openstreetmap.org or www.informationfreeway.org.
    39 * To paste from [http://www.openstreetmap.org/index.html the map] on the OpenStreetMap site, zoom in to the area you are interested in, then either move the mouse over the "view" tab, and copy the resulting URL, or copy the permalink given in the bottom right corner. Then go to JOSM, and paste this URL into the "URL from www.openstreetmap.org" box. (In Windows to paste into the box, left click within the box, and then do CTRL+v).
    40 * To paste from [http://www.informationfreeway.org www.informationfreeway.org] zoom to the area you are interested in, and then copy the permalink location from the bottom right of screen, and paste as described above.
     86[[Image(BBox.png,400,link=)]]
     87
     88In the ''Bounding Box'' tab you can set the latitude/longitude bounds of the data to be downloaded, and also paste an URL from either www.openstreetmap.org or www.informationfreeway.org.
     89* To paste from [osmwww: the map] on the OpenStreetMap site, zoom into the area you are interested in and copy the URL from the address bar of your browser. Then go to JOSM, and paste this URL into the "URL from www.openstreetmap.org" box. (In Windows to paste into the box, left click on the box, and then do `Ctrl+V`).
     90* To paste from [https://www.informationfreeway.org www.informationfreeway.org] zoom to the area you are interested in, and then copy the permalink location from the bottom right of the screen, and paste as described above.
     91
     92Instead of pasting the URL in the text box, you can press `Ctrl+V` on any other tab to parse the bounds from the clipboard URL.
     93
     94You can copy bounds to clipboard with the ''Copy bound'' button
    4195
    4296=== Area around places ===
    43 On the ''Area around places'' tab you can find the functionality of the former namefinder plugin. Here you can search for specific places, street names, etc, in the OSM database. Currently there are two different servers for the search you can choose from:
    44 * **[https://wiki.openstreetmap.org/wiki/Nominatim Nominatim]**
    45 * (**[https://wiki.openstreetmap.org/index.php/Name_finder Namefinder]**: outdated, was used by the namefinder plugin.) **service has been retired and shutdown.
     97[[Image(AreaAroundPlaces.png,400,link=)]]
     98
     99On the ''Area around places'' tab you can search for specific places, street names, etc, in the OSM database. Currently, there is only one server for the search available: [osmwiki:Nominatim Nominatim]. If there are more than 10 results, only 10 results are displayed and the button changes to "Search more...". \\
     100After you have clicked on a search result you can switch back to the Slippy map tab (which has zoomed to the area of the search result) and adjust the bounding box.
    46101
    47102=== Tile Numbers ===
    48 A Tile Numbers tab where you can enter number of tiles and a zoom level to download data of those tiles. Alternatively you enter a Tile address. This might look a little awkward especially when reading [http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames how to compute the tile numbers]. But sometimes it comes in handy. Have a look at the [http://server.tah.openstreetmap.org/Browse/?layer=tile t@h browser] where you can quite easily determine the tile numbers in the image address when hovering the individual tiles with the mouse.
     103[[Image(TileNumbers.png,400,link=)]]
     104
     105In the ''Tile Numbers'' tab you can enter a number of tiles and a zoom level to download data of those tiles. Alternatively, you enter a Tile address. This might look a little awkward, especially when reading [osmwiki:Slippy_map_tilenames how to compute the tile numbers]. But sometimes it comes in handy. If you want to easily determine the tile numbers with the mouse, see [https://help.openstreetmap.org/questions/40163/tile-browser-link-broken this help center question].
    49106
    50107
    51 == Area too large ==
    52 To smaller the risk of a server overload the amount of data to download at once is limited.[[BR]]
    53 There will be a red warning at the bottom left displayed if the selected area is too large for the server and will likely be answered with an error message. (You can try, though!)[[BR]]
    54 Otherwise choose a smaller area. You can download bigger areas using several smaller ones.
     108== JOSM download options ==
     109JOSM offers some general options of this download window:
     110 Open this dialog on startup::
     111  If checked this window will automatically be opened after the start of JOSM.
     112 Zoom to downloaded data::
     113  If checked the map view will move to the downloaded data after downloading, if not checked it will stay at its current position. (If [wikitr:/Help/ExpertMode expert mode] is off this checkbox is not displayed.)
    55114
    56 
    57 == Layer control ==
    58 You can control whether the data is loaded into the current or in a new layer with the check box in the bottom left corner of the window:
    59 * if **Separate Layer** is selected, the data is loaded in a new layer
    60 * if **Separate Layer** is not selected, the data is loaded in the current data layer
    61 
    62 If there isn't any data layer yet, a new data layer is always created.
    63 
    64 
    65 == Display ==
    66 Clicking on the white plus on blue background on the upper right gives you the option to change the display (rendering machine). Currently there exist seven different renderers:
    67 
    68 * Mapnik (default)
    69 * Osmarender
    70 * Cyclemap
    71 * Bing Aerial Maps
    72 * MapQuest Open Aerial
    73 * OpenStreetMap (Mapnik black/white)
    74 * OpenStreetMap (Mapnik)
    75 
    76 
    77 == Mirror Download Plugin ==
    78 * The XAPI query syntax is explained in the [https://wiki.openstreetmap.org/wiki/Overpass_API/XAPI_Compatibility_Layer OSM wiki].
     115By default the "Download" button should be used. If you want to download data to a separate [wikitr:/Help/Dialog/LayerList Data Layer] use the "Download as new layer" button. (If there isn't any data layer yet, this option is not available.)
    79116
    80117
    81118== See also ==
    82 * [[Image(source:trunk/images/downloadprimitive.png,20)]] [DownloadObject Download object]
    83 * [[Image(source:trunk/images/downloadreferrers.png,20)]] [DownloadParentWaysAndRelation Download parent ways and relations]
     119* [[JOSMImage(downloadprimitive)]] [wikitr:/Help/Action/DownloadObject Download object]
     120* [[JOSMImage(download)]] [wikitr:/Help/Action/DownloadParentWaysAndRelation Download parent ways and relations]
     121* [[JOSMImage(download-overpass)]] [wikitr:/Help/Action/OverpassDownload Download from Overpass API] (No longer exists in JOSM since it was integrated into this window in september 2017.)
     122* [[JOSMImage(download_in_view)]] [wikitr:/Help/Action/DownloadOsmInView Download in current view]
     123* [[Image(https://raw.githubusercontent.com/JOSM/continuos-download/master/images/continuous-download.png,link=,middle)]] [osmwiki:JOSM/Plugins/continuosDownload continuosDownload Plugin]
     124* [[JOSMImage(openlocation)]] [wikitr:/Help/Action/OpenLocation Open Location]
    84125
    85126----
    86 Back to [Menu/File Menu File][[Br]]
    87 Back to [wiki:/Help Main Help]
     127Back to [wikitr:/Help/Menu/File Menu File] \\
     128Back to [wikitr:/Help Main Help]