技術情報

ここでは、本サービスの動作やデータの取扱いについての技術的な情報を提供しています。

位置情報と日時

緯度と経度は、世界測地系 WGS84 上の位置座標で、「度」単位の小数点以下5桁まで保持しています。

距離と高度 (標高) はミリメートル単位で保持しています。原則としてメートル法を用いますが、ヤード・ポンド法表示に切り替えることができます。換算は、 0.3048m = 1ft (international foot)、 5280ft = 1ml (mile) としています。

距離の実測値がなく両端の座標のみが得られた場合の座標間距離は、原則として Hubeny の公式による WGS84 回転楕円体での距離を用いています。また、参考までに球としての座標間距離を一部で併記しています。距離は計測機器やアプリケーションによって扱いがまちまちであるため、 IBUKI で表示される値とは異なることがあります。

経路の獲得標高 (上り: 累積上昇高度・累積獲得標高・D+ / 下り: 累積下降高度・D-) は、経路中の上りまたは下りの区間の標高差の総和です。分断部分の標高差は含みません。獲得標高は計測機器やアプリケーションによって扱いがまちまちであるため、 IBUKI で表示される値とは異なることがあります。 IBUKI では、数値標高モデルを使用せず経路データの標高をそのまま使いますが、細かな上り下りの繰り返しは計算から除外しています。 v1 法は、 IBUKI の独自の方法で計算するものです。 v2 法は、 GPS Visualizer 法の 3. に近い IBUKI の独自の方法で計算するものです。現在 IBUKI では主として v2 法を用いていますが、一部で v1 法による値が表示されることがあります。

日時は UTC (世界時・GMT、厳密には閏秒のないUTC) の秒単位で保持しています。必要に応じて UTC との秒単位の時差情報も保持しています。

なお、すべての処理でここに示した精度を保っているわけではありません。

GPX

GPXファイルについては GPX 1.1 および主要な拡張に対応しており、 GPX Parsing の規定に基づき解釈します。

活動ログの登録では、 GPXファイルの各 track を1つの経路として扱います。 track は valid timestamped route である必要があります。距離の算出は determine the distance between track points の手順によります。

なお、GPXファイルに含まれていても IBUKI で不要な情報は保存しません。

GPXファイルとして保存すると、 1つの経路を1つの trk 要素として出力します。 1つの定点を1つの wpt 要素として出力します。元のコースやイベントや活動ログのページの URL を link 要素として出力します。

GPXファイルから活動ログを作成し、 GPXファイルとして保存しても、元のファイルが復元されるわけではありません。

画像

画像ファイルは PNG 形式と JPEG (JFIF) 形式に対応しています。

画像ファイルに Exif メタデータとして日時が含まれている場合、次の優先順位で利用します。

GPSDateStamp, GPSTimeStamp
DateTimeOriginal
DateTimeDigitized
exif.DateTime

活動ログの本文の画像ファイルに時差の情報が含まれない場合、活動ログのUTCとの時差とみなします。

画像ファイルに Exif メタデータとして GPSLatitude, GPSLongitude, GPSAltitude が含まれている場合、画像の位置情報として利用します。

CSV

CSV ファイルについては一般的な形式に対応しています。

第1行目は、各列の見出し (項目名) として解釈します。以下に示した項目名は自動認識できます。自動認識できない場合でも、読み込み画面で列の意味を指定できます。

次の各形式があります。

出場者情報CSVファイル: 項目名の例意味
short_label, 略称, エントリー番号, ゼッケン番号, Bib Number, bibnumber 出場者の略称。必須。
label, name, 名称, 名前, 氏名, チーム名 出場者の名称。必須。
label_kana, 名称 (よみがな), よみがな, ふりがな 出場者の名称 (よみがな)。
label_en, 名称 (English) 出場者の名称 (English)。
icon_label, アイコン表示名 出場者のアイコン表示名。
org, team, 所属, チーム 出場者の所属。
Gender, gender, sex, 性別, 性 出場者の性別。
age, 年齢 出場者の年齢 (非負整数, 0 は年齢不明・未設定)。
desc, description, 説明文, 説明, 紹介 出場者の説明文。
ranking_types, 表彰種別 出場者の表彰種別の識別子。
start_groups, スタートグループ 出場者のスタートグループの識別子。
owner_status, 状態 出場者の状態。 3, 有効 は有効、 2, 無効 は無効。
xtext1, 追加テキスト1 出場者の追加テキスト1。
xtext2, 追加テキスト2 出場者の追加テキスト2。
出場者端末CSVファイル: 項目名の例意味
short_label, 略称, エントリー番号, ゼッケン番号, Bib Number, bibnumber 出場者の略称。必須。
device_key, 装置キー 関連付けする計測機器を表す記号列。
p_device_key, 私物装置キー 関連付けする計測機器 (私物のIBUKI GPS端末) を表す記号列。
imei, IMEI, 私物IMEI 関連付けする計測機器 (私物のIBUKI GPS端末) の IMEI (数字列)。

device_key, p_device_key, imei からちょうど1つ必須。

項目名の例	意味
`short_label`, `略称`, `エントリー番号`, `ゼッケン番号`, `Bib Number`, `bibnumber`	出場者の略称。必須。
`label`, `name`, `名称`, `名前`, `氏名`, `チーム名`	出場者の名称。必須。
`label_kana`, `名称 (よみがな)`, `よみがな`, `ふりがな`	出場者の名称 (よみがな)。
`label_en`, `名称 (English)`	出場者の名称 (English)。
`icon_label`, `アイコン表示名`	出場者のアイコン表示名。
`org`, `team`, `所属`, `チーム`	出場者の所属。
`Gender`, `gender`, `sex`, `性別`, `性`	出場者の性別。
`age`, `年齢`	出場者の年齢 (非負整数, `0` は年齢不明・未設定)。
`desc`, `description`, `説明文`, `説明`, `紹介`	出場者の説明文。
`ranking_types`, `表彰種別`	出場者の表彰種別の識別子。
`start_groups`, `スタートグループ`	出場者のスタートグループの識別子。
`owner_status`, `状態`	出場者の状態。 `3`, `有効` は有効、 `2`, `無効` は無効。
`xtext1`, `追加テキスト1`	出場者の追加テキスト1。
`xtext2`, `追加テキスト2`	出場者の追加テキスト2。

項目名の例	意味
`short_label`, `略称`, `エントリー番号`, `ゼッケン番号`, `Bib Number`, `bibnumber`	出場者の略称。必須。
`device_key`, `装置キー`	関連付けする計測機器を表す記号列。
`p_device_key`, `私物装置キー`	関連付けする計測機器 (私物のIBUKI GPS端末) を表す記号列。
`imei`, `IMEI`, `私物IMEI`	関連付けする計測機器 (私物のIBUKI GPS端末) の IMEI (数字列)。

性別は、 男, 男性, male, M, 1 が男性。 女, 女性, female, F, 2 が女性。 その他, その他・選択しない, 選択しない, 不明, 3 がその他・未設定。

UTMB 形式の日付は、 YYYY-MM-DD (西暦年、月、日) または DD/MM/YYYY (日、月、西暦年)。

元号コードは、 明治, M, 1 が明治。 大正, T, 2 が大正。 昭和, S, 3 が昭和。 平成, H, 4 が平成。 令和, R, 5 が令和。 西暦, AD が西暦。 中華民國, 民國 は民国紀元。 仏暦, BE が仏暦 (タイ)。

誕生日を指定する場合、

Birthdate
birthera, birtherayear, birthmonth, birthdayofmonth
birthyear, birthmonth, birthdayofmonth

... のいずれか1組で記述してください。

提出用個人情報CSVファイル

提出用個人情報CSVファイルは、競技団体に提出するレースイベントの results file の作成用の CSVファイルです。

項目名の例	意味
`short_label`, `略称`, `エントリー番号`, `ゼッケン番号`, `Bib Number`, `bibnumber`	出場者の略称。必須。
`First Name`, `namelatin1`, `英字名`	名前のうち名 (英字)。
`Last Name`, `Family name`, `namelatin2`, `英字姓`	名前のうち姓 (英字)。
`Birthdate`, `birthdateutmb`	誕生日 (UTMB形式)。
`誕生日元号`	誕生日の元号コード。
`誕生日元号年`	誕生日の元号年 (整数)。
`birthyear`, `誕生日西暦年`	誕生日の西暦年 (整数)。
`誕生日月`	誕生日の月 (グレゴリオ暦の整数	1 - 12)。
`誕生日日`	誕生日の日 (グレゴリオ暦の整数	1 - 31)。
`gender`, `sex`, `性別`, `性`	性別。
`Nationality`, `nationalitycode`, `IOC国籍`	国籍 (IOC国コード)。
`Team`, `teamlatin`, `英字チーム名`	チーム名 (英字)。
`City`, `citylatin`, `英字都市名`	都市名 (英字)。
`Club`, `clublatin`	クラブ名 (英字)。
`data1`	追加データその1。そのまま出力されます。
`data2`	追加データその2。そのまま出力されます。
`data3`	追加データその3。そのまま出力されます。
`data4`	追加データその4。そのまま出力されます。
`data5`	追加データその5。そのまま出力されます。

電話番号の情報CSVファイル

電話番号の情報CSVファイルは、イベントのSMS宛先電話番号登録用のCSVファイルです。

項目名の例	意味
`出場者の略称`, `出場者`, `team`	出場者の略称。必須。
`電話番号`, `tel`, `電話番号1`, `tel1`	SMS 送信可能な電話番号。
`電話番号2`, `tel2`	SMS 送信可能な電話番号。
`電話番号3`, `tel3`	SMS 送信可能な電話番号。
`電話番号4`, `tel4`	SMS 送信可能な電話番号。
`電話番号5`, `tel5`	SMS 送信可能な電話番号。

電話番号は、 SMS 送信可能な携帯電話の番号を記述してください。 0 から始まる11桁の番号は日本の電話番号とみなします。 + から始まる番号は国番号から始まる電話番号とみなします。半角文字と全角文字は区別しません。欧州数字と漢数字(小字)に対応しています。 -, ‐, (, ) などは無視します。

対応 Web ブラウザー

IBUKI は、標準的な Webブラウザーでお使いいただけます。 (Internet Explorer は対象外とさせていただきます。)

パソコン、スマートフォンなどいろいろな機器からアクセスできますが、地図の編集にはパソコンの Web ブラウザーのご利用をおすすめいたします。

SNSアプリ、メールアプリ等のアプリ内ブラウザーは機能が制限されていることがあり、おすすめしていません。 Chrome、 Safari 等一般的なブラウザーをお使いください。詳しくはアプリの開発元にお問い合わせください。

IBUKI のご利用時には、 JavaScript を有効にする必要があります。

時刻を指定したリンク

活動ログページでは、素片識別子 (fragment identifier) に次のいずれかの形式を用いて、特定の位置にリンクすることができます。

t=s (s は開始からの秒数)
t=MM:SS (MM と SS は開始からの分数 (60未満)、秒数 (60未満))
t=h:MM:SS (h と MM と SS は開始からの時間数、分数 (60未満)、秒数 (60未満))

項目名の例	意味
`出場者の略称`, `出場者`, `team`	出場者の略称。必須。
`定点の略称`, `定点`, `marked_point`	定点の略称。必須。
`新しい装置キー`, `装置キー`, `device_key`	新しく関連付けを設定する装置キー。必須。