We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation. If there's a problem with translations on this page, please let us know.

Raster Maps (Online / Offline)

Raster maps is an extensive addition to the offline OpenStreetMap Vector maps the application uses by default. Raster maps allow to combine different map sources with Vector Maps. For example, useful Hillshade / Slope information could be displayed as a raster layer. You can display an overlay of hiking routes, live rain maps, live traffic data and an underlay of satellite imagery mixing with semi-transparent base vector map. You can also switch default maps to online web raster tiles.

В этой статье

Use cases

There is a big variety of possible use cases cause they vary on infinite external map source possibilities. Here are some popular:

  • Satellite imagery as underlay
  • Live traffic information
  • Rain forecast as overlay
  • Rich topographic maps with hillshades / slopes
  • Active cycling / running trails as overlay
  • Live vessel information
  • Online OpenStreetMap tiles for OSM editing purposes

Online maps overview

Note: You can also change the main source of the map from vector maps to online tiles.

Raster Maps

Online maps in OsmAnd are raster data. Raster data is made up of pixels (also referred to as grid cells) - set of small images (tiles). In contrast to vector maps which consists of binary data like roads, points, polygons. Raster map tiles are usually regularly-spaced and square. They often look pixelated because each pixel has its own value or class.

Comparison to default vector maps.

Advantages:

  • Display time is reasonably faster because maps are not rendered by the device.
  • Raster maps could be loaded on the fly during map browse.
  • Possibility to preload data partially i.e. create offline cache and be able to download missing tiles on the fly.
  • Indefinite variety of external web-sources. Basically, each website with maps could be used as a source data.
  • The data could be updated after expiration like traffic tiles are updated every 20-30 minutes (configurable).

Disadvantages:

  • Significantly bigger comparing to Vector maps. City example: Vector Map - 15 MB, Online 15th Zoom - 50 MB, 16th - 200 MB, 17th - 800 MB, ...
  • Places on raster maps are not clickable.
  • Not possible to change map style or exclude certain objects.
  • Pixelized on zoom (if no high-density tiles are not available).
  • It is not possible to rotate a map with readable text (text will be rotated with the map itself, thus will not be easily readable).

How to use Raster maps

Enable plugin

In order to use raster maps in Android OsmAnd you need to enable Online maps plugin:

Android: Меню → Плагины → Онлайн-карты →  → Включить.

For iOS OsmAnd this feature works by default.

Select map as Main / Underlay / Overlay layer

Raster maps can be used as Map source in OsmAnd (by default, offline vector maps are enabled). Map sources are configurable in:

Android: Меню → Настройки карты → Источник карты…

iOS: Menu → Map → Map type → Online maps

You can choose one of them in the list or add yours.

Not only can you use one map, but you can also add up to two of the online tiles to the basic layer maps to combine three of them on the screen. For instance, you can open a basic OsmAnd offline vector maps, then add a satellite view for the overlay, and put a cycling routes map underneath. You can set the base map transparency for your layer and whether display the transparency slider on the main screen or not.

Android: Меню → Настройки карты → Карта наложения… / Карта подложки…

Configure underlay / overlay Android

iOS: Menu → Map → Overlay / Underlay

Configure underlay / overlay iOS

Change layer parameters (transparency)

In order to mix raster map layers better, you can change layer transparency (by using a screen slider) and also you can change vector map style (hide polygons), so the underlay layers will be more visible, especially useful for satellite imagery.

Hillshade / Slope

Hillshade / Slope are raster offline maps that are displayed as a special map layer - Terrain (2nd overlay). These maps are created from 1 source (global planet file) and divided into regions, but it is not needed to switch between maps cause it's been merged automatically. You can exclusively select Hillshade and Terrain layer, though you could be combined if you use as underlay or overlay.

Terrain layers

To download and install Hillshade / Slope Maps, you need to purchase / enable Contour lines plugin.

Configure display options:

Android: Меню → Настройки карты → Рельеф

iOS: Menu → Map → Terrain

Terrain layers

Prepare / copy raster maps to device

There are multiple ways how to add new raster map, copy it from another device, prepare it on PC and predownloaded tiles to be used offline. For example, you can create your own map package on PC by using special software as MOBAC, OsmAndMapCreator and etc. Typically raster maps are distributed as files with .sqlitedb extension.

Here are the main methods how to add new raster map source which is not defined in OsmAnd yet:

  • Copy a raster map to a tiles subfolder of base osmand storage (Android).
  • Open ready to use .sqlitedb file with OsmAnd.
  • Import package with prepared online maps from another OsmAnd application as a special osf package via Import / export functionality.
  • Create new online map source on a mobile device itself.
  • Prepare a magic URL with online map source parameters and open it with OsmAnd.

Add new online raster map source

To create a raster map source you need to know the tile URL. This is URL that can distribute tiles in Mercator Projection. Here is a tile example URL https://tile.osmand.net/hd/6/55/25.png, where is the base part https://tile.osmand.net/hd/.

In order to add a new online raster map source go to:

Android: Меню → Настройки карты → Источник карты… → Добавить

iOS: Menu → Map → Overlay / Underlay → Add online source

At this screen you need to add the next parameters:

Add online source

ParameterDescription
[Name]Provide name for online source
[URL]Enter or copy and paste URL for online source
[Zoom levels]This parameters will affect the map display when used as a map type or overlay/underlay. Map type: the map will be limited to the selected zooms. Overlay / Underlay: Zoom levels at which tiles will be visible. Upscale or downscale will occur above or below the set values.
[Expire time]Expiration time in minutes. Cached tiles will be reloaded after specified time. Leave this field empty if you do not need to reload tiles for this source. One day is 1440 minutes. One week is 10 080 minutes. 30 days are 43 200 minutes.
[Mercator Projection]Pseudo-Mercator projection or Elliptic mercator
[Source format/Формат хранения]SQLiteDB file or One image file per tile

Click to "Сохранить" button for adding a new online raster map to the list.

Magic URL to install map source

Online maps can be added with a special link to OsmAnd Raster map list. Click to this link and choose OsmAnd for opening:

http://osmand.net/add-tile-source?name=TEST&url_template=http://h0.ortho.tiles.virtualearth.net/tiles/h{q}.jpg?g=45&min_zoom=9max_zoom=20

Parameter of linkExample
[Constant part]http://osmand.net/add-tile-source
[Separator]?
[Name]name=TEST
[URL]template=http://h0.ortho.tiles.virtualearth.net/tiles/h{q}.jpg?g=45
[Zoom levels]min_zoom=9max_zoom=20

You find added Online map in the list of Main / Underlay / Overlay layer menu.

Manage raster maps

Raster maps can take a significant amount of disk space, so you might need to regularly check it. For large datasets, it's recommended to use 'SQLite raster source' cause it will store all tiles in 1 large file (sqlite database).

In order to change tile format you can choose Формат хранения in the edit menu of online maps:

Android: Меню → Загрузка карт → Локальные → Онлайн и кешированные карты (растровые) → choose online maps →  → Редактировать → Формат хранения → Файл SQLiteDB / Каждый тайл в своём файле

iOS: Menu → Maps & Resources → Local → Online raster maps → i → Edit → Source format → SQLiteDB file / One image file per tile

Clear raster map cache

Tiles are saved in the cache during usage of Online Raster maps as Main / Overlay / Underlay layer, you can see only the size of your SQ Lite file under name of your Online map in the list. Sometimes a regular cleanup is needed to speedup tiles display or to refresh data.

Android: Меню → Загрузка карт → Локальные → Онлайн и кешированные карты (растровые)

iOS: Menu → Maps & Resources → Local → Online raster maps

Online sources list

In order to clear map tiles cache you need to do next:

Android: Меню → Загрузка карт → Локальные → Онлайн и кешированные карты (растровые) → choose online maps →  → Удалить из кеша

iOS: Menu → Maps & Resources → Local → Online raster maps → i → Clear cache

Download / update tiles

If you want to access raster maps offline, you might need to predownload tiles. It's possible to do on a mobile device though be aware that some services might block a large batch download. Same feature can be used to update already downloaded tiles for selected areas, otherwise OsmAnd will continue display tiles that are already stored in the cache.

Hint: if you want maps to automitically update tiles after some time, you can configure expiration time, so OsmAnd will redownload tiles once the tile is going to be displayed.

For this, you need to choose your online source as Map source:

Android: you need to select the area by the size of your screen device and to do a long click on the map - Меню → Действия → Скачать карту / Обновить карту → At this screen you need to choose zoom levels → screen of downloading progress → Загрузить

Download tiles Android

iOS: you need to do a long click on the map - Actions → Download map / Update map → At this screen you can select the needed area, choose zoom levels. When you set all parameters you can see a number of tiles and download size. Next, click to Continue → screen of downloading progress.

Download tiles iOS

Change raster map parameters

Raster maps can be used as is if tiles are already packaged inside the maps. In case raster maps are provided online, there is always a base url to be configured. There are some other basic parameters that can be modified for raster maps - see here. More sophisticated parameters are encoded in the internals of SQ Lite format.

You can change some raster map parameters inside OsmAnd itself.

Android: Меню → Загрузка карт → Локальные → Онлайн и кешированные карты (растровые) → choose online maps →  → Редактировать

iOS: Menu → Maps & Resources → Local → Online raster maps → i → Edit

Did this doc help you?

Privacy policy

Help us make these docs great!

All OsmAnd docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.

Все еще нужна помощь?

Join OsmAnd community Поддержка