source: osm/applications/editors/josm/plugins/MicrosoftStreetside/README.md@ 34317

Last change on this file since 34317 was 34317, checked in by renerr18, 6 years ago

Initial checkin of MicrosoftStreetside source

File size: 2.8 KB
Line 
1Microsoft Streetside JOSM Plugin
2======
3
4The Microsoft JOSM Streetside (https://www.microsoft.com/en-us/maps/streetside) Plugin enables the viewing of Microsoft Streetside 360 degree imagery in the JOSM editor. It is based on the implementation of the Mapillary plugin (https://wiki.openstreetmap.org/wiki/JOSM/Plugins/Mapillary).
5
6Once JOSM is started and the MicrosoftStreetside plugin is selected in the JOSM Preferences, available Streetside imagery can be display within the boundary of the downloaded JOSM area, by selecting Imagery -> Streetside, from the main menu. Once blue bubbles appear on the map signifying Streetside imagery, clicking on a bubble results in the 360 degree imagery being displayed in the 360 degree viewer, which can be undocked and enlarged to allow for better viewing.
7
8## Documentation
9
10You can find out more about how to use the plugin and how it works in the [project Wiki](https://github.com/JOSM/MicrosoftStreetside/wiki).
11
12If you want to know how to configure the plugin, you can look at the [Configuration Wiki page](https://github.com/JOSM/MicrosoftStreetside/wiki/Configuration).
13
14## Building from source
15Checkout the JOSM source, compile it and checkout the plugin source:
16
17 svn co http://svn.openstreetmap.org/applications/editors/josm josm
18 cd josm/core
19 ant clean dist
20 cd ../plugins
21 rm -rf areaselector
22 git clone https://github.com/JOSM/JOSM-areaselector.git areaselector
23 cd areaselector
24 ant clean install
25
26Now Restart JOSM and activate the MicrosoftStreeside plugin in your preferences.
27The MicrosoftStreetside menu items will appear in the JOSM main menu after JOSM is
28restarted.
29
30Details about plugin development can be found [in the JOSM wiki](https://josm.openstreetmap.de/wiki/DevelopersGuide/DevelopingPlugins).
31
32## License
33
34This plugin is based on the Mapilary developed by developed and maintained by nokutu (nokutu@openmailbox.org) and extended to display Streetside imagery by Rene Rhodes (renerr18) You can contact Rene on github.
35
36This software is licensed under [GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html).
37
38### Third party resources
39
40The MicrosoftStreetside plugin used JavaFX to implement the Streetside 360 degree viewer [JavaFX](https://en.wikipedia.org/wiki/JavaFX), which, while bundled in the Oracle Java SE 1.8, is not an official part of the
41Java SE 1.8 specification, and may not function properly with alternative JDKs (e.g. OpenJDK is not currently supported). JavaFX is licensed under the same terms as Java SE (http://www.oracle.com/technetwork/java/javase/terms/license/index.html).
42
43The plugin also makes use of the compact Resty libary for communicating with RESTful web services from Java (https://beders.github.io/Resty/Resty/Overview.html). Resty is licensed under the MIT license (https://github.com/go-resty/resty/blob/master/LICENSE).
Note: See TracBrowser for help on using the repository browser.