Mudanças entre as edições de "API-SEADE"

De SEADE
Ir para: navegação, pesquisa
Linha 8: Linha 8:
  
 
=== Recursos Disponíveis ===
 
=== Recursos Disponíveis ===
 +
 +
== Variável ==
 +
GET
 +
 +
Path: /variavel
 +
Parâmetros: código
 +
 +
=== Exemplo de chamada ===
 +
 +
curl -X GET "http://api-imp.seade.gov.br/consulta/5"
 +
 +
=== Retorno JSON ===
 +
 +
Exemplo:
 +
 +
{
 +
    "variavel": {
 +
        "codigo": "5",
 +
        "nome": "Área",
 +
        "unidade": "(Em km2)",
 +
        "fonte": "Instituto Brasileiro de Geografia e Estatística–IBGE.",
 +
        "nota": "A partir de agosto de 2008, os dados referentes à área dos municípios paulistas (e das regiões administrativas, de governo e metropolitanas, calculados pela soma das áreas municipais), divulgados nos sistemas de informação da Fundação Seade, têm como fonte a Resolução nº 5, do Instituto Brasileiro de Geografia e Estatística – IBGE, de 10 de outubro de 2002, que toma como referência o quadro territorial vigente em 01 de janeiro de 2001. Até aquele mês, esses sistemas informavam os valores calculados pelo Instituto Geográfico e Cartográfico – IGC, da Secretaria de Economia e Planejamento, que está procedendo à transformação da base cartográfica oficial para o formato digital, que resultará em revisão do cálculo das áreas municipais.<br><br> Os sistemas de informação disponíveis no sítio da Fundação Seade divulgam a área dos municípios e densidade demográfica desde 1980 e, como a partir desse ano ocorreram desmembramentos de municípios, foi necessária a realização de estimativas da área das unidades que deram origem aos novos municípios, nos anos anteriores à instalação desses últimos, tomando como base os dados do IBGE. Os procedimentos utilizados para essas estimativas são especificados a seguir.<br><br> No caso dos municípios que, isoladamente, deram origem a outros, a área daquele(s) deles desmembrado(s) foi somada às suas áreas informadas na Resolução nº 5, valores assumidos para os anos anteriores à instalação das novas unidades territoriais.<br><br> Para os municípios de onde foram desmembrados outros que receberam área de mais de uma unidade territorial (casos de Holambra, separado de Artur Nogueira, Cosmópolis, Jaguariúna e Santo Antonio de Posse, e de Ilha Comprida, originado de Cananéia e Iguape), o método usado para a estimativa foi o seguinte:<blockquote> - calcularam-se, para os dois novos municípios, os porcentuais de seus respectivos territórios desmembrados de cada um dos municípios de origem, tomando como base a área informada pelo IGC;<br> - aplicaram-se esses porcentuais sobre a área informada pelo IBGE na  Resolução nº 5 para os dois novos municípios, somando-se os valores resultantes às áreas dos municípios de origem, também informadas na Resolução nº 5. Esses números estimados foram assumidos para os municípios de origem, nos anos anteriores à instalação de Holambra e Ilha Comprida.</blockquote><br><br> Para ter acesso à lista dos desmembramentos de municípios ocorridos no Estado de São Paulo, a partir de 1980, <a href=\"http://www.seade.gov.br/produtos/imp/documentos/Municipios_criados_a_partir_1980.pdf\" target=\"_blank\">clique aqui</a>.<br><br> Para ter acesso à área dos municípios calculada pelo IGC, <a href=\"http://www.seade.gov.br/produtos/imp/documentos/area_IGC.zip\" target=\"_blank\">clique aqui</a>."
 +
    }
 +
}
  
 
== Consulta ==
 
== Consulta ==

Edição das 17h43min de 27 de setembro de 2013

Índice

Objetivo

Expor dados estatísticos governamentais do estado de São Paulo.

URI

http://api-imp.seade.gov.br

Recursos Disponíveis

Variável

GET

Path: /variavel Parâmetros: código

Exemplo de chamada

curl -X GET "http://api-imp.seade.gov.br/consulta/5"

Retorno JSON

Exemplo:

{
   "variavel": {
       "codigo": "5",
       "nome": "Área",
       "unidade": "(Em km2)",
       "fonte": "Instituto Brasileiro de Geografia e Estatística–IBGE.",
"nota": "A partir de agosto de 2008, os dados referentes à área dos municípios paulistas (e das regiões administrativas, de governo e metropolitanas, calculados pela soma das áreas municipais), divulgados nos sistemas de informação da Fundação Seade, têm como fonte a Resolução nº 5, do Instituto Brasileiro de Geografia e Estatística – IBGE, de 10 de outubro de 2002, que toma como referência o quadro territorial vigente em 01 de janeiro de 2001. Até aquele mês, esses sistemas informavam os valores calculados pelo Instituto Geográfico e Cartográfico – IGC, da Secretaria de Economia e Planejamento, que está procedendo à transformação da base cartográfica oficial para o formato digital, que resultará em revisão do cálculo das áreas municipais.

Os sistemas de informação disponíveis no sítio da Fundação Seade divulgam a área dos municípios e densidade demográfica desde 1980 e, como a partir desse ano ocorreram desmembramentos de municípios, foi necessária a realização de estimativas da área das unidades que deram origem aos novos municípios, nos anos anteriores à instalação desses últimos, tomando como base os dados do IBGE. Os procedimentos utilizados para essas estimativas são especificados a seguir.

No caso dos municípios que, isoladamente, deram origem a outros, a área daquele(s) deles desmembrado(s) foi somada às suas áreas informadas na Resolução nº 5, valores assumidos para os anos anteriores à instalação das novas unidades territoriais.

Para os municípios de onde foram desmembrados outros que receberam área de mais de uma unidade territorial (casos de Holambra, separado de Artur Nogueira, Cosmópolis, Jaguariúna e Santo Antonio de Posse, e de Ilha Comprida, originado de Cananéia e Iguape), o método usado para a estimativa foi o seguinte:
- calcularam-se, para os dois novos municípios, os porcentuais de seus respectivos territórios desmembrados de cada um dos municípios de origem, tomando como base a área informada pelo IGC;
- aplicaram-se esses porcentuais sobre a área informada pelo IBGE na Resolução nº 5 para os dois novos municípios, somando-se os valores resultantes às áreas dos municípios de origem, também informadas na Resolução nº 5. Esses números estimados foram assumidos para os municípios de origem, nos anos anteriores à instalação de Holambra e Ilha Comprida.


Para ter acesso à lista dos desmembramentos de municípios ocorridos no Estado de São Paulo, a partir de 1980, <a href=\"http://www.seade.gov.br/produtos/imp/documentos/Municipios_criados_a_partir_1980.pdf\" target=\"_blank\">clique aqui</a>.

Para ter acesso à área dos municípios calculada pelo IGC, <a href=\"http://www.seade.gov.br/produtos/imp/documentos/area_IGC.zip\" target=\"_blank\">clique aqui</a>."
   }
}

Consulta

GET

Path: /consulta

Parâmetros: localidade/variável/ano

Exemplo de chamada

curl -X GET "http://api-imp.seade.gov.br/consulta/16/15/0"

Retorno JSON

Exemplo:

{
   "consulta": [
       {
           "loc_cod": "16",
           "loc_nome": "Americana",
           "unid_nome": "(Por mil nascidos vivos ou mortos)",
           "nome_pai": "Região Metropolitana de Campinas",
           "var_cod": "15",
           "var_nome": "Teatros – Salas Disponíveis",
           "d_1995": "2",
           "d_1997": "2",
           "d_2000": "2",
           "d_2003": "1"
       },
       {
           "loc_cod": "16",
           "loc_nome": "Americana",
           "unid_nome": "(Por mil nascidos vivos ou mortos)",
           "nome_pai": "Região de Governo de Campinas",
           "var_cod": "15",
           "var_nome": "Teatros – Salas Disponíveis",
           "d_1995": "2",
           "d_1997": "2",
           "d_2000": "2",
           "d_2003": "1"
       }
   ]
}