Changes between Version 93 and Version 106 of Help/Action/Download


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Action/Download

    v93 v106  
    33= File > Download data =
    44
    5 [[Image(source:trunk/images/download.png,middle)]] ''Keyboard shortcut:'' **{{{Ctrl+Shift+↓}}}**
     5[[PageOutline(2-10,Table of Content)]]
     6
     7[[JOSMImage(download,48,link=,middle,margin-right=20)]] ''Keyboard shortcut:'' **`Ctrl+Shift+↓`**
    68
    79**Download map data from a server of your choice.**
    8 
    9 [[PageOutline(2-10,Table of Content)]]
    1010
    1111Downloading data with the Download window in JOSM follows these 3 simple steps:
    12121. Choose a source server and optional adjust the download options the server offers
    13131. Choose an area to download
    14 1. Click on [[Image(source:trunk/images/download.png,middle)]] Download
     141. Click on [[JOSMImage(download)]] Download
    1515
     16 **Note:** If [ExpertMode Expert mode] is not enabled, the following text is displayed (at the bottom of the window): ''Use left click & drag to select an area, arrows or right mouse button to scroll the map, scroll wheel or +/- to zoom.''\\
     17 [[Image(UseTo___Zoom.png,600,link=)]]
    1618
    1719== Source server and server download options ==
     
    1921
    2022=== Download from OSM ===#Downloadfromosm
    21 [[Image(SlippyMap.png)]]
     23[[Image(Slippy map (macOS).png,link=)]]
    2224
    2325This is the default download method. Different types of data can be downloaded (it is possible to download all three types at once):
     
    2729* [wikitr:/Help/Dialog/Notes Notes]
    2830
    29 There 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.[[BR]]
     31There 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. \\
    3032You can download bigger areas using several smaller ones or try another source server.
    3133
    32 === Download from Overpass API ===
    33 [[Image(Overpass.png)]]
     34=== Download from Overpass API ([wikitr:/Help/ExpertMode expert mode]) ===#DownloadfromOverpassAPI
     35[[Image(Download from Overpass API (macOS).png,link=)]]
    3436
    3537The 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.
     
    4345JOSM 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.
    4446
    45 The Query Wizard helps you to easily create an Overpass Turbo query. See [osmwiki:Overpass_turbo/Wizard] for its syntax and features.
    46 
    47 [[Image(Wizard.png,250)]]
     47The Query Wizard that uses JOSM [wikitr:/Help/Action/Search search] syntax helps you to create an Overpass Turbo query.
    4848
    4949In the favorite editing window the first box contains the name and the box below the query.
    5050
    51 [[Image(Favorite.png,250)]]
     51[[Image(Favorite.png,250,link=)]]
    5252
    53 === Download from Sophox API ===
    54 [[Image(Sophox.png)]]
     53=== Download from Sophox API ([wikitr:/Help/ExpertMode expert mode]) ===#DownloadfromSophoxAPI
     54[[Image(Download from Sophox API (macOS).png,link=)]]
    5555
    5656Similar 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.
    5757
    5858The 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].
     59
     60=== Download from MapWithAI API ===
     61This requires the plugin [wikitr:/Help/Plugin/MapWithAI MapWithAI].
    5962
    6063
     
    6467The 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].
    6568
    66 === Slippy map ===
    67 [[Image(SlippyMap.png,400)]]
     69=== Slippy map ===#Slippymap
     70[[Image(Slippy map (macOS).png,400,link=)]]
    6871
    6972The ''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.
    7073
    71 Clicking on the [[Image(source:/trunk/images/dialogs/layerlist.png,middle)]] 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].
     74Clicking 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].
    7275
    7376=== Bookmarks ===
    74 [[Image(Bookmarks.png,400)]]
     77[[Image(Bookmarks (macOS).png,400)]]
    7578
    7679In 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.
     
    7881There are special bookmarks, which can't be modified directly:
    7982* The Home location bookmark represents the home location, which you have set in your osm profile on osm.org.
    80 * With the [[Image(source:trunk/images/dialogs/changeset/downloadchangeset.svg,middle,28)]] button on the left you can download the bboxes of you last 15 changesets, which are added as bookmarks then.
     83* 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.
    8184
    8285Double 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.
    8386
    8487=== Bounding Box ===
    85 [[Image(BBox.png,400)]]
     88[[Image(Bounding box (macOS).png,400,link=)]]
    8689
    8790In 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.
     
    9194Instead 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.
    9295
     96You can copy bounds to clipboard with the ''Copy bound'' button
     97
    9398=== Area around places ===
    94 [[Image(AreaAroundPlaces.png,400)]]
     99[[Image(Areas around places (macOS).png​,400,link=)]]
    95100
    96 On 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]. After 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.
     101On 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...". \\
     102After 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.
    97103
    98104=== Tile Numbers ===
    99 [[Image(TileNumbers.png,400)]]
     105[[Image(Tile numbers (macOS).png,400,link=)]]
    100106
    101107In 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].
     
    111117By 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.)
    112118
     119
    113120== See also ==
    114 * [[Image(source:trunk/images/downloadprimitive.png,middle)]] [wikitr:/Help/Action/DownloadObject Download object]
    115 * [[Image(source:trunk/images/download.png,middle)]] [wikitr:/Help/Action/DownloadParentWaysAndRelation Download parent ways and relations]
    116 * [[Image(source:trunk/images/download-overpass.png,middle)]] [wikitr:/Help/Action/OverpassDownload Download from Overpass API] (No longer exists in JOSM since it was integrated into this window in september 2017.)
    117 * [[Image(source:trunk/images/download_in_view.png,middle)]] [wikitr:/Help/Action/DownloadOsmInView Download in current view]
    118 * [[Image(https://raw.githubusercontent.com/JOSM/continuos-download/master/images/continuous-download.png,middle)]] [osmwiki:JOSM/Plugins/continuosDownload continuosDownload Plugin]
    119 * [[Image(source:trunk/images/openlocation.png,middle)]] [wikitr:/Help/Action/OpenLocation Open Location]
     121* [[JOSMImage(downloadprimitive)]] [wikitr:/Help/Action/DownloadObject Download object]
     122* [[JOSMImage(download)]] [wikitr:/Help/Action/DownloadParentWaysAndRelation Download parent ways and relations]
     123* [[JOSMImage(download_in_view)]] [wikitr:/Help/Action/DownloadOsmInView Download in current view]
     124* [[Image(https://raw.githubusercontent.com/JOSM/continuos-download/master/images/continuous-download.png,link=,middle)]] [osmwiki:JOSM/Plugins/continuosDownload continuosDownload Plugin]
     125* [[JOSMImage(openlocation)]] [wikitr:/Help/Action/OpenLocation Open Location]
    120126
    121127----
    122 Back to [wikitr:/Help/Menu/File Menu File][[Br]]
     128Back to [wikitr:/Help/Menu/File Menu File] \\
    123129Back to [wikitr:/Help Main Help]