19 | | The type is chosen with the checkboxes at the top of the window. (It is possible to download all three types at once). |
| 20 | === Download from OSM ===#Downloadfromosm |
| 21 | [[Image(SlippyMap.png,link=)]] |
| 22 | |
| 23 | This is the default download method. Different types of data can be downloaded (it is possible to download all three types at once): |
| 24 | |
| 25 | * [osmwiki:Downloading_data OpenStreetMap data] ([osmwiki:Elements nodes, ways, relations]) |
| 26 | * [osmwiki:Upload Raw GPS data] (traces) |
| 27 | * [wikitr:/Help/Dialog/Notes Notes] |
| 28 | |
| 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. \\ |
| 30 | You 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 | |
| 35 | The 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 | |
| 37 | Overpass API offers download of OpenStreetMap data elements only (i.e. no gps traces or notes). |
| 38 | |
| 39 | To 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 | |
| 41 | If `{{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 | |
| 43 | JOSM 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 | |
| 45 | The Query Wizard that uses JOSM [wikitr:/Help/Action/Search search] syntax helps you to create an Overpass Turbo query. |
| 46 | |
| 47 | In 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 | |
| 54 | Similar 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 | |
| 56 | The 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 === |
| 59 | This requires the plugin [wikitr:/Help/Plugin/MapWithAI MapWithAI]. |
| 60 | |
43 | | * 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). |
44 | | * 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 the screen, and paste as described above. |
| 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. |
49 | | 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. |
| 97 | [[Image(AreaAroundPlaces.png,400,link=)]] |
| 98 | |
| 99 | 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]. If there are more than 10 results, only 10 results are displayed and the button changes to "Search more...". \\ |
| 100 | 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. |
57 | | There might be a red warning at the bottom right displayed if the selected area is probably too large for the server and will be answered with an error message.[[BR]] |
58 | | You can download bigger areas using several smaller ones. |
59 | | |
60 | | |
61 | | == Layer control == |
62 | | You can control whether the data is loaded into the current or in a new layer with the checkbox in the bottom left corner of the window: |
63 | | * if **Download as new layer** is selected, the data is loaded in a new layer |
64 | | * if **Download as new layer** is not selected, the data is loaded in the current data layer |
65 | | |
66 | | If there isn't any data layer yet, a new data layer is always created. |
67 | | |
68 | | |
69 | | == Display == |
70 | | Clicking on the [[Image(source:/trunk/images/layer-switcher-maximize.png,20,middle)]] button on the upper right gives you the option to change the displayed map (rendering machine) for this window. The available maps are based on your [[Help/Preferences/Imagery|Imagery preferences]]. |
71 | | |
72 | | An example of the displayed selection: |
73 | | |
74 | | * OpenStreetMap (Mapnik) |
75 | | * Cyclemap |
76 | | * Bing Aerial Maps |
77 | | * MapQuest Open Aerial |
78 | | |
79 | | |
80 | | == Mirror Download Plugin == |
81 | | * The XAPI query syntax is explained in the [osmwiki:Overpass_API/XAPI_Compatibility_Layer OSM wiki]. |
| 115 | By 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.) |
85 | | * [[Image(source:trunk/images/downloadprimitive.png,middle)]] [DownloadObject Download object] |
86 | | * [[Image(source:trunk/images/download.png,middle)]] [DownloadParentWaysAndRelation Download parent ways and relations] |
87 | | * [[Image(source:trunk/images/download-overpass.png,middle)]] [OverpassDownload Download from Overpass API] |
88 | | * [[Image(source:trunk/images/download_in_view.png,middle)]] [DownloadOsmInView Download in current view] |
89 | | * [[Image(source:trunk/images/openlocation.png,middle)]] [OpenLocation Open Location] |
| 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] |