DNGS/Arquitetura e modularização

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

...