Nội dung QR
Mã QR có thể chứa tọa độ, tên đối tượng, ghi chú, phần dự án hoặc thông tin nhóm; vì vậy QR nhóm là thông tin mật.
Định dạng dữ liệu QR
Nhập QR và định dạng dữ liệu QR
Mã QR trong ArxSilex MapTools là định dạng trao đổi có phiên bản cho dữ liệu ứng dụng nhỏ gọn.
Cập nhật lần cuối: 28 tháng 5 năm 2026
Tóm tắt
Tổng quan cho sử dụng và phát triển
Phần này tóm tắt mã QR chứa gì, có thể tạo kỹ thuật như thế nào và vì sao việc nhập diễn ra cục bộ.
Tương thích kỹ thuật
Công cụ riêng có thể tạo QR nếu tuân thủ phiên bản, giới hạn kích thước, mã hóa và quy tắc xác thực.
Nhập cục bộ
Liên kết không phải là tải lên. Máy chủ không xử lý payload; ứng dụng đọc dữ liệu cục bộ từ liên kết QR.
Cấu trúc URL
Liên kết QR
Mã QR dùng app link HTTPS đã xác minh. Khối dữ liệu nằm sau dấu fragment.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
Phần sau # thường không được gửi đến máy chủ web. Vì vậy cùng một liên kết có thể là app link và fallback đến phần giải thích này.
Quyền riêng tư
Chia sẻ bảo mật
Mã QR có thể chứa tọa độ, tên đối tượng, ghi chú, phần dự án hoặc thông tin nhóm.
Không tự động truyền
Dữ liệu QR được xử lý cục bộ. Website này không giải mã hoặc lưu payload.
Geodata
Vị trí và đối tượng dự án có thể là dữ liệu cá nhân. Chỉ chia sẻ QR với người nhận phù hợp.
Nhóm
QR nhóm chứa khóa nhóm. Người quét mã có thể tham gia nhóm hoặc nhập dữ liệu nhóm.
Đặc tả kỹ thuật
Đặc tả kỹ thuật
Hiện tài liệu mô tả phiên bản 1. Phiên bản mới hơn có thể bị ứng dụng cũ từ chối.
| Mục | Giá trị | Ghi chú |
|---|---|---|
| App link HTTPS hiện tại | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Đường dẫn không có slash cuối; app link Android được đăng ký như vậy. |
| URL tài liệu | https://www.arxsilex.de/app/maptools/qr/index.html | Tài liệu web này được phục vụ dưới dạng index.html trong thư mục QR. |
| Scheme cũ | asmaptools://qr?v=1&d=<payload> | Định dạng tương thích cho scanner cũ hoặc bên ngoài. |
| Mã hóa payload | Base64URL, UTF-8 JSON | Base64 an toàn cho URL không padding; nội dung là JSON UTF-8. |
| Phiên bản schema | v: 1 | Phiên bản dưới 1 không hợp lệ; phiên bản mới có thể bị từ chối. |
| Giới hạn payload | 2,200 bytes | Giới hạn thận trọng để tạo và giải mã QR đáng tin cậy. |
| Giới hạn URI đến | 64 KiB | Giới hạn cứng cho deep link đến. |
| Kết xuất QR | ZXing QR, error correction M, 512 px | Ứng dụng kết xuất bitmap QR 512 px và có thể thêm logo nhỏ. |
Schema
Nhập QR và định dạng dữ liệu QR
QR đối tượng dùng khóa ngắn để giữ mã nhỏ. Khóa vẫn là định danh kỹ thuật.
| Khóa | Ý nghĩa | Trường |
|---|---|---|
| v | Phiên bản schema | integer |
| m | Điểm đánh dấu | i, n, inf, la, lo, ic, cl |
| c | Vòng tròn | i, n, la, lo, r, cl, sc, fc |
| d | Khoảng cách | i, n, la, lo, ea, eo, cl |
| b | Góc phương vị/hướng | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Khu vực | i, n, pts, cl, sc, fc |
| r | Tuyến | i, n, pts, cl |
Nhóm
Payload nhóm có kiểu
QR nhóm dùng payload JSON có kiểu. Khóa nhóm là thông tin mật.
type: group
Chứa tên, group_id, group_key, gốc, màu, mô tả và tin nhắn nhanh tùy chọn.
type: objects
Bọc dữ liệu đối tượng trong trường objects.
type: group_with_objects
Kết hợp hồ sơ nhóm và đối tượng tùy chọn. Ứng dụng có thể nhập nhóm, đối tượng hoặc cả hai.
Xác thực
Xác thực và giới hạn
Ứng dụng kiểm tra dữ liệu QR trước khi nhập và từ chối hình học không hợp lệ hoặc dữ liệu quá lớn.
Tọa độ
Vĩ độ -90 đến 90, kinh độ -180 đến 180. Tọa độ xuất được làm tròn đến 5 chữ số thập phân.
Hình học
ID phải lớn hơn 0. Tuyến cần ít nhất 2, vùng cần ít nhất 3 điểm khác nhau.
Góc phương vị
Góc 0 đến 360 độ, hiệu chỉnh -180 đến 180 độ, chiều dài và khoảng cách tối đa 1.000 km.
JSON
Ví dụ
Ví dụ trước khi mã hóa Base64URL. Trong liên kết QR thật, JSON đã mã hóa nằm trong #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
}