myOSM Help

Introduction

myOSM is an online and offline viewer for the famous OpenStreetMap. It supports various map types such as Osmarender, Mapnik, Cloudmade, OpenCycleMap, and NearMap.

The maps are stored locally on the harddrive and can also be used when being offline. You can download the maps at different zoom levels for a complete map regions. Using this feature you can download a map e.g. before going on a trip.

myOSM provides a bookmark feature for easy access to often used locations. You can also search for locations. The maps can be saved to a file or sent to a printer.

Working with the map

In the main window myOSM always shows a section of the currently selected map. If the map tiles have been downloaded before they are not reloaded from the net but the locally cached map tiles are used. If they are not cached locally they are loaded instantly from the net and the map view will be updated automatically.

You can change the type of the map using the dropdown box in the upper left area of the main window. Currently, the following map types are available:

You can move around the map by dragging it with the mouse. Double-click to zoom in. You can also use the zoom slider and the zoom buttons in the upper left part of the main window. Additionally you can either press CMD+ or CMD- to zoom in and out. And there is another way to zoom into a part of the map. Hold down the shift key and draw a rectangle with the mouse. myOSM will then zoom into that part.

Loading maps

As explained before myOSM loads missing map tiles from the net automatically. At the lower right part of the main window you will find a spinning symbol indicating that myOSM still loads new map tiles in the background. If you move the mouse pointer to that symbol the tooltip will give the number of map tiles still waiting to be loaded.

If you plan to go on a trip where you do not have internet access you may want to download the map beforehand. There is a feature for that in myOSM. As a first step move and zoom the map view to the part of the world you are interested in. Then select Load map from visible region... from the Tools menu. The following dialog will appear:

With the slider you can specify how many zoom levels you want to load. myOSM will then download all map tiles begining from the current zoom level up to the selected one. The number of map tiles and the estimated download size will be updated. When you press OK myOSM will add all missing map tiles to the download queue and will download them in the background.

Searching

If you want to navigate to a specific city or location you can use the search feature. Just enter the search term in the upper right search field. When pressing the enter key myOSM uses the geonames.org service to find corresponding locations for the given search term. The result window looks like this:

myOSM will move the map to the selected location when pressing the Goto button.

Bookmarks

You can bookmark locations that you often use. Just select Add Bookmark... from the Bookmarks menu and give the bookmark a name. When you select Edit Bookmarks... an editor will appear which let's you organize your bookmarks. Each bookmark contains the location itself and also the zoom level. When you select one of your bookmarks from the Bookmarks menu myOSM will move the map to that location and will also restore the zoom level.

The Cache

The map tiles are stored on your harddrive at the location /Users/USERNAME/Library/Caches/info.stichling.myOSM. myOSM will always search for map tiles on your harddrive before loading them from the internet. But due to the fact that the maps of OpenStreetMap are updated often you may want to refresh the map tiles. In that case you can delete the map cache. Select Clear map cache... from the Tools menu.

How to integrate more maps

myPhotoMap already provides various map types. These maps are available in the internet and their terms of use allow to use them free of charge.

If you have access to more map servers, you can provide a configuration file for accessing these servers. Technically this configuration file is an XML property list. The following example shows an example for such a file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Name</key>
  <string>OpenStreetMap - Mapnik</string>
  <key>CacheFolder</key>
  <string>MapOpenStreetMap1</string>
  <key>MaxZoomLevel</key>
  <integer>18</integer>
  <key>MapURLs</key>
  <array>
    <string>http://a.tile.openstreetmap.org/_Z_/_X_/_Y_.png</string>
    <string>http://b.tile.openstreetmap.org/_Z_/_X_/_Y_.png</string>
    <string>http://c.tile.openstreetmap.org/_Z_/_X_/_Y_.png</string>
  </array>
</dict>
</plist>

To configure your server you have to set the values marked in red:

You can only use map servers that provide maps as images in size 256x256 pixels. You cannot use map servers that provide maps as vector data.

To register such a configuration file you have to store it with the file extension ".maplayer". Then you have to drag&drop the file onto myPhotoMap's dock icon. Finally you have to restart myPhotoMap to make the new maps available.

Acknowledgements

Please have look at the Terms of use of the various maps that you use.

Contact

Dr. Dirk Stichling
Anne-Frank-Str. 14b
D-33106 Paderborn
Germany
Tel: +49 5254 647789
EMail: myosm@mytracks4mac.com