Documentação AFA.codes: mudanças entre as edições

De Documentação
mSem resumo de edição
m (destaque de DNGS vs AFA)
 
(56 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 1: Linha 1:
[[Arquivo:OSMcodes-logo.png|miniaturadaimagem|Logotipo provisório do Projeto OSMcodes.]]
[[Arquivo:OSMcodes-logo.png|320px|miniaturadaimagem|Logotipo ''AFA.codes'' (antigo ''OSM.codes''), serviço que implementa o padrão DNGS.]]


<big><b>Documentação OSMcodes</b></big>
O '''AFA.codes''' (anteriormente OSMcodes) é um [[Projetos|projeto]] do [[Instituto AddressForAll]] com o objetivo de implementar e aperfeiçoar  o sistema de geocodificação do padrão [[Discrete National Grid Systems/pt|Discrete National Grid Systems - '''DNGS''']]. AFAcodes buscam o máximo de qualidade: o máximo compactos, amigáveis, multifinalitários, computacionalmente eficientes.
* [[OSMC/Sobre]]: descreve o projeto, seus produtos e serviços
* '''Repositórios''' em https://git.osm-codes
* '''Interface rascunho''' em https://osm.codes


==Códigos-fonte==
Principais recursos:
Módulos de baixo acoplamento:
* '''Página inicial - seleção de localidade''' em [http://afa.codes http://afa.codes]
{| class="wikitable"
* '''Interface''' (exemplo em BR-SP-Campinas) em [http://afa.codes/BR-SP-Campinas http://afa.codes/BR-SP-Campinas]
|+
* '''Repositórios''' em https://git.afa.codes &nbsp; (ver também [https://api.github.com/orgs/osm-codes/repos API list], [https://github.com/osm-codes/gridMap-draftPages/issues Issues] e [https://github.com/osm-codes/gridMap-draftPages/releases Versão])
!URL
* '''Separação''' dos assuntos: padrão DNGS (público) ''vs'' implementação AFA do padrão (potencialmente privado).
!Tipo
!Descrição
!Status
|-
|https://git.osm-codes/NaturalCodes
|Lib
|Funções básicas de encode/decode hierárquicas, fundamento [[Natural Codes]]
|produtivo
|-
|https://git.osm-codes/gridMap-draftPages
|Site
|Grid Map em tecnologia obsoleta (rascunho de interface) LeafLet.
|produtivo
|-
|https://git.osm-codes/GGeohash
|Lib
|
|produtivo
|-
|https://git.osm-codes/WS
|API
|Web Service, infraestrutura das APIs
|produtivo
|-
|https://git.osm-codes/CO_new
|Conf
|Algoritmos e configurações adotadas pela Colômbia. Pendente merge em CO
|produtivo
|-
|https://git.osm-codes/BR_new
|Conf
|Algoritmos e configurações adotadas pelo Brasil. Pendente merge em BR
|produtivo
|-
|https://git.osm-codes/BR_IBGE
|Lib
|Grade Estatística do IBGE, independente.
|produtivo
|}
==OSMcodes implementados==
Idenpendente do domínio <code>OSM.codes</code>
*[[OSMC/BR]] - Brasil
*[[OSMC/CO]] - Colômbia


==Outras funções implementadas no domínio==
__TOC__
Ver [[OSMC/Sobre#Outras funções do site]].
 
==Seções==
 
Principais seções de documentação nesta wiki:
 
*{{ns-xref|osmc|Metodologia}}: descreve para leigos o que fazemos
*{{ns-xref|osmc|Sobre}}: descreve o projeto, seus produtos e serviços.
*{{ns-xref|osmc|Convenções}}: estabelece convenções e metodologias deste projeto.
*{{ns-xref|osmc|Casos de uso}}: descreve e classifica as diversas aplicações e formas de utilização da solução.
*{{ns-xref|osmc|FAQ}}: Perguntas frequentes.
*{{ns-xref|osmc|Gits}}: repositórios git contendo códigos-fonte.
*{{ns-xref|osmc|Testes}}: roteiro e execução de testes das páginas de consulta <code>AFA.codes</code>.
*{{ns-xref|osmc|Viz}}: módulo de visualização dos dados e interface de comandos.
**[[osmc:Viz/Navegação|osmc:Viz/'''Navegação''']]: manual de referência sobre a interface de navegação por mapas e geocódigos.
*{{ns-xref|osmc|Guias}}: guias rápidos, de uso e instalação.
*{{ns-xref|osmc|Atribuições}}: créditos, licenças e demais informes de atribuição.
*{{ns-xref|osmc|Versões}}: versões dos softwares utilizados em produção.
*Países com <code>AFA.codes</code> implementados, independentemente do domínio:
**{{ns-xref|osmc|BR}} - Brasil;
**{{ns-xref|osmc|CO}} - Colômbia.
**{{ns-xref|osmc|CM}} - Camarões.
**{{ns-xref|osmc|EC}} - Equador.
**{{ns-xref|osmc|UY}} - Uruguai.
 
*Outras funções implementadas no domínio:
**Ver [[osmc:Sobre#Outras funções do site]].
 
== Principais pontos ==
 
* O AFA.codes é um sistema de geocodificação em que, para cada retângulo do território nacional, desde 1 km² até 1 m², recebe um código alfanumérico o mais curto possível, gerado a partir das coordenadas geográficas.
* Pode geolocalizar por código qualquer elemento fixo no território, como cidades, bairros, povoados, fazendas, glebas, casas, vagas de veículos, árvores, postes, mobiliário urbano, etc.
* O sistema respeita a soberania de cada país. É feito sob medida, considerando a estrutura territorial de estados e municípios.
* O AFA.codes uma vez adotado no país, 100% do seu território é coberto com geocódigos gerados pelo sistema.
* O sistema é reversível: a coordenada geográfica é convertida para um código curto, como também este código pode ser revertido para a coordenada geográfica que o originou.
* O código pode ser utilizado como número de cadastro, visto que o mesmo código não se repete no mesmo município.
* Localidades que carecem de endereço e CEP como sítios, assentamentos e moradias na zona rural, aglomerações subnormais, matas e sertões recebem um geocódigo que pode tanto localizar como identificar o objeto. Mesmo o local mais remoto e inacessível é geocodificável.
* O AFA.codes é desenvolvido pelo Instituto de Tecnologias Geo-Sociais AddressForAll como uma solução inovadora de tecnologia aberta. Não prende instituições e usuários à desenvolvedora da tecnologia.
 
== Origem do nome ==
A sigla AFA vem das iniciais do nome do Instituto '''A'''ddress'''F'''or'''A'''ll, e adota-se um ponto entre esta sigla e a palavra "codes" por uma questão de estratégia de comunicação para tornar conhecido tanto o nome quanto o endereço do website.
 
Substitui o nome antigo OSMcodes para evitar conflito com OpenStreetMap. A princípio, o nome anterior veio do fato de o projeto ter sido baseado no mapa [[OpenStreetMap]] e com intensão de divulgá-lo.
 
==Ver também==
 
*[[Geohash generalizado]]
 
[[Categoria:Projetos|OSMcodes]]
[[Categoria:OSMcodes|*Documentação_OSMcodes]]

Edição atual tal como às 13h08min de 30 de junho de 2024

Logotipo AFA.codes (antigo OSM.codes), serviço que implementa o padrão DNGS.

O AFA.codes (anteriormente OSMcodes) é um projeto do Instituto AddressForAll com o objetivo de implementar e aperfeiçoar o sistema de geocodificação do padrão Discrete National Grid Systems - DNGS. AFAcodes buscam o máximo de qualidade: o máximo compactos, amigáveis, multifinalitários, computacionalmente eficientes.

Principais recursos:

Seções

Principais seções de documentação nesta wiki:

  • osmc:Metodologia: descreve para leigos o que fazemos
  • osmc:Sobre: descreve o projeto, seus produtos e serviços.
  • osmc:Convenções: estabelece convenções e metodologias deste projeto.
  • osmc:Casos de uso: descreve e classifica as diversas aplicações e formas de utilização da solução.
  • osmc:FAQ: Perguntas frequentes.
  • osmc:Gits: repositórios git contendo códigos-fonte.
  • osmc:Testes: roteiro e execução de testes das páginas de consulta AFA.codes.
  • osmc:Viz: módulo de visualização dos dados e interface de comandos.
    • osmc:Viz/Navegação: manual de referência sobre a interface de navegação por mapas e geocódigos.
  • osmc:Guias: guias rápidos, de uso e instalação.
  • osmc:Atribuições: créditos, licenças e demais informes de atribuição.
  • osmc:Versões: versões dos softwares utilizados em produção.
  • Países com AFA.codes implementados, independentemente do domínio:

Principais pontos

  • O AFA.codes é um sistema de geocodificação em que, para cada retângulo do território nacional, desde 1 km² até 1 m², recebe um código alfanumérico o mais curto possível, gerado a partir das coordenadas geográficas.
  • Pode geolocalizar por código qualquer elemento fixo no território, como cidades, bairros, povoados, fazendas, glebas, casas, vagas de veículos, árvores, postes, mobiliário urbano, etc.
  • O sistema respeita a soberania de cada país. É feito sob medida, considerando a estrutura territorial de estados e municípios.
  • O AFA.codes uma vez adotado no país, 100% do seu território é coberto com geocódigos gerados pelo sistema.
  • O sistema é reversível: a coordenada geográfica é convertida para um código curto, como também este código pode ser revertido para a coordenada geográfica que o originou.
  • O código pode ser utilizado como número de cadastro, visto que o mesmo código não se repete no mesmo município.
  • Localidades que carecem de endereço e CEP como sítios, assentamentos e moradias na zona rural, aglomerações subnormais, matas e sertões recebem um geocódigo que pode tanto localizar como identificar o objeto. Mesmo o local mais remoto e inacessível é geocodificável.
  • O AFA.codes é desenvolvido pelo Instituto de Tecnologias Geo-Sociais AddressForAll como uma solução inovadora de tecnologia aberta. Não prende instituições e usuários à desenvolvedora da tecnologia.

Origem do nome

A sigla AFA vem das iniciais do nome do Instituto AddressForAll, e adota-se um ponto entre esta sigla e a palavra "codes" por uma questão de estratégia de comunicação para tornar conhecido tanto o nome quanto o endereço do website.

Substitui o nome antigo OSMcodes para evitar conflito com OpenStreetMap. A princípio, o nome anterior veio do fato de o projeto ter sido baseado no mapa OpenStreetMap e com intensão de divulgá-lo.

Ver também

Disponível em “https://wiki.addressforall.org/w/index.php?title=Documentação_AFA.codes&oldid=4158”