A par com os resultados do Código Postal, exemplo

A) https://geoptapi.org/cp/1950-446

B) https://geoptapi.org/cp/1950-449

dar também dados latitude e longitude, tal pode ser obtido com o open street maps, mais precisamente com o argumento q, visto que os códigos postais do open street maps estão desatualizados

A) https://nominatim.openstreetmap.org/search?country=portugal&q=rua+armandinho,lisboa&format=json&addressdetails=1

B) https://nominatim.openstreetmap.org/search?country=portugal&q=Rua%20Fernando%20Maur%C3%ADcio%2030,lisboa&format=json&addressdetails=1

Mudar os caminhos para

/municipios

/municipios/{municipio}

/municipios/{municipio}/freguesias

/freguesias/{freguesia}

https://restfulapi.net/resource-naming/

Em alguns casos o polígono à volta dos pontos de um código postal tem um ajuste bastante bom:

| https://geoapi.pt/cp/1000 | https://geoapi.pt/cp/4000 | |-|-| | | |

Há casos em que alguns pontos ficam fora do polígono, mas não de forma preocupante para uma aproximação:

| https://geoapi.pt/cp/3000 | https://geoapi.pt/cp/6000 |-|-| | | |

No entanto, há casos em que a proporção de pontos fora do polígono é considerável, gerando áreas claramente incorretas como indicação da cobertura geográfica do código postal:

| https://geoapi.pt/cp/2000 | https://geoapi.pt/cp/5000 | |-|-| | | |

Não sei se esta situação corresponde ao https://github.com/jfoclpf/outliers2d/issues/1, mas achei melhor reportar de qualquer forma.

Já agora, será que ficaria melhor se o polígono não fosse suavizado? Ou isto é o resultado da remoção de outliers e não da suavização do polígono?

Viva,

Após ter analisado a API não encontrei forma de o fazer, mas acho que seria interessante por exemplo nas localidadidas arranjar forma de obter as mesmas referenciando a freguesia.

Por exemplo com este pedido:

https://geoapi.pt/freguesia/Cuba?json=1

Obtemos diversos dados, e seria interessante tendo em conta o código postal, ou até mesmo o codigoine referenciar as localidades, visto que as mesmas já têm a "Designação Postal", no entanto para algumas freguesias não é possivel pesquisar através deste campo pois trata-se de uniões.

Não daria para fazer com que neste pedido https://geoapi.pt/cp/2495 as localidades estivessem associadas diretamente à freguesia con um código ou algo.

@waldyrious e @joao

Neste momento a API retorna JSON quando

• tem o parâmetro GET json=1, ex: /municipios/évora?json=1
• o pedido tem no cabeçalho HTTP Accept: application/json

Estava a pensar também adicionalmente um host json.geoapi.pt, ex: https://json.geoapi.pt/gps/40.153687,-8.514602

Que vos parece a ideia?

@jfoclpf, estive um bocado desligado no último mês e estava agora a acompanhar os issues em que sou mencionado.

Está a dar-me um erro de Too many requests, please try again later., quando tendo aceder a qualquer página no geoapi.pt. Tenho consciencia que existe um limite de 100 pedidos por 15 minutos, mas no máximo terei visitado 10 páginas/endpoints.

Será que o limite também está a ser aplicado a assets que sejam pedidos, ao retornar uma página e não somente a visitas de um determinado URL?

Adicionalmente, talvez fosse melhor excluir a homepage dos limites, ou pelo menos aumentar para as páginas estáticas, de modo a que um utilizador que não esteja consciente do limite de 100 pedidos encontrar a documentação em que tal é mencionado:

Devemos também apresentar um documento openapi.json para o OpenAPI https://oai.github.io/Documentation/

The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs, which allows both humans and computers to discover and understand the capabilities of a service without requiring access to source code, additional documentation, or inspection of network traffic. When properly defined via OpenAPI, a consumer can understand and interact with the remote service with a minimal amount of implementation logic. Similar to what interface descriptions have done for lower-level programming, the OpenAPI Specification removes guesswork in calling a service.

Ou seja, o OpenApi é apenas um "mapa" da API, não colocar qualquer restrição

Externalizar essa tarefa para o Open Street Maps (nominatim) Esta repo usa o got para pedidos http

got(`https://nominatim.openstreetmap.org/reverse?lat=${lat}&lon=${lon}&format=json`, 
  { headers: { Referer: `${req.get('origin') || defaultOrigin}/gps/${lat},${lon}` }})
  .json()
  .then(res => {
    console.log(res)
})

Excelente webAPI e iniciativa! Sugeria apenas retornar também o código dicofre pois é o identificador único de uma Freguesia. Esta informação vem na CAOP e permite fazer a comparação com outros dados, de outras aplicações, não por uma string mas por um valor inteiro inequívoco. Obrigado pela geoptapi!

Criar um route /distrito

• apenas /distrito lista os distritos
• /distrito/municipios lista árvore de distritos com municípios
• /distrito/municipios/freguesias lista árvore de distritos com municípios com freguesias

@pinanunes @joao

depois de 39 horas a correr o script, finalmente consegui gerar os ficheiros que aglomeram todas as moradas (pontos) do ficheiro OpenAddresses por distrito/município/freguesia/secção/subsecção

Está tudo aqui: https://github.com/jfoclpf/geoapi.pt/tree/main/res/admins-addresses

Tal vai permitir fazer geocodificação reversa (coodenadas GPS => Código postal e morada) pois o distrito/município/freguesia/secção/subsecção já está a ser detectado rapidamente, e só temos que procurar o ponto/morada mais perto dentro desse ficheiro distrito/município/freguesia/secção/subsecção.json

@pinanunes @joao @waldyrious devemos simplesmente apresentar o ponto mais próximo? Ou devemos dar uma margem máxima? Tipo 50 metros? Ou seja, se nenhum ponto estiver num raio de 50 metros, não devolvemos nada. Qual o valor para o limbo?

Originally posted by @jfoclpf in https://github.com/jfoclpf/geoapi.pt/issues/44#issuecomment-1328029033

Não se se é suposto poder-se ver alguma informação quando se clica nas bolinhas vermelhas que representam instâncias individuais de códigos postais, mas elas são de momento clicáveis e mostram um popup, só que o conteúdo é vazio ou "undefined". Por exemplo:

https://geoapi.pt/cp/4960 👇️

https://geoapi.pt/cp/4960-110 👇️

Para que esta API seja uma RESTful API, a resposta será HAL, neste caso HAL+JSON

{
  "nome": "Porto",
  "descrição": "Lista de freguesias do município do Porto",
  "_links": {
    "self": { "href": "/municipios/porto/freguesias" },
    "up": { "href": "/municipios/porto" },
    "freguesias": [
      {
        "nome": "Bonfim",
        "href": "/municipios/porto/freguesias/bonfim",
        "_links": { "self": { "href": "/municipios/porto/freguesias/bonfim" } }
      },
      {
        "nome": "Campanhã",
        "href": "/municipios/porto/freguesias/campanhã",
        "_links": { "self": { "href": "/municipios/porto/freguesias/campanhã" } }
      }
    ]
  },
  "freguesias": [
    "Bonfim",
    "Campanhã",
    "Paranhos",
    "Ramalde",
    "União das freguesias de Aldoar, Foz do Douro e Nevogilde",
    "União das freguesias de Cedofeita, Santo Ildefonso, Sé, Miragaia, São Nicolau e Vitória",
    "União das freguesias de Lordelo do Ouro e Massarelos"
  ]
}

Também passa a validação e é mais fácil de ler.

Originally posted by @jfoclpf in https://github.com/jfoclpf/geoapi.pt/issues/42#issuecomment-1282524514

Mais info em : https://stateless.group/hal_specification.html

Testar JSON Schema: https://jsonschema.dev/

HAL+JSON schema: https://github.com/evently-cloud/hal-json-schema/blob/main/hal.json

Os dados dos census do INE: http://mapas.ine.pt/download/index2011.phtml (Assumindo que os podes redistribuir). O desafio pode ser a agregação das sub-secçōes estatísticas aos códigos postais (se quiseres integrar os dois, o que seria interessante).

from: https://www.reddit.com/r/devpt/comments/xvgqdb/comment/ir1a86w/?utm_source=share&utm_medium=web2x&context=3

@waldyrious sugeriu

Seria possível fazer highlight das ruas que condizem com o nome dos pontos? Por exemplo, em https://geoapi.pt/cp/4710-057 ver-se uma linha como esta: https://www.openstreetmap.org/way/317809018 talvez seja preciso fazer uma normalização + fuzzy match, porque os nomes não são equivalências exatas — neste caso os pontos têm a designação "R UNIVERSIDADE" e no OSM está "Rua da Universidade".

Por vezes, não é possível determinar distrito/concelho/freguesia porque a coordenada está sobre o mar, mas apenas a alguns metros da linha costeira. Não seria possível implementar uma opção que, quando a coordenada cai fora por uma pequena margem (algumas dezenas de metros, por exemplo) devolvesse a freguesia mais próxima?

Obrigado