Access Point map database support tools

機能概要

apmap-eduroamJP.pl は、Cityroam仕様の基地局管理シートを元に、 eduroam JP申請システム向けに基地局マップデータを作成するための、 支援ツールです。

apmap-kml.pl は、Cityroam仕様の基地局管理シートを元に、 Google mapsのKMLファイルを作成するための、支援ツールです。 KMLファイルのPlacemarkブロックのみ出力します。

Cityroam仕様の基地局管理シートについて

基地局情報の管理と、組織間でのデータ交換を容易にするために、 無線認証連携協会 (Cityroam協会) で 策定された、標準形式のスプレッドシートです。

組織内で利用する場合、行の右側に独自のカラムを追加することができます。 visibilityで始まる行は、既存のラベルと重複しない限り、 独自のラベルを追加することができます。

apmap-eduroamJP.plの使い方

準備として以下を実行して、足りないモジュールがあればインストールしておく。

$ perl -c apmap-eduroamJP.pl

1. 基地局マップデータのテンプレート APmap-tmpl-vXXX.xlsx に従って、 基地局管理シートを作成する。
2. ver.20250808 以降ではExcelファイル (.xlsx) を直接に読み込める。 もしCSVファイルを使うなら、CSV UTF-8形式でエクスポートする。 (必ずUTF-8エンコードにする)
3. ExcelまたはCSVのファイルを apmap-eduroamJP.pl に読み込ませて、 リダイレクトによって出力ファイルを作成する。 (出力ファイルはBOM付きなことに留意)

$ ./apmap-eduroamJP.pl infile.xlsx > outfile.csv

4. eduroam JP申請システムからダウンロードしたスプレッドシート (テンプレート)を使い、 まずinstitutionシートを埋めておく。
5. コマンドで生成されたCSVファイル (outfile.csv) を別ウィンドウのExcelなどで読み込み、 テンプレートのlocationシートにコピー・ペーストする。 元から入っていた表は上書き削除する。
6. でき上ったスプレッドシートのファイル (.xlsx) を eduroam JP申請システムにアップロードする。

apmap-kml.plの使い方

スクリプトをテキストエディタで編集して、iconの設定などをカスタマイズする。 以下を実行して、足りないモジュールがあればインストールしておく。

$ perl -c apmap-kml.pl

1. 基地局マップデータのテンプレート APmap-tmpl-vXXX.xlsx に従って、 基地局管理シートを作成する。
2. ver.20250808 以降ではExcelファイル (.xlsx) を直接に読み込める。 もしCSVファイルを使うなら、CSV UTF-8形式でエクスポートする。 (必ずUTF-8エンコードにする)
3. ExcelまたはCSVのファイルを apmap-kml.pl に読み込ませて、 リダイレクトによって出力ファイルを作成する。

$ ./apmap-kml.pl infile.xlsx > outfile.kml

4. 出力ファイルにはPlacemarkブロックしか含まれないので、 先頭と末尾に足りない要素を補う。
   (KML/KMZファイルの内容はGoogle mapsのドキュメントを参照)
5. KMLファイルと付随するアイコンのイメージファイルを、zipでまとめて、 KMZファイルを作成する。

注意事項

• No Pull Requests.
  基本的にPRは受け付けていないので、修正や要望がある場合はまず Issueで連絡してください。
• 入力データに対する安全性は確保されていません。 スクリプトをウェブサービスなどに組み込んで使う場合は、 十分な対策が必要です。

リンク集

• 無線認証連携協会 (Cityroam協会)
• eduroam JP: 基地局マップデータの提出
• Find out where you can #love2eduroam (GÉANT提供のeduroam基地局マップ)
• eduroam Supporting services
  • Specification eduroam-database-ver30112021.pdf (PDF)