https://github.com/tsmock/microsoftstreetside

https://github.com/tsmock/microsoftstreetside

josm josm-plugin

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/tsmock/microsoftstreetside
• Owner: tsmock
• Created: 2024-03-26T19:36:36.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-05-16T16:47:57.000Z (8 months ago)
• Last Synced: 2024-05-16T17:58:28.442Z (8 months ago)
• Topics: josm, josm-plugin
• Language: Java
• Size: 18.9 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md

Awesome Lists containing this project

README

        
Microsoft Streetside JOSM Plugin

======

The 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).

Once 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.

## Documentation

You can find out more about how to use the plugin and how it works in the [project Wiki](https://github.com/JOSM/MicrosoftStreetside/wiki).

If you want to know how to configure the plugin, you can look at the [Configuration Wiki page](https://github.com/JOSM/MicrosoftStreetside/wiki/Configuration).

## Building from source

Checkout the JOSM source, compile it and checkout the plugin source (the last gradle command is optional, but contains code checking and unit test functionality - requires a Gradle installation):

    svn co http://svn.openstreetmap.org/applications/editors/josm josm

    cd josm/core

    ant

    cd ../plugins

    rm -rf MicrosoftStreetside

    git clone https://github.com/JOSM/MicrosoftStreetside.git MicrosoftStreetside

    cd MicrosoftStreetside

    ant clean

    ant dist

    gradle build

    

Now Restart JOSM and activate the MicrosoftStreetside plugin in your preferences. 

The MicrosoftStreetside menu items will appear in the JOSM main menu after JOSM is

restarted.

Details about plugin development can be found [in the JOSM wiki](https://josm.openstreetmap.de/wiki/DevelopersGuide/DevelopingPlugins).

## License

This plugin is based on the Mapillary developed by developed and maintained by nokutu ([email protected]) and extended to display Streetside imagery by Rene Rhodes (renerr18) You can contact Rene on GitHub.

This software is licensed under [GPL v3](https://www.gnu.org/licenses/gpl-3.0.en.html). 

### Third party resources

The 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 

Java 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).

Third-party JDKs such as Azul have versions with JavaFX included. Please use those.