JA:OpenStreetBrowser/Category Tags
カテゴリはタグ(例. name, description) 及びいくつかの(0..n) ルールから成っています。全てのタグはこのページに文書化されています。
カテゴリ
カテゴリはルール(下記参照)の集合です。カテゴリ自身は次のタグを持ちます:
name, name:lang | メイン言語(言語タグ参照)と翻訳内のカテゴリの名前。 |
description, description:lang | カテゴリの長い説明。 |
lang | このカテゴリのメイン言語(デフォルト: en) |
id | カテゴリのid ; id が既に取られていた場合はランダムなidがセットされ、'id:message' タグが追加されます |
サブカテゴリの定義
サブカテゴリは所属するカテゴリを最初に選択/表示して、OpenStreetBrowser内で表示/選択されるカテゴリです。サブカテゴリは他のカテゴリと同じやり方で定義されます - サブカテゴリにするのはその親カテゴリ内のサブカテゴリの一覧だけです。カテゴリ一覧に表示させないための一般的なオプションは hide=yes(下記参照)をサブカテゴリ用に使うことです。
追加タグ
これらのタグはカテゴリにも使えます。
sub_categories | この一覧のサブカテゴリのID, ";"区切り |
hide | 一覧で隠すならyesをセット(セットしてもサブカテゴリのままです) |
no_overlay | このタグに'yes'がセットされると, このカテゴリにはオーバーレイが作成されません |
overlays | このカテゴリ用の追加オーバーレイを表示(";"-区切り) |
ルール
ルールタグはカテゴリ一覧内でどのようにオブジェクトを表示するかを定義します。タグの中には("PARSED"とマーク済のもの)表示の前に前処理されるものがあります。例. もし"icon_text"タグが"[name];[ref]"にセットされれば、オブジェクトタグ"name" または "ref" はマップにプリントされます。
カギ括弧で囲まれた文字列([...])はその一致するタグで置き換えられます。複数のバリアントが可能で、';'で区切られます。例. (デフォルト): "[ref] - [name];[name];[ref];[operator]"。バリアントの全てのタグが結果を得られなければ、次のバリアントが試されます。
プライマリタグ
ルールは少なくとも次のタグを持たなければなりません:
name, name:lang | ルールの名前。 |
match | これらのタグに一致する全オブジェクトを一覧表示, 例. "amenity=bar" (一致ルール参照) |
importance | このオブジェクトの重要性は?オブジェクトは重要性の降順に並べて返されます。これは同時にオブジェクトがマップ上にどのズームレベルから表示するかを定義します。利用できる値: global, international, national, regional, urban, suburban, local. 詳細は下記参照。
|
type | このオブジェクトを次の種別で検索 (デフォルト: "polygon;point"):
|
テキストタグ
icon_text | アイコンの下に名前を表示するのにどのタグを使うべきか。(PARSED) Notes:
|
icon_text_data | 次のタグには、より興味深いデータがあります (例., レストランの料理の種類、電力線の電圧、...) - (PARSED, e.g. "[cuisine]", "[voltage] - [wires];[voltage]") 注意:
|
icon_label | アイコンのトップのテキスト(例. 道路標識上の参照番号タグ)。icon_nameと同様にテキストをフォーマットすることができます。このテキストのスタイルを定義するにはicon_text_style を使います。 |
line_text | テキスト、ライン上にプリントされます。 種別'line' 専用。 注意:
|
list_text | サイドバーのカテゴリ一覧内に現れるテキスト (デフォルト: "[ref] - [name];[name];[ref];[operator]") |
スタイルタグ
icon | アイコンのURL (SVGが望ましい) |
icon_style | アイコンの画像のスタイルをCSSのように記述します。正しい値は[1] (ライン向けには[2])を参照, 'file', 'width', 'height' 及び'type' は自動生成されますが。この値がそのカテゴリに適用されれば、全てのルールのデフォルトです。 |
icon_text_style | アイコンの下のテキストのスタイルを記述。正しい値は[3]参照, 'name', 'dy' 及び 'vertical_alignment' は自動生成されますが。この値がカテゴリに適用されると、全てのルールのデフォルトになります。例: "fill: #ff0000; halo_fill: #000000; size: 14;". |
icon_label_style | アイコンのトップのテキストのスタイルを記述。正しい値は[4]参照, 'name' は自動生成されますが。 |
line_text_style | テキストをフォーマット。icon_name_style参照 |
polygon_style | ポリゴン用のスタイル。値は[5]参照。 |
line_style | ライン用のスタイル。値は[6]参照。 |
他のタグ
group | タグ一覧によるグループオブジェクト(display_name 参照)。これらのオブジェクトは単一のオブジェクトにマージされます。これはより良い通り名や複数公共交通機関停留所の単一の名前を説明します。 |
一致ルール
ルールはひとつ、または複数のタグに一致することができます, 例. "amenity=place_of_worship religion=christian" は amenity=place_of_worship 及び religion=christian のどちらのオブジェクトにも一致します。タグは半角スペースで区切られます。あなたは類義語を"amenity=atm, atm=yes"のように作成でき、これは amenity=atm や atm=yes に、より簡単に一致します。
これは一致のための文法です:
tag=value | タグ-値 ペアに一致 |
tag=value1;value2 | タグは ; 区切りで指定された値のひとつを持つ |
tag=* | タグは任意の値を持てるが、空白はダメ |
tag!=value1;value2 | タグの全ての値に一致 (空白も可)するが、指定された値には一致しない |
tag!=* | タグは値を持てない |
tag=*!=value1;value2 | タグは値を持つ必要があるが、指定された値以外で |
tag>value | タグは数値として解釈され、value より大きくなければならない (使える演算子: >, <, >=, <=) |
tag>value1<=value2 | value はvalue1より大きくなければならないが、value2 以下でなければならない |
- 値がスペースを含む場合、二重引用符で囲まなければならない(例. "30 km")。
- オブジェクトの値が ';'を含む場合、それらは異なる値のリストとして解釈されます。例. amenity=bar;cafe は amenityで、 bar 及び cafeの機能を提供します。
数字のパース
テキスト値が数値としてパースされる場合、次のルールが適用されます:
regexp | 説明 | 例 |
---|---|---|
[0-9]+ | 10進数 | 1234 |
[0-9]+\.[0-9]+ | 浮動小数点(float) | 123.4 |
[0-9]+,[0-9]+ | 多くの国々では . の代わりに , が一般的です | 123,4 |
number( )*.* | a dimension unit (see seperate table) is provided, either directly after the number or seperated by whitespace | "123 m" or "123m" |
Possible dimsion units (デフォルト単位は太字):
m | Meter |
mm, cm, km | 0.001, 0,01, 1000 Meters |
m^2 or m2 or m2, a, ha, km^2 or km2 or km2 | Areas: square metres, ares (100 m2), hectar (10 000 m2), square kilometers (1 000 000 m2) |
in, ft, yd, mile(s), league(s) | Inch, Feet, Yards, Leagues |
V, kV | Volt, Kilovolt (1000 V) |
acre(s) | ~4046 m2 |
重要性
重要性によって、ある対象物は指定したズームレベルから表示されます:
importance | 一覧表示 | マップ上のアイコン | マップ上のアイコン+ラベル |
---|---|---|---|
global | z1 | z2 | z4 |
international | z4 | z5 | z8 |
national | z7 | z8 | z10 |
regional | z10 | z11 | z13 |
urban | z12 | z13 | z15 |
suburban | z14 | z15 | z16 |
local | z16 | z17 | z18 |