Extension:Kartographer/ja

Kartographer拡張機能（カートグラファー）は、（OpenStreetMapによる）地図をWikiページで表示することを可能にします. この拡張機能は、ウィキボヤージュやウィキペディア等のウィキメディアのサイト群で使うことを想定して作られていますが、他のどのようなウィキにおいても使用できます.

使用法
Kartographerはウィキテキストタグ  および を定義し、それぞれページ上に地図を表示および地図へのリンクを作成します. これらのタグの呼び出し方についてはを参照してください.

例
 { "type": "FeatureCollection", "features": } 

API
この拡張機能はふたつの内部 API を提供します.
 * mapdataのクエリ実行
 * 地図データの検証を実施

実装

 * API 解説文書
 * API 解説文書

Kartographer は地図の表示をするとき、以下のようにオープンソースとオープンデータの一連のツールを用います：
 * クライアント側（つまりブラウザーのキャッシュ）：
 * Leaflet（リーフレット）はWeb地図作成に使うJavaScriptライブラリ
 * サーバ側で実行：
 * Kartotherian, a map tile service developed by the Wikimedia Foundation, which itself contains code from Mapbox. Third party installations should use non-Wikimedia tile servers listed on Tile servers
 * Generating the data in advance:
 * Tilerator, a tile pre-generation service also developed by the Wikimedia Foundation
 * OpenStreetMap, an open map data source, the source for the map data as well as for most of the points of interest (POIs).

For more information on these, see Maps. For more information on the production aspects of running these services, see the Wikitech Maps page.

目標


全般的な目標

 * A simple method to insert a map into an article without requiring common.js code changes
 * Ability to add extra information (marks, area, popups, text, links) to the map
 * Ability to gather map usage statistics (KPI) to better gauge how and what should be improved.
 * TBD: experimentation - if the user is aware of the privacy implications, the map should be able to show external data from non-production source, e.g. Static, server-side rendered images will not include the extra data added via this method until the extra data source is hosted in the secure production environment and can be shown without the user action.



ウィキボヤージュの目標
Wikivoyage tends to have a large number of points of interest (POIs), such as museums and restaurants, listed on a page (see example and scroll down to the "See" section). Each POI is usually added with a template, but all of them should appear on the same map. Also, each POI should be referable by showing an icon with a number, both in the text of the article, and on the map:


 * Ability to incrementally add features to the map. For example, each usage of the restaurant template adds a single POI, and the map shows all of them.
 * Added features need to be indexable. E.g. the first restaurant template would show [1] on the page, and map would show POI as a clickable [1] element. There could be multiple index counters at the same time, each for its own type of POIs.



既知の問題点
See the corresponding project(s) in Phabricator for a complete list of bugs.

