DNGS/Arquitetura e modularização: mudanças entre as edições

Edição atual tal como às 06h21min de 10 de setembro de 2024

O mosaico global DNGS é formado por células quadriláteras de igual-área, começando pela grade de 1 metro quadrado, mas é um conjunto de grades nacionais independentes. Cada país faz suas próprias escolhas e tem suas próprias fronteiras, para criar sua "instância de grade DNGS".

O diagrama de árvores centradas em "DNGS grids" conecta os principais módulos de software e configuração, destacando "Metagrid", "Library" e "Instance implementation", expressas como seções da documentação a seguir.

Metagrid

Metadados e métodos-fábrica utilizados para a construção de novas grades nacionais. Não existe ainda um software de automação da construção, mas a padronização garante suficientes simplicidade dos parâmetros e reuso de métodos.

A Metagrid são os parâmetros de grade fixados através de decisões soberanas e válidos por 20 anos, não podendo ser mais alterados depois da oficialização da grade (depois que uma ou mais jurisdições fixarem oficialmente os seus geocódigos). Pode-se eventualmente ativar e acrescentar células de reserva da grade nacional e/ou de grades logísticas municipais. Exemplos de registro Metagrid já em processo de oficialização:

Camarões: git.AFA.codes/CM, ...
Brasil: git.AFA.codes/BR_new, ...
Colômbia: git.AFA.codes/CO_new, ...

Identificador global

A independência entre grades nacionais não afeta a interoperabilidade proposta pelo padrão DNGS. A "cola" da interoperabilidade é o identificador de célula, tanto na sua representação interna como na sua representação textual:

Identificador binário: base para as demais formas de representação. Dá a liberdade do país adotar uma ou outra variante, a hidden-bit ou a cache-length. Abaixo trataremos dos bits 57 bits comuns, independentes da alternativa.
Representação textual em notação científica: apenas o prefixo é controlado, ISO country code.
Representação textual em notação logística: prefixo ISO Label Extended.

Library

A biblioteca de software AFAcodes foi construída para satisfazer o padrão DNGS e oferecer alta performance, independente das escolhas particulares feitas por cada país.

Ver osmc:Metodologia/Algoritmo SQL, foi modularizado em:

Lib GGeohash: ver conceitos em GGeohash e implementação em git.afa.codes/GGeohash.
Lib NatCod: ver conceitos em Código Natural e implementação em git.afa.codes/NaturalCodes.
Lib Grid, com instâncias por país (grid_br, grid_cm, grid_cm etc.)

API spec

A Library e o padrão DNGS (reaproveitando API DGGS) também preveem exposição das funcionalidades através de APIs REST.

...

Instance implementation

...

Lib do país

Principalmente instâncias de Lib Grid por país (grid_br, grid_cm, grid_cm etc.) e API global com redirecionamento consiste com a sintaxe de código do país no prefixo.

...

API do país

...

@@ Linha 2: / Linha 2: @@
 O diagrama de árvores centradas em "DNGS grids" conecta os principais módulos de software e configuração, destacando  "Metagrid", "Library" e "Instance implementation", expressas como seções da documentação a seguir.
-[[Arquivo:Mindmap01-DNGS grids.png|centro|semmoldura|680px]]
+[[Arquivo:Mindmap01-DNGS grids.png|centro|semmoldura|720px]]
-<!-- MERMAID https://mermaid.live/edit
-mindmap
-  root((DNGS grids))
-    Metagrid
-      Configurations
-      ::icon(fa fa-book)
-      Decisions
-        Territory
-        Official <br/>standards
-        Culture
-      Research and tests
-    Country instance<br/>implementation
-      Scientific Grid
-      Jurisdiction <br/>Cover config
-      ::icon(fa fa-book)
-      Logistic Grid
-      GridGen module
-      Encode/Decode module
-      Final use <br/>and databases
-        Address <br/>grid-database
-        Land lot <br/>grid-database
-        Etc.
-    Library
-    ::icon(fa fa-book)
-      GGeohash
-      NatCode
-      PostGIS
-      GridGen
--->
 == Metagrid ==
 Metadados e métodos-fábrica utilizados para a construção de novas grades nacionais. Não existe ainda um software de automação da construção, mas a padronização garante suficientes simplicidade dos parâmetros e reuso de métodos.
@@ Linha 40: / Linha 11: @@
 * Brasil: [https://git.AFA.codes/BR_new git.AFA.codes/BR_new], ...
 * Colômbia: [https://git.AFA.codes/CO_new git.AFA.codes/CO_new], ...
+=== Identificador global  ===
+A independência entre grades nacionais não afeta a interoperabilidade proposta pelo padrão DNGS. A "cola" da interoperabilidade é o identificador de célula, tanto na sua representação interna como na sua representação textual:
+* Identificador binário: base para as demais formas de representação. Dá a liberdade do país adotar uma ou outra variante, a hidden-bit ou a cache-length. Abaixo trataremos dos bits 57 bits comuns, independentes da alternativa.
+* Representação textual em notação científica: apenas o prefixo é controlado, ISO country code.
+* Representação textual em notação logística: prefixo [[ISO Label Extended]].
 == Library ==
@@ Linha 46: / Linha 24: @@
 Ver [[osmc:Metodologia/Algoritmo SQL]], foi modularizado em:
 * Lib GGeohash:  ver conceitos em [[GGeohash]] e implementação em [https://git.afa.codes/GGeohash git.afa.codes/GGeohash].
-* Lib NatCod: ver conceitos em [[Natural codes]] e implementação em [https://git.afa.codes/NaturalCodes git.afa.codes/NaturalCodes].
+* Lib NatCod: ver conceitos em [[Código Natural]] e implementação em [https://git.afa.codes/NaturalCodes git.afa.codes/NaturalCodes].
 * Lib Grid, com instâncias por país (grid_br, grid_cm, grid_cm etc.)
-=== API ===
+== API spec ==
-A biblioteca AFAcodes e o padrão DNGS também preveem exposição das funcionalidades através de APIs REST.
+A Library e o padrão DNGS (reaproveitando [https://docs.ogc.org/DRAFTS/21-038.html API DGGS]) também preveem exposição das funcionalidades através de APIs REST.
 ...
 == Instance implementation ==
+...
+=== Lib do país ===
+Principalmente instâncias de Lib Grid por país (grid_br, grid_cm, grid_cm etc.) e API global com redirecionamento consiste com a sintaxe de código do país no prefixo.
+...
+=== API do país ===
 ...