QRの内容
QRコードには座標、オブジェクト名、メモ、プロジェクト要素、グループ情報が含まれる場合があります。そのためグループQRは機密です。
QRデータ形式
QRインポートとQRデータ形式
ArxSilex MapTools のQRコードは、コンパクトなアプリデータのためのバージョン付き交換形式です。
最終更新: 2026年5月28日
概要
利用と開発のための概要
このセクションでは、QRコードに含まれる内容、技術的な生成方法、インポートがローカルで行われる理由をまとめます。
技術的な互換性
独自ツールは、バージョン、サイズ制限、エンコード、検証ルールに従えばQRコードを生成できます。
ローカルインポート
リンクはアップロードではありません。サーバーはpayloadを処理せず、アプリがQRリンクからローカルにデータを読み取ります。
URL構造
QRリンク
QRコードは検証済みHTTPSアプリリンクを使用します。データブロックはフラグメント記号の後にあります。
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
#以降の部分は通常Webサーバーに送信されません。そのため同じリンクがアプリリンクと説明ページへのフォールバックになります。
プライバシー
機密情報として共有
QRコードには座標、オブジェクト名、メモ、プロジェクト要素、グループ情報が含まれる場合があります。
自動送信なし
QRデータはローカルで処理されます。このWebサイトはpayloadをデコードまたは保存しません。
地理データ
位置やプロジェクトオブジェクトは個人データになり得ます。QRコードは適切な相手にのみ共有してください。
グループ
グループQRにはグループキーが含まれます。スキャンした人はグループ参加またはデータのインポートが可能です。
技術仕様
技術仕様
現在はバージョン1が文書化されています。新しいバージョンは古いアプリで拒否される場合があります。
| 項目 | 値 | 注記 |
|---|---|---|
| 現在のHTTPSアプリリンク | https://www.arxsilex.de/app/maptools/qr#d=<payload> | 末尾スラッシュなしのパス。Androidアプリリンクはこの形で登録されています。 |
| ドキュメントURL | https://www.arxsilex.de/app/maptools/qr/index.html | このWebドキュメントはQRフォルダー内の index.html として提供されます。 |
| 旧スキーム | asmaptools://qr?v=1&d=<payload> | 古いフローや外部スキャナー向けの互換形式です。 |
| Payloadエンコード | Base64URL, UTF-8 JSON | paddingなしのURL安全Base64。内容はUTF-8 JSONです。 |
| スキーマバージョン | v: 1 | 1未満のバージョンは無効で、新しいバージョンは拒否される場合があります。 |
| Payload制限 | 2,200 bytes | 信頼できるQR生成とデコードのための保守的な上限です。 |
| 受信URI上限 | 64 KiB | 受信deep linkの厳格な上限です。 |
| QRレンダリング | ZXing QR, error correction M, 512 px | アプリは512 pxのQRビットマップを生成し、小さなアプリロゴを配置する場合があります。 |
Schema
QRインポートとQRデータ形式
オブジェクトQRは短いキーを使い、QRコードを小さく保ちます。キーは技術識別子です。
| キー | 意味 | フィールド |
|---|---|---|
| v | スキーマバージョン | integer |
| m | マーカー | i, n, inf, la, lo, ic, cl |
| c | 円 | i, n, la, lo, r, cl, sc, fc |
| d | 距離 | i, n, la, lo, ea, eo, cl |
| b | 方位/方向 | i, n, la, lo, bg, ln, iv, bc, cl |
| a | エリア | i, n, pts, cl, sc, fc |
| r | ルート | i, n, pts, cl |
グループ
型付きグループpayload
グループQRは型付きJSON payloadを使います。グループキーは機密情報です。
type: group
name、group_id、group_key、原点、色、説明、任意の短いメッセージを含みます。
type: objects
オブジェクトデータをobjectsフィールドに包みます。
type: group_with_objects
グループプロファイルと任意のオブジェクトを組み合わせます。アプリはグループ、オブジェクト、または両方をインポートできます。
検証
検証と制限
アプリはインポート前にQRデータを確認し、無効な形状や大きすぎるデータを拒否します。
座標
緯度は -90 から 90、経度は -180 から 180。エクスポート座標は小数5桁に丸められます。
形状
IDは0より大きい必要があります。ルートは2点以上、エリアは3点以上の異なる点が必要です。
方位
方位は0から360度、補正は-180から180度、長さと間隔は最大1,000 kmです。
JSON
例
Base64URLエンコード前の例です。実際のQRリンクではエンコードされたJSONが #d=... に入ります。
{
"v": 1,
"m": [
{"i":1,"n":"Start","la":48.13715,"lo":11.57612,"ic":"PIN"}
]
}{
"v": 1,
"type": "group",
"name": "Team Alpha",
"group_id": 123456,
"group_key": "shared-secret",
"originLat": 48.13715,
"originLon": 11.57612
}