QRデータ形式

QRインポートとQRデータ形式

ArxSilex MapTools のQRコードは、コンパクトなアプリデータのためのバージョン付き交換形式です。

最終更新: 2026年5月28日

概要

利用と開発のための概要

このセクションでは、QRコードに含まれる内容、技術的な生成方法、インポートがローカルで行われる理由をまとめます。

QRの内容

QRコードには座標、オブジェクト名、メモ、プロジェクト要素、グループ情報が含まれる場合があります。そのためグループ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=<ペイロード>末尾スラッシュなしのパス。Androidアプリリンクはこの形で登録されています。
ドキュメントURLhttps://www.arxsilex.de/app/maptools/qr/このWebドキュメントはQRフォルダー内の index.html として提供されます。
旧スキームasmaptools://qr?v=1&d=<ペイロード>古いフローや外部スキャナー向けの互換形式です。
PayloadエンコードBase64URL、UTF-8 JSONpaddingなしのURL安全Base64。内容はUTF-8 JSONです。
スキーマバージョンv: 11未満のバージョンは無効で、新しいバージョンは拒否される場合があります。
Payload制限2,200 bytes信頼できるQR生成とデコードのための保守的な上限です。
受信URI上限64 KiB受信deep linkの厳格な上限です。
QRレンダリングZXing QR、エラー補正 M、512 ピクセルアプリは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を使います。グループキーは機密情報です。

タイプ: グループ

name、group_id、group_key、原点、色、説明、任意の短いメッセージを含みます。

タイプ: オブジェクト

オブジェクトデータをobjectsフィールドに包みます。

タイプ: 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
}