osmc:Convenções/Identificadores inteligentes: mudanças entre as edições
mSem resumo de edição |
(agrupando itens da caracterizaçao e propriedades desejadas) |
||
| Linha 1: | Linha 1: | ||
'''Identificadores geográficos inteligentes''', de vias, lotes, etc. possuem as seguintes características: | '''Identificadores geográficos inteligentes''' ('''ID''' inteligente), de vias, lotes, etc. possuem as seguintes características: | ||
* ''' | * do ''ID público'', na sua representação para humanos, em expressão textual: | ||
* ''' | ** '''Legível''' ao humano, otimizada para ser '''o mais curto possível'''. | ||
* ''' | ** '''Preservando hierarquia''', permitindo a contextualização e encurtamento por prefixo. | ||
* | ** '''Compatível''' com formatos [https://www.w3.org/TR/did-core/ W3C '''DID'''] e/ou [[wikipedia:URN|URN]]. | ||
* do ID na sua ''representação interna'' em bancos de dados: | |||
** '''Auto-confirmável''': dado apenas o ID, consegue-se confirmar ''offline'', no mapa, a sua localização geográfica. | |||
** '''Inteiro positivo de 64 bits''', preservando hierarquia e otimizado para buscas e demais operações. | |||
* da resolução do ID: | |||
** '''Atualidade e rastreabilidade''': a resolução ''online'' do ID permite que seu histórico seja conhecido em tempo de consulta, idealmente com devidas atualizações. | |||
** ID '''compatível''' com as diretivas básicas de interoperabilidade do [https://www.w3.org/TR/did-core/ W3C '''DID''']. | |||
*** '''Gerador independente de autoridade central''': qualquer um, conhecendo o algoritmo e o objeto geográfico a ser identificado, pode gerar um ID do objeto. | |||
** Metadados públicos '''em conformidade com a legislação local do escopo LADM''', ou seja, vigente na jurisdição georeferenciada pelo ID, no escopo caracterizado pela [https://www.iso.org/standard/51206.html ISO LADM]. | |||
** '''Transparente''': o banco de dados mais atual é também disponível ao público em formato aberto e estruturado, por exemplo em repositório ''git'' aberto, com licença da família CC0. | |||
Na '''metodologia AFA''' (orientada a ''[[#Geo-tokens]]'') a tecnologia do ID inteligente está intimamente ligado ao protocolo [[Geo URI estendida]]. Outros elementos da metodologia: | |||
* Deslocamentos (de posicionamento do vetor no OSM ou concretos da via real) requerem o uso de "''alias''" da antiga posição para a nova posição, na API de resolução da via. | * Deslocamentos (de posicionamento do vetor no OSM ou concretos da via real) requerem o uso de "''alias''" da antiga posição para a nova posição, na API de resolução da via. | ||
| Linha 19: | Linha 29: | ||
== Protocolo de resolução de IDs de objetos == | == Protocolo de resolução de IDs de objetos == | ||
Internamente, no banco de dados, os identificadores são inteiros de 64 bits conforme [[Código natural/Representação interna]]. | Internamente, no banco de dados, os identificadores são inteiros de 64 bits conforme descritos em [[Código natural/Representação interna]]. | ||
A [[Geo URI estendida]] (e a [[wikipedia:URN|URN]]) pode ser estendida para incorporar IDs inteligentes na resolução do servidor AFA: | A [[Geo URI estendida]] (e a [[wikipedia:URN|URN]]) pode ser estendida para incorporar IDs inteligentes na resolução do servidor AFA, todos em escopo LADM: | ||
* <code><nowiki>geo:id_via:{ID}</nowiki></code> Resolve o identificador público de ''via'' (estrada, rua, etc.) | * <code><nowiki>geo:id_via:{ID}</nowiki></code> Resolve o identificador público de ''via'' (estrada, rua, etc.) | ||
| Linha 30: | Linha 40: | ||
* <code><nowiki>geo:id_water:{ID}</nowiki></code> Resolve o identificador público de ''corpo d'água'' (lago, rio, riacho, etc.) | * <code><nowiki>geo:id_water:{ID}</nowiki></code> Resolve o identificador público de ''corpo d'água'' (lago, rio, riacho, etc.) | ||
Nos ''URI templates'' o valor de ID é um AFAcode. Por exemplo <code><nowiki>geo:id_via:BR-SP-PIR-42BKG</nowiki></code> identifica uma estrada que contém o ponto [https://afa.codes/BR-SP-Piracicaba~42BKG8 geo:BR-SP-Piracicaba~42BKG8]. <br>Exceção é o PoA-contador, que faz uso internamente do [[Código_natural/Representação_interna#hCount|tipo <code>hCount56_8</code>]], que requer a representação diferenciada. São duas partes, a localização geográfica e o contador de 8 bits. Por exemplo o "endereço 5 do lote <code>BR-SP-Piracicaba~42B4Y</code>" será representado como <code>BR-SP-Piracicaba~42B4Y_5</code>. <br/>PS: PoA e PoI são equivalentes quando o PoA não faz uso de contador. | Nos ''URI templates'' acima o valor de ID é um AFAcode. Por exemplo <code><nowiki>geo:id_via:BR-SP-PIR-42BKG</nowiki></code> identifica uma estrada que contém o ponto [https://afa.codes/BR-SP-Piracicaba~42BKG8 geo:BR-SP-Piracicaba~42BKG8]. <br>Exceção é o PoA-contador, que faz uso internamente do [[Código_natural/Representação_interna#hCount|tipo <code>hCount56_8</code>]], que requer a representação diferenciada. São duas partes, a localização geográfica e o contador de 8 bits. Por exemplo o "endereço 5 do lote <code>BR-SP-Piracicaba~42B4Y</code>" será representado como <code>BR-SP-Piracicaba~42B4Y_5</code>. <br/>PS: PoA e PoI são equivalentes quando o PoA não faz uso de contador. | ||
Se a via sofrer um deslocamento de 5 metros para a direita, resultando em novo código 42BKGB, o identificador público 42BKG será mantido, mas um ''alias'' será gerado do 42BKG8 para o 42BKGB. | Se a via sofrer um deslocamento de 5 metros para a direita, resultando em novo código 42BKGB, o identificador público 42BKG será mantido, mas um ''alias'' será gerado do 42BKG8 para o 42BKGB. | ||
| Linha 39: | Linha 49: | ||
==ID de via== | ==ID de via== | ||
O ID de via pode ser apenas interno ao banco de dados | O ID de via pode ser público ou apenas interno ao banco de dados — para controle de segmentos sem compromisso com o controle OSM. | ||
No caso de '''vias rurais''', entretanto, é importante que seja legível ao humano, pois vias carecem de identificação pública consensual. Seria uma forma "oficial temporária" para se identificar as vias em seu contexto". | No caso de '''vias rurais''', entretanto, é importante que seja legível ao humano, pois vias carecem de identificação pública consensual. Seria uma forma "oficial temporária" para se identificar as vias em seu contexto". | ||