Help:Extension:Kartographer/ja

このページはKartographer extension とその  および   タグについての使い方を文書化しています.

始めてみよう
 このコードはシンプルでインタラクティブなマップ（右側に見えているようなもの）を挿入し、マップをダブルクリックもしくは右上のアイコンをクリックすると最大化することができます.

パラメータを使用してデフォルトの配置を左、右、あるいは中央にオーバーライドすることができます.

の使用法
 { "type": "Feature", "geometry": { "type":"Point", "coordinates":[-122.3988, 37.8013] }, "properties": { "title": "Exploratorium", "description": "", "marker-symbol": "museum", "marker-size": "large", "marker-color": "0050d0" } }

タグの内容はGeoJSON editorが生成するような、空もしくは有効な、スタイリング付きのGeoJSONでなければなりません. KartographerはMaki icons （クリエイティブ・コモンズ0でライセンス）でsimplestyle specificationをサポートします.

Frames
Frameless maps are good for insertion as part of a template, whereas framed maps are good for insertion directly into the page, either by hand or by using the visual editor.


 * To insert a map without a frame, add the "frameless" attribute:
 * To add a caption, use the  attribute.

Note: Adding the text attribute automatically enables a frame, even if there is a  attribute.

GeoShapes external data
 { "type": "ExternalData", "href": "geoshape:///?ids=Q797" } GeoJSONを使ったポリゴン描画に加えて、よく知られた地理オブジェクトのアウトラインを、OpenStreetMapデータベース内でも同様にマークされている場合にそのウィキデータIDで取得することができます. 例えば、アラスカに対応するウィキデータの項目はQ797であり、「external data」の出典を使ってマップ上に描画することができます. カンマ区切りで複数のIDが指定されている場合もあります.

注意： ウィキデータのIDはOSMコミュニティにとって比較的新しいものです. IDを持つポリンゴンはまだ40,000件ほどです. これを増やすには、 https://www.openstreetmap.org/ にアクセスして タグを の値とともに追加してください.  { "type":"ExternalData", "href":"geoshape:///?query=SELECT%20%3Fid%20%3Fhead%0A%28SAMPLE%28%3Fimg%29%20as%20%3Fimg%29%20%0A%28SAMPLE%28%3Ffill%29%20as%20%3Ffill%29%20%0A%28concat%28%22%5B%5Bwikipedia%3A%22%2C%20substr%28str%28%3Flink%29%2C31%2C500%29%2C%20%20%22%20%7C%20%22%2C%20%3FheadLabel%2C%20%22%5D%5D%22%29%20as%20%3Ftitle%29%0A%28concat%28%3FstateLabel%2C%20%22%5Cn%22%2C%20%22%5B%5BFile%3A%22%2C%20substr%28str%28%3Fimg%29%2C%2052%2C%20500%29%2C%20%22%7C200px%5D%5D%22%29%20as%20%3Fdescription%29%0AWHERE%20%7B%0A%20%20%0A%20%20%3Fid%20wdt%3AP31%20wd%3AQ35657%20.%0A%20%20%3Fid%20wdt%3AP6%20%3Fhead%20.%0A%20%20%3Fhead%20wdt%3AP102%20%3Fparty%20.%0A%20%20BIND%28if%28%3Fparty%20%3D%20wd%3AQ29468%2C%20%22%23800000%22%2C%20if%28%3Fparty%20%3D%20wd%3AQ29552%2C%20%22%23000080%22%2C%20%22%23008000%22%29%29%20as%20%3Ffill%29%20%0A%20%20SERVICE%20wikibase%3Alabel%20%7B%0A%20%20%20%20bd%3AserviceParam%20wikibase%3Alanguage%20%22en%22%20.%0A%20%20%20%20%3Fhead%20rdfs%3Alabel%20%3FheadLabel%20.%0A%20%20%20%20%3Fid%20rdfs%3Alabel%20%3FstateLabel%20.%0A%20%20%7D%0A%20%20OPTIONAL%20%7B%0A%20%20%20%20%3Fhead%20wdt%3AP18%20%3Fimg%20.%0A%20%20%7D%0A%20%20%3Flink%20schema%3Aabout%20%3Fhead%20.%0A%20%20%3Flink%20schema%3AisPartOf%20%3Chttps%3A%2F%2Fen.wikipedia.org%2F%3E%20.%0A%7D%20GROUP%20BY%20%3Fid%20%3Fhead%20%3FheadLabel%20%3Flink%20%3FstateLabel%0A" } これはウィキデータのIDがよく知られている場合のシンプルなユースケースには役立ちますが、ウィキデータのクエリの結果としてIDの一覧を取得したいような場合があります. あるSPARQLのクエリは結果のID列にある全米の州の一覧を取得し、geoshapesサービスはそれぞれの州に幾何的なアウトラインを追加します. SPARQLクエリ結果内の他の全ての列は「プロパティ」オブジェクト内の値になります. 「fill」列は州の色を変更します. 「title」列は州知事の名前を表示し、「description」列には州の名前と知事の写真を表示するウィキのマークアップがあります. このクエリを編集するには、''' https://query.wikidata.org/#... '''のところの"#"記号の後にあるクエリ・パラメータをコピーします:

== を   に変更すると、フルスクリーンのマップへのリンクが作られます：

はまた外部パラメータ"text"を受け取り、座標の代わりにリンクテキストを指定します：

タグは  と同じgeojsonを含む場合があります.

== はリンクを作成し、クリックするとフルスクリーンのマップを表示します. リンクテキストは  属性で設定できます. この属性が無い場合は座標が表示されます（例：  が魔法の   や   の値に設定されます. このケースではそれぞれの  はインクリメンタルなカウンター   で、そして   は   の値で置き換えられます.

GeoJSONにひとつ以上のカウンターがある場合、最初のものの値はリンクテキストとして表示されます. さらにオプションとして、エディタが同じページで同時に複数のカウンターを持つために接尾辞を付加するかもしれません. このように、  は   とは異なるカウンターを持つでしょう.

各カウント用グループにはっきりした色を使うのは有意義でしょう. 経由で追加された全てのデータは  属性が使用されない限り、   で挿入された全てのマップ内で表示されます.

上記は以下のように展開できます

、 、そして 属性は、ポップアップ・マップの位置をコントロールします. リンクのテキストには を使用してください（有効なウィキテキスト・マークアップであればどれでも使えます）. 名前のあるグループに対しては、Use を使ってこのタグの内容を追加してください（下記参照）.

グループ
For use on the Wikivoyage project, there is a need to show a map whose data is defined somewhere else on the page. For example, there may be multiple points of interest (POI) defined with  tags, and one common map on the side of the page that shows them all.

The grouping concept allows editors to share data between multiple  and   tags.

By default, the data inside the  or   tag is shown only for that one tag, and will not be shown anywhere else.

If  or   specify the   attribute, the data inside those tags will be placed into a named group, together with all the other data by the same group name. As a result, any tags with the same group name will show the same map data, and each tag may incrementally add data to the group.

A tag may also show other groups, regardless if it belongs to a group or not, by specifying the  attribute. Comma-separated multiple group names may be specified. The group name may only contain lower case English letters. This matrix shows what data will be shown for each tag.