JA:Maperitive

Maperitive は OSM データなどを使って、リアルタイムにマップを描画（レンダリング）するデスクトップアプリケーションです。

http://maperitive.net/

It is a successor to Kosmos. Renaming explained on igorbrejc.net blog

The full documentation (under construction) is at http://maperitive.net/docs/. The instructions here are just to get you going while the full documentation is being written and are the "discoveries" of the early adopters and the Author's helpful emails.

You can download the latest version of Maperitive from http://maperitive.net/download/ (requires .NET Framework v4.0). Keep in mind that it is still in the beta stage of development and as of now it has just a simple GUI and is controlled via a command console. Please attend when using the command line the different use of / under Linux and \ under Windows.

インストール

sudo apt-get install libmono-winforms2.0-cil mono-devel

chmod +x ./Maperitive.sh
./Maperitive.sh

echo "text/vnd-maperitive-rules  mrules" >> ~/.mime.types

echo "text/vnd-maperitive-rules; gedit '%s'; description=\"Maperitive rules file\"; test=test -n \"\$DISPLAY\"" >> ~/.mailcap

yum install mono-winforms

chmod +x ./Maperitive.sh

./Maperitive.sh

cd /Applications/Maperitive

mono Maperitive.exe

データの取得

OSMデータが必要となります。コレを取得するにはいくつかの方法があります。

• JOSMを使ってエリアのダウンロードし File>Save As で保存する
• Geofabrikで .bz2 ファイルを取ってくる

Maperitive はすべてのデータをRAMに読み込むので、あまりに大きなエリアは使わないほうが良いです。 Osmosis や Osmconvert で不要なデータを削除してください。

It's a good idea to set up a directory for your working files with (for example) data, rules, scripts and outputs sub-directories.

以降の例は、データが c:\users\igor\documents\osm\maperitive\data\test.osm にあると仮定して進めます。

Basic Instructions

コマンドを入力しウィンドウ下の灰色のバーをクリック（もしくはEnterを入力）すると、バーが黄色に変わります。メニューから使えるコマンドもあります。 Maperitive はコマンドをただ一つに特定できる文字を要求します。 It fills in what it can as you go along.

デフォルトでは、背景にMapnikの地図タイルが表示されます。（インターネットに接続されている場合）表示したい場所に移動する場合は、次のようにします。例えば、ロンドン中心部に移動する場合は:

move-pos x=-0.11 y=51.52

データをMapnikの地図タイルの背景の上に描画する場合、もしくは空白のページを用いる場合:

clear-map

あなたのデータが別のディレクトリにある場合は、そのディレクトリをデフォルトにすると便利です。これは、次のようにします。

change-directory c:\users\igor\documents\osm\maperitive\

地図データを読み込む場合:

load-source data\test.osm

すると、地図は読み込まれ、デフォルトのルールにしたがって描画されます。（このルールはMaperativeと同時に解凍された、rules\default.txt ファイルにあります。）これらの描画ルールはMapnikの描画に似たものです。これを保存するには次のように入力します。:

export-bitmap zoom=15 file=outputs\test.png width=3000 height=3000 scale=3

おめでとうございます。これであなたもレンダラーの一員です。

描画ルールを変える

描画ルールを変えるには、アクティブになっているルール（のファイル）を開いて、次のコマンドを実施します。ここで、あなたの作業ディレクトリにコピーを作っておきましょう（rules\test.mrules に別名保存するのがベストです。）:

edit-rules

編集する際、インデントの保存が必要です。色付けの変更を試してみましょう。（一般的な色は、言葉での入力が可能です。）変更して保存するには:

use-ruleset location=rules\test.mrules as-alias=test
apply-ruleset

変更を保存して、次を実行すると、あたらしい描画ルールにしたがって色付けがされます。

reload-ruleset

Maperativeは数秒新しいルールの効果を示します。 デフォルトのルールに戻すには、エイリアスを使います。:

use-ruleset alias=default
apply-ruleset

Maperitive はあなたの描画ルールのありかを覚えています。ですので、再読込する必要はありません。もしエイリアスを再使用する場合は、古い場所を上書きしてください。

The "wireframe"-Ruleset is a useful ruleset. It renders all lines whatever tags they have. This ruleset is pre-defined and has the alias "wireframe". You can use it with use-ruleset alias=wireframe followed by apply-ruleset

Examples for user modified or created rules can be found here in the Wiki in the Category Maperitive/Rules and some rendered samples can be found here: Maperitive/SampleRenderings.

スクリプト（Scripts）

一連のコマンドをテキストファイルで保存しておくことができます。例えば

move-pos x=-0.11 y=51.52
clear-map
change-directory c:\users\igor\documents\osm\maperitive\
use-ruleset location=rules\test.txt as-alias=test
load-source data\test.osm
export-bitmap zoom=15 file=outputs\test.png width=3000 height=3000 scale=3

一度にこれらのコマンドを実行させることができます。

run-script c:\users\igor\documents\osm\maperitive\scripts\myscript.txt

これらの保存するために、Maperitiveを解凍した際にできた、scripts\default.txt にchange-directoryを記述しておきます。（ただし、アップデートの際には上書きされるかもしれません。）もしくは、作業ディレクトリにWindowsのバッチファイル（.bat）を作ります。: maperitive.exe scripts\myscript.txt をバッチファイルとしてつくり、デスクトップにショートカットを置きます。ショートカットファイルのプロパティに、maperitive.extの場所へのStart In をセットする必要があります。You can also use the maperitive.ico icon (same place as maperitive.exe).

描画ルールファイルの理解

ルールのファイルのレベル構造は以下のとおりです。

features
        ...
        areas
                ...
        lines
                ...
        points
                ...
properties
        ...
rules
        target : feature1
                ...
        target : feature2
                ...

features section は Maperitive にどの地図デーを使って欲しいかを指示します。つまり、どのエリアや線、点だけを対象として欲しいのか、もしくはすべてをチェックさせたいのか定義します。

properties section はMaperitive's defaultsを上書きします。 (例えば使用フォントなど).

rules sectionではMaperitiveにfeatures（で定義した一連のデータ）にたいしてどのように描画するかを指示します。通常はいくつかのプロパティを定義し、それらを使って描画します。You can change the rendering within each rule based on further tests, which makes it very flexible indeed.

Commands

The full list of commands can be seen by typing help-commands. They scroll past really quickly and the window is very narrow, so here they are listed as at version 809 (28 March 2010).

キーボードショートカット

The full list of Keyboard-Shortcuts can be seen by typing help-keyboard. They scroll past really quickly and the window is very narrow, so here they are listed as at version 1154 (April 2nd, 2011)

> help-keyboard
   F3 (global): find-next
   Shift+F3 (global): find-prev
   Ctrl+A (map): zoom-all
   Ctrl+Shift+C (global): generate-contours
   Ctrl+Shift+D (global): download-osm
   Ctrl+E (global): export-bitmap
   Ctrl+H (global): go-home
   Ctrl+M (global): focus-map
   Ctrl+N (global): clear-map
   Ctrl+Q (global): exit
   Ctrl+R (global): reload-ruleset
   + (map): zoom-in
   = (map): zoom-in
   - (map): zoom-out
   Left (map): move-screen-pos x=-0.1
   Right (map): move-screen-pos x=0.1
   Up (map): move-screen-pos y=-0.1
   Down (map): move-screen-pos y=0.1
   Ctrl+Enter (global): prompt

Icons

Mapnik icons are included with Maperitive, but others are available (some of them may be subject to license, so at your own risk!) at:

• https://svn.openstreetmap.org/applications/share/map-icons/
• https://svn.openstreetmap.org/applications/rendering/mapnik/symbols
• http://josm.openstreetmap.de/svn/trunk/images/presets/
• http://www.sjjb.co.uk/mapicons/
• http://mapicons.nicolasmollet.com/
• http://thenounproject.com/

Maperitive copies icons to the cache\images\ directory, and then simply refers to the filename. So once the rules have been used once, there is no need to be connected to the internet.

Links

• Maperitive website: http://maperitive.net/
• Download: http://maperitive.net/download/
• Documentation: http://maperitive.net/docs/
• Author's blog: http://igorbrejc.net/category/openstreetmap/maperitive
• Tutorial: http://www.britishideas.com/2011/01/16/so-you-want-to-be-a-cartographer
• Walking Papers mit Maperitive erstellen
• Sample renderings: Maperitive/SampleRenderings
• BBBike.org extract service offers download of SVG files for an area of your choice in different stilings, updated weekly.

How to

How to use Maperitive to work off line and display different options simply for the end user.

• Maperitive/HowTo

How to use Maperitive's find command.

• Maperitive/HowTofind

Example for rulesets can be found under

• Category Maperitive/Rules

Example for scripts can be found under

• Category Maperitive/Scripts