osmc:Api

Rascunho sobre APIs. Reúne definições dispersas em issues.

Subdomínio default: api.afa.codes
subdomínio teste: api.test.afa.codes

https://github.com/osm-codes/gridMap-draftPages/issues/82:
Codificação do CEP é definitiva, vale o hifem:
https://test.afa.codes/BR-49750~CMH
https://test.afa.codes/BR-49750-CMH

https://github.com/osm-codes/BR_new/issues/10:
Capital do pais (fica no nivel 2)
https://afa.codes/BR-DF-Brasilia~FRRS
https://afa.codes/BR-DF~FRRS
https://afa.codes/CO-DC~5ST5ZQD
Capital do estado (permite nivel 3 repetindo o nivel 2 com suas 2 letras)
https://afa.codes/BR-SP-SaoPaulo~FRRS
https://afa.codes/BR-SP-SP~FRRS
https://afa.codes/BR-SP-SP~MCGBM7

https://github.com/osm-codes/gridMap-draftPages/issues/69
RegistroBR: 
Os domínios municipais do Brasil registrados com mais de duas letras podem se tornar redirecionadores:

    Sem ambiguidade quando usados os três níveis;


    Algumas ambiguidades quando usado BR-dominio;
    9guacu exigiu mudanças no nginx;
    54 cidades com dominio

https://osm.codes/BR-Sampa~MCGBM7
https://osm.codes/BR-SP-Sampa~MCGBM7


-------------------
https://github.com/osm-codes/CO_new/issues/17

Quanto ao so do hifem , "-", no lugar de "~", atualmente podemos referenciar cidades através do nome, por exemplo CO-RIS-Dosquebradas-15NTJ ou através de DIVIPOLA (jurisd_local_id), CO-66170-15NTJ, e ambos retornam o canônico (com "~").

Quanto à URL e representações canônicas, sim, sempre com o ~ separando, mas os usuários preferem usar - de modo que não é exigido como formato de input, apenas formatação output canônica.


CO-A-Itagui = código Divipola
código Divipola = código Divipola
CO-A-Igi = código Divipola
CO-ANT-Igi = código Divipola

----------
de https://github.com/osm-codes/WS/issues/26:

Não sei se entendi,

    Dado inédito: aquele que ninguém tinha acesso público antes, mas com a publicação AddressForAll passou a ter. Tipicamente dados doados por e-mail (teve um só caso até hoje que fomos buscar um DVD).

    Dado não-inédito: o contrário de inédito. Em geral se a prefeitura oferece Download já deixa de ser inédito automaticamente... A questão é se foi antes ou depois da AddressForAll publicar. Pode conferir em archive.org

... Um dia todos deixam de ser inéditos, então nosso objetivo aqui é classificar como "inédito" tudo aquilo que no dia que fizemos a primeira publicação online (atualmente o /teste2) era comprovadamente inédito.

Apesar de muitos dados não serem inéditos, sempre bom lembrar dos diferenciais dos dados da AddressForAll, mesmo quando não são inéditos :

    Segurança Jurídica: publicamos todas as evidências (de dados e de licença) e garantimos as licenças indicas.
    Estabilidade: os dados são os mesmos por 20 anos, não se perdem, não se confundem e os mais atuais são diferenciáveis dos mais velhos, quando existe mais de uma versão do mesmo dado. Se você pagou IPTU ou registrou imóvel com relação ao cenário de uma certa data, esse cenário não é perdido.
    Padronização semântica: não precisa filtrar e analisar, já fizemos isso e oferecemos um padrão de dados estável.
    Curadoria: os conjuntos de dados que publicamos são prevaimente avaliados como consistentes e relevantes.


Dados publicados em https://addressforall.org/downloads/ com a tag `[unprecedented]` para indicar que são inéditos.