- Dados.Gov

Dados.gov
Tutorial – Obtenção de Dataset
Parceria:
www.ama.pt
Introdução
Este tutorial descreve o processo de navegação
no portal público www.dados.gov.pt para a
obtenção de um dataset ou de um subset de
um dataset nos vários formatos disponíveis
para utilização em aplicações que venham a
ser desenvolvidas.
Passo 1: Acesso à pagina inicial do site www.dados.gov.pt
Passo 2: Seleccionar a opção “Catálogo de Dados”
Passo 3: Pesquisar o portfólio de Datasets
Passo 4: Seleccionar o Dataset pretendido
Passo 5: Seleccionar a secção “Dados” no detalhe do Dataset
Passo 6: Obtenção de datasets e subsets de datasets
1
2
3
1 Área de filtro (query) sobre o dataset
2 Ligação de acesso ao dataset disponível na plataforma Dados.Gov
3 Área de download imediato do dataset nos formatos mais populares (XLSX, CSV e PDF)
Passo 6: Obtenção de datasets e subsets de datasets
Os datasets da plataforma Dados.Gov são disponibilizados através de serviços REST.
O formato básico de uma chamada a um serviço do Dados.GOV é
http://servico.dados.gov.pt/v1/container/dataset?query
onde:
1. container – é o identificador do fornecedor de dados (ex: gepe);
2. dataset – é o identificador do dataset (ex: Alunos20072008);
3. query – é o conjunto de parametros de filtro a aplicar ao dataset
(Expresso na sintaxe “WCF Data Services query syntax”)
Nota:
Presentemente a plataforma apenas suporta os filtros $filter
and $top da sintaxe “WCF Data Services query syntax”
(http://msdn.microsoft.com/en-us/library/dd728283.aspx)
Exemplo:
http://servico.dados.gov.pt/v1/gepe/Alunos20072008
Formato de obtenção de datasets e subsets de datasets
Por defeito os dados são obtidos no formato Open Data Protocol (Odata -http://www.odata.org), e podem
ser facilmente consumidos por várias plataformas, incluindo Microsoft .NET, Java, Javascript, Ruby, PHP,
Python, …
Formatos disponíveis
• AtomPub – formato por defeito (OData)
• JSON – Javascript Object Notation (http://en.wikipedia.org/wiki/JSON)
• KML – Keyhole Markup Language (http://en.wikipedia.org/wiki/Keyhole_Markup_Language)
• RDF/XML – Resource Description Framework (http://en.wikipedia.org/wiki/RDF/XML)
• JSONP – JSON with padding (http://en.wikipedia.org/wiki/JSONP)
Obter datasets nos vários formatos
Para obter um dataset em formatos alternativos ao formato por defeito, basta acrescentar ao URL do
dataset um parametro relativo ao formato desejado (ex: format=json). Dependendo da composição do URL
(simples ou já composto com outros parâmetros) o parâmetro terá de ser precedido por “?” ou “&”.
Exemplos:
URL Dataset: http://servico.dados.gov.pt/v1/gepe/Alunos20072008
Pârametro sobre URL Dataset simples: http://servico.dados.gov.pt/v1/gepe/Alunos20072008?format=json
Pârametro sobre URL Dataset composto (com outros parâmetros):
http://servico.dados.gov.pt/v1/gepe/Alunos20072008?$filter=total%20ge%204000%20and%20total%20le%205000 &format=json
Parâmetros para obtenção de diferentes formatos
Formato
Parâmetro
JSON
Pode ser utilizado, acrescentando o parâmetro format=json ao endereço
do serviço de obtenção do dataset.
format=json
KML
Este formato poderá ser utilizado caso os dados possuam colunas de
latitude e longitude expressas no formato
WGS84 (http://en.wikipedia.org/wiki/World_Geodetic_System). O
formato KML é compatível com Microsoft Bing Maps, Google Maps,
Yahoo! Maps e Google Earth. Pode ser utilizado acrescentando o
parâmetro format=kml ao endereço do serviço de obtenção do dataset.
format=kml
RDF/XML
Este formato poderá ser obtido acrescentando o parâmetro format=rdf
ao endereço do serviço de obtenção do dataset.
format=rdf
JSONP
Este formato poderá ser obtido acrescentando o parâmetro
format=json&callback=funcao_de_retorno ao endereço do serviço de
obtenção do dataset.
format=json&callback=
funcao_de_retorno
Listagens utilizando directamente o serviço de dados
Listagem de Fornecedores
É possível obter a listagem de fornecedores de dados disponíveis na plataforma em
formato AtomPub utilizando o serviço de dados através do endereço
http://servico.dados.gov.pt/v1.
Listagem de Datasets de um Fornecedor
É possível obter a listagem de datasets de um determinado fornecedor de dados
disponíveis na plataforma em formato AtomPub utilizando o serviço de dados através do
endereço http://servico.dados.gov.pt/v1/identificador_do _fornecedor_de_dados.
Exemplo: http://servico.dados.gov.pt/v1/gepe
Obtenção de subsets de datasets
Para facilitar a construção dos filtros a aplicar a um determinado dataset, na página de
detalhe de um dataset, no site público www.dados.gov.pt, é possível aplicar visualmente
os filtros desejados, verificar o resultado e utilizar o endereço para o serviço de dados
construído automaticamente para a aplicação dos filtros.
Dados.gov
Impulsionar a transparência e a reutilização da
informação do sector público
Mais Informação
AMA – Agência para a Modernização Administrativa
[email protected]
www.ama.pt