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>
# 뒤의 부분은 일반적으로 웹 서버로 전송되지 않습니다. 따라서 같은 링크가 앱 링크와 설명 페이지의 대체 경로가 됩니다.
개인정보
기밀로 공유
QR 코드는 좌표, 객체 이름, 메모, 프로젝트 일부 또는 그룹 정보를 포함할 수 있습니다.
자동 전송 없음
QR 데이터는 로컬에서 처리됩니다. 이 웹사이트는 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 | 이 웹 문서는 QR 폴더의 index.html로 제공됩니다. |
| 레거시 스킴 | asmaptools://qr?v=1&d=<payload> | 이전 흐름이나 외부 스캐너와의 호환 형식입니다. |
| Payload 인코딩 | Base64URL, UTF-8 JSON | 패딩 없는 URL-safe 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
}