# OSM import to Dedale (gs-geography)

This sister-project allow users to import and format OpenStreetMap data so that it can be used as environment within Dedale (and any other project based on graphStream).

We stand on the now discontinued gs-geography project developped by the GraphStream developers. Thanks a lot for their work. As their was no response from them, we forked it and updated it so that it could work with current libraries and added some simple functionnalities.

• It now supports gs 2.0-alpha, gs ui-swing-2.0-alpha, geotool 23 and java > 8,
• We added the conversion from pbf 2 osm so that we can use more data sources,
• We added simple API calls.

This project require a lot of big dependencies in order to be able to run. That’s why we did not integrate it in Dedale natively.

1. Download the project and install it as a maven project. Maven build (or install) will take a while to get all dependencies. All the duration indicated bellow start after this step is done.

## How to quickly & easily use a very small OSM area within Dedale ? (5 mins)

1. Go to OpenStreetMap and choose your area
1. Select “Export”
2. Select, “manually select the area” to further optimise the extracted location
• If the website either says “This area is too large to be exported in OpenStreetMap XM format.” and do not offer a download button or allow you to download but then says “You requested too many nodes (limit is 50000). Either request a smaller area, or use planet.osm”, you loose. Change the area size or drop this quick & easy solution for the complex one (see below)
• If the download is successfull, congrats, the longest part is done.
1. In the gs-geography project, use the Test_OSM_RoadNetwork2.java file or create your own java file with:
public static void main(String args[]) {

List<String> ls= new ArrayList<String>();

}

1. That’s it. You can now copy the resulting dgs file and enjoy this real topology in Dedale.

## How to get an intermediary sized file from OSM to Dedale ? (6 mins)

1. Go to overpass turbo
2. Select the area you are looking and call the “assistant” with : highway=* and type:way
3. Select export then download as “GeoJSON”
1. Download and launch a desktop editor. We recommend JOSM
2. Open the previously downloaded file and remove unnecessary data
3. Export as an osm file
4. Call the generatGsFromOSM method presented above on this file and its done.
5. That’s it. You can now copy the resulting dgs file and enjoy this real topology in Dedale.

## How to get a big topology from OSM to Dedale ? (several hours long and unoptimized process)

1. You will need to download a pbf file (compressed version of an OSM).
• 1.a) If its a file of reasonnable size, you can download it from OSM websiste, step 1 above, by clicking on “API-overpass”.
• 1.b) If still too big, go to Planet OSM and download the area you need.
1. Install and use one of the available pbf editor (JSOM is one of them).
2. Extract the sub-area you are looking for and save it into a pbf file. Reduce the area as much as possible and remove unneeded informations to diminish the weight of the file.
3. Look for the Test_pbf2OSM.java file and change the name of your file or create your own java file with :
public static void main(String args[]) {

List<String> ls= new ArrayList<String>();