You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: workshop/content/docs/introduction.pt.md
+51-23Lines changed: 51 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,44 +6,72 @@ title: Introdução à pygeoapi
6
6
7
7
A equipa de desenvolvimento da pygeoapi (sim, em minúsculas) tem o prazer de lhe dar as boas-vindas a esta workshop!
8
8
9
-
Nesta workshop de meio dia, faremos uma introdução à pygeoapi, explicaremos como publicar dados e forneceremos recursos e dicas para leitura e referência futuras (ou seja, para onde ir quando não souber!).
9
+
Nesta workshop de meio dia[^1], fazemos uma introdução à pygeoapi, e à publicação de dados geoespaciais, fornecendo
10
+
também recursos e dicas para leitura e referência futuras (ou seja, para onde ir quando não souber!).
10
11
11
-
Embora a pygeoapi seja escrita em Python e possa ser personalizada e extensível (plugins) por programadores de Python, não são necessários conhecimentos de Python para instalar, configurar e publicar os seus dados geoespaciais como parte desta workshop. Tudo o que precisa para a workshop é o seu editor de texto favorito e o Docker (forneceremos mais informações na [secção de configuração](setup.md)).
12
+
[^1]: A sessão apresentada na [FSL 2025](https://festa2025.softwarelivre.eu/) é uma sessão simplificada de 2h30m.
13
+
14
+
Embora a pygeoapi seja escrita em Python e seja personalizável e extensível (através de _plugins_) por
15
+
programadores de Python, não são necessários conhecimentos de Python para instalar, configurar e publicar os seus
16
+
dados geoespaciais como parte desta workshop. Tudo o que precisa para a workshop é o seu editor de texto favorito
17
+
e o Docker (forneceremos mais informações na [secção de configuração](setup.md)).
12
18
13
19
## Leitura de base
14
20
15
-
O [website](https://pygeoapi.io) da pygeoapi é o ponto de entrada principal para utilizadores finais e programadores, onde pode encontrar:
21
+
O [website](https://pygeoapi.io) da pygeoapi é o ponto de entrada principal para utilizadores finais e programadores.
22
+
Aí pode encontrar:
23
+
24
+
*[Documentação oficial](https://docs.pygeoapi.io)
25
+
* Várias [apresentações do projeto](https://pygeoapi.io/presentations)
26
+
* P código-fonte no [GitHub](https://github.com/geopython/pygeoapi)
27
+
* As imagens Docker [disponíveis no Docker Hub](https://hub.docker.com/r/geopython/pygeoapi)
28
+
* As versões da pygeoapi no [Python Package Index (PyPI)](https://pypi.org/project/pygeoapi)
29
+
* Dado que a pygeoapi implementa uma série de normas OGC API, também poderá querer ler sobre estas
30
+
em [ogcapi.ogc.org](https://ogcapi.ogc.org).
16
31
17
-
*[documentação oficial](https://docs.pygeoapi.io)
18
-
* as apresentações [padrão](https://pygeoapi.io/presentations/default) e as [mais recentes](https://pygeoapi.io/presentations/foss4g2023)
19
-
* o [arquivo de documentação e apresentações](https://pygeoapi.io/documentation)
20
-
* o código no [GitHub](https://github.com/geopython/pygeoapi)
21
-
* as imagens Docker [disponíveis no Docker Hub](https://hub.docker.com/r/geopython/pygeoapi)
22
-
* as versões da pygeoapi no [Python Package Index (PyPI)](https://pypi.org/project/pygeoapi)
32
+
## Instalações de referência
23
33
24
-
Dado que a pygeoapi implementa uma série de normas OGC API, também poderá querer ler sobre estas em [ogcapi.ogc.org](https://ogcapi.ogc.org).
34
+
Várias organizações implementaram a pygeoapi nas suas operações. Para ter uma ideia de como a pygeoapi é usada na
O projeto pygeoapi também mantém uma instalação de demonstração, disponível em:
27
39
28
-
Várias organizações implementaram a pygeoapi nas suas operações. Para ter uma ideia de como a pygeoapi é usada na prática, consulte a nossa página atualizada de [implementações ativas](https://github.com/geopython/pygeoapi/wiki/LiveDeployments). Por defeito, a demonstração pública da pygeoapi em [demo.pygeoapi.io](https://demo.pygeoapi.io) é sempre mantida e disponibilizada pela equipa de desenvolvimento. Consulte a [instância principal](https://demo.pygeoapi.io/master), que executa sempre a versão mais recente do GitHub.
40
+
<https://demo.pygeoapi.io>
29
41
30
-
Interessado na configuração do próprio site de demonstração? O [demo.pygeoapi.io](https://demo.pygeoapi.io) é desenvolvido num [repositório GitHub](https://github.com/geopython/demo.pygeoapi.io) utilizando um fluxo de trabalho de implementação contínua (CD) DevOps.
31
-
Implementações GitOps ainda mais recentes foram desenvolvidas para a [Geonovum](https://github.com/Geonovum/ogc-api-testbed) e para o [Centro Comum de Investigação da Comissão Europeia](https://github.com/justb4/ogc-api-jrc).
42
+
Esta instalação é operada pela equipa de desenvolvimento. Consulte a
43
+
[instância principal](https://demo.pygeoapi.io/master), que executa sempre a versão mais recente do GitHub.
32
44
33
-
Os exemplos acima podem servir como ponto de partida para a sua própria configuração e implementação da pygeoapi, por isso, sinta-se à vontade para os estudar e utilizar!
45
+
Interessado na configuração do próprio site de demonstração? O [demo.pygeoapi.io](https://demo.pygeoapi.io) é
46
+
desenvolvido num [repositório GitHub](https://github.com/geopython/demo.pygeoapi.io) utilizando um fluxo de trabalho
47
+
de disponibilização contínua (CD). Implementações GitOps ainda mais recentes foram desenvolvidas para
48
+
a [Geonovum](https://github.com/Geonovum/ogc-api-testbed) e para o [Centro Comum de Investigação da Comissão Europeia](https://github.com/justb4/ogc-api-jrc).
49
+
50
+
Os exemplos acima podem servir como ponto de partida para a sua própria configuração e implementação da pygeoapi,
51
+
por isso, sinta-se à vontade para os estudar e utilizar!
34
52
35
53
## História
36
54
37
-
Iniciada em 2018, a pygeoapi surgiu como parte dos esforços iniciais para o desenvolvimento das normas OGC API. As *code sprints* da OGC API foram fundamentais para o desenvolvimento ágil e para lançar as bases do projeto.
55
+
Iniciada em 2018, a pygeoapi surgiu como parte dos esforços iniciais para o desenvolvimento das normas OGC API.
56
+
As *code sprints* da OGC API foram fundamentais para o desenvolvimento ágil e para lançar as bases do projeto.
38
57
39
58
Os princípios centrais de design são os seguintes:
40
59
41
-
* simplicidade / baixa barreira de entrada
42
-
* sustentabilidade a longo prazo
43
-
* modularidade
44
-
* extensibilidade
45
-
* construção sobre um vasto ecossistema de componentes de Código Aberto Livre e da OSGeo, como GDAL, rasterio, Shapely, Pandas, Elasticsearch, PostGIS e muitos outros
60
+
* Simplicidade / baixa barreira de entrada
61
+
* Sustentabilidade a longo prazo
62
+
* Modularidade
63
+
* Extensibilidade
64
+
* Construção sobre um vasto ecossistema de componentes de Código Aberto e da OSGeo, como GDAL, rasterio, Shapely,
65
+
Pandas, Elasticsearch, PostGIS e muitos outros
66
+
67
+
O projeto foi iniciado por [Tom Kralidis](https://github.com/tomkralidis). Em poucas semanas, vários programadores
68
+
talentosos juntaram-se ao projeto, o que levou à formação de uma equipa principal e de
69
+
um [Comité de Direção do Projeto (PSC)](https://pygeoapi.io/community/psc). As contribuições continuaram também por
70
+
parte de outros programadores e utilizadores que, de bom grado, forneceram novas funcionalidades, correções de erros
71
+
e atualizações da documentação. Como resultado, rapidamente emergiu uma comunidade saudável com um interesse comum
72
+
em código aberto, normas OGC API, baixa barreira de entrada, modularidade e extensibilidade. O resto, como se
73
+
costuma dizer, é história.
46
74
47
-
O projeto foi iniciado por [Tom Kralidis](https://github.com/tomkralidis). Em poucas semanas, vários programadores talentosos juntaram-se ao projeto, o que levou à formação de uma equipa principal e de um [Comité de Direção do Projeto (PSC)](https://pygeoapi.io/community/psc). As contribuições continuaram também por parte de outros programadores e utilizadores que, de bom grado, forneceram novas funcionalidades, correções de erros e atualizações da documentação. Como resultado, rapidamente emergiu uma comunidade saudável com um interesse comum em código aberto, normas OGC API, baixa barreira de entrada, modularidade e extensibilidade. O resto, como se costuma dizer, é história.
75
+
Em Fevereiro de 2024 foi realizado o primeiro encontro de desenvolvedores da pygeoapi, em Évora
48
76
49
-
A pygeoapi é um [Projeto da OSGeo](https://www.osgeo.org/projects/pygeoapi) e uma Implementação de Referência da OGC.
77
+
A pygeoapi é um [Projeto da OSGeo](https://www.osgeo.org/projects/pygeoapi) e uma Implementação de Referência da OGC.
0 commit comments