Contenidos QR
Los códigos QR pueden contener coordenadas, nombres de objetos, notas, partes del proyecto o información de grupo; Por lo tanto, los códigos QR de grupo son confidenciales.
formato de datos QR
Importación QR y formato de datos QR
Los códigos QR en ArxSilex MapTools son un formato de intercambio versionado para datos de aplicaciones compactas. Esta página explica el uso, la privacidad y los detalles técnicos.
Última actualización: 28 de mayo de 2026
Resumen
Descripción general de uso y desarrollo.
Esta sección resume qué contienen los códigos QR, cómo se pueden generar técnicamente y por qué la importación se realiza localmente.
Compatibilidad técnica
Las herramientas personalizadas pueden generar códigos QR si siguen reglas de control de versiones, límites de tamaño, codificación y validación.
importación local
El enlace no es una carga. El servidor no procesa la carga útil; la aplicación lee los datos localmente desde el enlace QR.
estructura de URL
El enlace QR
Los códigos QR utilizan un enlace de aplicación HTTPS verificado. El bloque de datos se coloca después del signo del fragmento.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
La parte después de # normalmente no se envía al servidor web. Por lo tanto, el mismo enlace puede funcionar como enlace de aplicación y como alternativa a esta explicación.
Privacidad
Compartir confidencialmente
Los códigos QR pueden contener coordenadas, nombres de objetos, notas, partes del proyecto o información de grupo.
Sin transferencia automática
Los datos QR se procesan localmente. Este sitio web no decodifica ni almacena la carga útil.
Geodatos
Las ubicaciones y los objetos del proyecto pueden ser datos personales. Comparta códigos QR solo con destinatarios adecuados.
Grupos
Los códigos QR de grupo contienen la clave de grupo. Cualquiera que escanee el código puede unirse al grupo o importar datos del grupo.
Especificaciones técnicas
Estado del formato
La versión 1 está actualmente documentada. Las versiones más antiguas de la aplicación pueden rechazar las versiones más nuevas.
| Artículo | Valor | Notas |
|---|---|---|
| Enlace actual de la aplicación HTTPS | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Camino sin barra diagonal; así se registra el enlace de la aplicación Android. |
| URL de documentación | https://www.arxsilex.de/app/maptools/qr/ | Esta documentación web se sirve como index.html en la carpeta QR. |
| Esquema heredado | asmaptools://qr?v=1&d=<payload> | Formato de compatibilidad para escáneres antiguos o externos. |
| Codificación de carga útil | Base64URL, UTF-8 JSON | Base64 seguro para URL sin relleno; El contenido es UTF-8 JSON. |
| Versión del esquema | v: 1 | Las versiones inferiores a 1 no son válidas; Las versiones más nuevas pueden rechazarse. |
| Límite de carga útil | 2.200 bytes | Límite conservador para generación y decodificación confiable de QR. |
| Límite de URI entrante | 64 KiB | Límite superior estricto para enlaces profundos entrantes. |
| Representación QR | ZXing QR, corrección de errores M, 512 px | La aplicación genera mapas de bits QR de 512 px y puede colocar una pequeña superposición del logotipo de la aplicación. |
Esquema
Esquema de objeto compacto
Los códigos QR de objetos utilizan teclas cortas para mantener el código QR pequeño. Las claves en sí siguen siendo identificadores técnicos.
| Llave | Significado | Campos |
|---|---|---|
| v | Versión del esquema | entero |
| metro | Marcadores | i, n, inf, la, lo, ic, cl |
| do | circulos | yo, n, la, lo, r, cl, sc, fc |
| d | Distancias | i, n, la, lo, ea, eo, cl |
| b | Acimutes/direcciones | i, n, la, lo, bg, ln, iv, bc, cl |
| a | Áreas | i, n, pts, cl, sc, fc |
| r | Rutas | yo, n, pts, cl |
Grupos
Cargas útiles de grupo tipificadas
Los códigos QR grupales utilizan cargas útiles JSON escritas. La clave del grupo es confidencial.
tipo: grupo
Contiene nombre, group_id, group_key, origen, color, descripción y mensajes rápidos opcionales.
tipo: objetos
Envuelve los datos del objeto en un campo de objetos.
tipo: grupo_con_objetos
Combina perfil de grupo y objetos opcionales. La aplicación puede importar el grupo, los objetos o ambos.
Validación
Validación y límites
La aplicación verifica los datos QR antes de importarlos y rechaza la geometría no válida o los datos de gran tamaño.
Coordenadas
Latitud -90 a 90, longitud -180 a 180. Las coordenadas exportadas se redondean a 5 decimales.
Geometría
Los ID deben ser mayores que 0. Las rutas necesitan al menos 2 y las áreas al menos 3 puntos distintos.
Rumbos
Azimut 0 a 360 grados, corrección -180 a 180 grados, longitud e intervalo como máximo 1.000 km.
JSON
Ejemplos
Ejemplos antes de la codificación Base64URL. En el enlace QR real, el código JSON se coloca en #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
}