Conteúdo QR
Os códigos QR podem conter coordenadas, nomes de objetos, notas, partes do projeto ou informações de grupos; os códigos QR do grupo são, portanto, confidenciais.
Formato de dados QR
Importação QR e formato de dados QR
Os códigos QR em ArxSilex MapTools são um formato de troca com versão para dados compactos de aplicativos. Esta página explica uso, privacidade e detalhes técnicos.
Última atualização: 28 de maio de 2026
Resumo
Visão geral para uso e desenvolvimento
Esta seção resume o que os códigos QR contêm, como eles podem ser gerados tecnicamente e por que a importação ocorre localmente.
Compatibilidade técnica
Ferramentas personalizadas podem gerar códigos QR se seguirem regras de versionamento, limites de tamanho, codificação e validação.
Importação local
O link não é um upload. O servidor não processa a carga; o aplicativo lê os dados localmente a partir do link QR.
Estrutura de URL
O link QR
Os códigos QR usam um link de aplicativo HTTPS verificado. O bloco de dados é colocado após o sinal do fragmento.
https://www.arxsilex.de/app/maptools/qr#d=<base64url-json>
A parte após # normalmente não é enviada ao servidor web. O mesmo link pode, portanto, funcionar como um link de aplicativo e como um substituto para esta explicação.
Privacidade
Compartilhe confidencialmente
Os códigos QR podem conter coordenadas, nomes de objetos, notas, partes do projeto ou informações de grupo.
Sem transferência automática
Os dados QR são processados localmente. Este site não decodifica nem armazena a carga útil.
Geodados
Locais e objetos do projeto podem ser dados pessoais. Compartilhe códigos QR apenas com destinatários adequados.
Grupos
Os códigos QR do grupo contêm a chave do grupo. Qualquer pessoa que ler o código pode ingressar no grupo ou importar dados do grupo.
Especificação técnica
Status do formato
A versão 1 está atualmente documentada. Versões mais recentes podem ser rejeitadas por versões mais antigas do aplicativo.
| Item | Valor | Notas |
|---|---|---|
| Link atual do aplicativo HTTPS | https://www.arxsilex.de/app/maptools/qr#d=<payload> | Caminho sem barra final; é assim que o link do aplicativo Android é registrado. |
| URL da documentação | https://www.arxsilex.de/app/maptools/qr/ | Esta documentação da web é veiculada como index.html na pasta QR. |
| Esquema legado | asmaptools://qr?v=1&d=<payload> | Formato de compatibilidade para scanners mais antigos ou externos. |
| Codificação de carga útil | Base64URL, UTF-8 JSON | Base64 seguro para URL sem preenchimento; o conteúdo é UTF-8 JSON. |
| Versão do esquema | v: 1 | Versões abaixo de 1 são inválidas; versões mais recentes podem ser rejeitadas. |
| Limite de carga útil | 2.200 bytes | Tampa conservadora para geração e decodificação QR confiáveis. |
| Limite de URI recebido | 64 KiB | Limite superior rígido para links diretos de entrada. |
| Renderização QR | ZXing QR, correção de erros M, 512 px | O aplicativo renderiza bitmaps QR de 512 px e pode colocar uma pequena sobreposição do logotipo do aplicativo. |
Esquema
Esquema de objeto compacto
Os códigos QR de objeto usam teclas curtas para manter o código QR pequeno. As próprias chaves permanecem identificadores técnicos.
| Chave | Significado | Campos |
|---|---|---|
| v | Versão do esquema | inteiro |
| eu | Marcadores | eu, n, inf, la, lo, ic, cl |
| c | Círculos | eu, n, la, lo, r, cl, sc, fc |
| d | Distâncias | eu, n, la, lo, ea, eo, cl |
| b | Azimutes/direções | eu, n, la, lo, bg, ln, iv, bc, cl |
| um | Áreas | eu, n, pontos, cl, sc, fc |
| R | Rotas | eu, n, pontos, cl |
Grupos
Cargas de grupo digitadas
Os códigos QR de grupo usam cargas úteis digitadas JSON. A chave do grupo é confidencial.
tipo: grupo
Contém nome, group_id, group_key, origem, cor, descrição e mensagens rápidas opcionais.
tipo: objetos
Envolve dados de objeto em um campo de objetos.
tipo: grupo_com_objetos
Combina perfil de grupo e objetos opcionais. O aplicativo pode importar o grupo, os objetos ou ambos.
Validação
Validação e limites
O aplicativo verifica os dados QR antes da importação e rejeita geometria inválida ou dados superdimensionados.
Coordenadas
Latitude -90 a 90, longitude -180 a 180. As coordenadas exportadas são arredondadas para 5 casas decimais.
Geometria
Os IDs devem ser maiores que 0. As rotas precisam de pelo menos 2, áreas de pelo menos 3 pontos distintos.
Azimutes
Azimute 0 a 360 graus, correção -180 a 180 graus, comprimento e intervalo no máximo 1.000 km.
JSON
Exemplos
Exemplos antes da codificação Base64URL. No link QR real, o JSON codificado é colocado em #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
}