OpenLayers に基づく地図を Wiki ページ上に配置する、地図レンダリングプラグインです。 設定レイアウトで地図上に GPS データ（現在、GeoJSON・GPX・KML 形式に対応しています）や他の地理的なサービスを置くことができ、 オープンソース部品とデータ（OSM）を使用します。 また、非オープンデータ（Google・Virtual Earth）プロバイダを使用するように設定できます。 プラグインは、それぞれのベースマップレイヤが利用可能な設定項目に入力された API ライセンスキーに応じて、OpenLayers API を動的に読み込みます。

注：Dokuwiki の古いバージョン（2008-05-05、2009-02-14、Lemming、Anteater、Rincewind）の場合、version 1.0 が必要です。

拡張機能管理を利用するか SourceForge Mirror から手動でダウンロードして、プラグインを探してインストールして下さい。 手動でプラグインをインストールする方法はプラグインを参照して下さい。

プラグインの別の配布場所と旧版は http://sourceforge.net/projects/dokuwikispatial/files/openlayersmap/ にあります。

このプラグインは PHP GD 拡張機能 を持つサーバーが必要です。 一部の Linux ではデフォルトでインストールされていませんが、php5-gd パッケージです。 このプラグインをインストールする前に、 phpinfo() を確認してください。 インストールされていない場合、PHPの致命的なエラー Call to undefined function imagecreatetruecolor() … によって Wiki はオフラインになります 。 ただし、ローカルのバックグラウンドレンダリングエンジンを使用する場合のみです。

Change Log を参照して下さい。

現在、以下のオプションが設定可能／必要です（conf/default.php を参照して下さい）：

• enableOSM ベースマップ提供者として OpenStreetMap のベースレイヤー利用を有効にする
• enableMapQuest ベースマップ提供者として MapQuest Open のベースレイヤー利用を有効にする
• enableGoogle ベースマップ提供者として Google のベースレイヤー利用を有効にする
• enableBing ベースマップ提供者として Bing のベースレイヤー利用を有効にする
• bingAPIKey Bing には API キーが必要。取得先：https://www.bingmapsportal.com/application
• mapquestAPIKey MapQuest Static Maps API キー。取得先：http://developer.mapquest.com/
• googleAPIkey Google Static Maps API キー。取得先：https://code.google.com/apis/console
• iconUrlOverload DokuWiki on a Stick や DokuWikiStickNG のようにアクセス非公開ホスト上でスタティックマップを使用する場合のマップアイコン URL
• enableA11y a11y/print 出力（スタティックマップ、凡例表）を有効にする。POI の多い地図を使用する場合は、無効にしたいでしょう。
• optionStaticMapGenerator 'local' の a11y/print マップレンダラー、'remote' サービスのどちらを使用するか。商用／オープンでない提供者は常に独自の 'remote' サービスを使用します。備考： 'local' には Web サーバーのインターネットアクセスが必要です。
• autoZoomMap 地図の自動ズームを有効にする。POI・KML・GPX の範囲に地図をズームします。

地図上に表示可能なアイコンを追加（または変更）したい場合、プラグインのディレクトリ内の “icons” ディレクトリにそのアイコンを入れて下さい。 サイズは 16px です。 プラグインのインストール後、<yourbaseurl>/lib/plugins/openlayersmap/icons/ ¹⁾ に利用可能な手がかりがあります。 以下に素晴らしいアイコンがあります：

• https://mapicons.mapsmarker.com
• http://www.gpsdrive.de/development/map-icons/overview.en.shtml
• http://mapbox.com/maki/
• http://www.sjjb.co.uk/mapicons/contactsheet/
• http://projects.opengeo.org/geosilk

様々な実例を表示するプラグインを使用した小さなサイトが SourceForge にあります。

以下のページ/サイトでプラグインを利用しています：

• http://dokuwikispatial.sourceforge.net/dokuwiki/openlayersmap:start 開発版の様々な動作例
• http://wild-water.nl/dokuwiki/beschrijvingen/belgie/helle （更に他のページ）
• http://www.vegan-in-halle.de/wiki/doku.php?id=karte

<olmap id="olMap" width="600px" height="400px" lat="52.0" lon="5.1" zoom="12" statusbar="1" toolbar="1" controls="1" poihoverstyle="1" baselyr="OpenStreetMap" gpxfile=":playground:hardlopen_gpx.gpx" geojsonfile=":playground:test.gsojson" kmlfile=":playground:mtb.kml" summary="This map shows a gpx trace, a kml trace and a dot">
52.1,5.1,60,.8,marker-green.png,Just a spot
</olmap>

• id 地図の識別子（有効なJavaScript変数同様に有効なCSS・XHTML識別子である必要があります）例：olmap
• width 地図の幅、デフォルト値 400px
• height 地図の高さ、デフォルト値 300px
• zoom ズームレベル、デフォルト値 12。有効値は地図や所在地に依存、整数値が必須。
• controls 地図上のズームやパンの制御ボタンの表示・非表示。有効値は on と off、デフォルト値 on
• statusbar ステータスバーの表示・非表示。有効値は 1 と 0、デフォルト値 1（表示）
• poihoverstyle POI 機能の選択動作（ホバー・クリック）を指定。有効値は 1 と 0、デフォルト値 0（クリック）for reasons of accessibility using hover is dicouraged.
• lat 地図中心の緯度（WGS84）、マイナス値は南緯、有効値 -90.0 ～ 90.0
• lon 地図中心の経度（WGS84）、マイナス値は西経、有効値 -180.0 ～ 180.0
• baselyr 地図を開いた時に表示されるベースマップレイヤー、有効値： OpenStreetMap・transport・landscape・cycle map・hike and bike map・mapquest road・mapquest sat・google relief・google sat・google hybrid・google road・bing road・bing sat・bing hybrid。（注：オープンでないマップの場合、APIキー／URL が必要な場合もあります）
• gpxfile GPX ファイル、位置を取得するためにメディアマネージャを使用する。
• kmlfile KML ファイル、位置を取得するためにメディアマネージャを使用する。
• geojsonfile GeoJSON ファイル、位置を取得するためにメディアマネージャを使用する。
• summary 地図の説明

重要地点（POI）の書式は以下のとおりです：

緯度, 経度, 回転角度, 不透明度, 画像, ポップアップ用文章

（ほとんどの GPS が使用する）EPSG:4326 に従った重要地点（POI）緯度・経度の範囲まで地図は拡大します。 ポップアップ用文章は、通常のDokuWiki構文によって整形が可能で、同様にリンクが含むことも可能です。 （以下の議論や sample website にある例を参照して下さい）

• ほとんどのマップサービスは HTTP 上で動作して使用するので、Wiki サイトが HTTPS 上で動作している場合に問題があります。視聴者には警告メッセージ（クロスドメイン警告）が表示されます。

Discussion を参照して下さい。