# Tribunal de Justiça de São Paulo (TJSP)
[GitHub](https://github.com/open-geodata/sp_tjsp_divadmin) | [PyPI](https://pypi.org/project/sp-tjsp-divadmin)
<br>
Por meio do site das [Regiões Administrativas Judiciárias](https://www.tjsp.jus.br/QuemSomos/QuemSomos/RegioesAdministrativasJudiciarias), do [TJSP](https://portal.tjsp.jus.br) foi possível obter a lista de:
- Comarcas
- Circunscrições Judiciárias (CJs)
- Regiões Administrativas Judiciárias (RAJs)
<br>
O objetivo do presente repositório é manter rotina de atualização dessas informações, bem como disponibilizá-las por meio de pacotes [PyPI](https://pypi.org/project/sp-tjsp-divadmin).
> Dados Atualizados em 30.03.2023
<br>
---
## Concepção do Projeto
### _Script_ 1: Quem Somos
A ideia iniciar foi "raspar" as informações da lista de CJs, RAJs e Comarcas da sessão ["Quem Somos"](https://www.tjsp.jus.br/QuemSomos/QuemSomos/RegioesAdministrativasJudiciarias) do _site_ do TJSP. Ainda faltaria a informação de cada um dos 645 municípios do Estado e a vinculação com a Comarca, assunto resolvido com outro _script_.
Para raspar os dados foi usado o _Selenium_, no _script_ [01_get_comarcas](./scripts/01_get_comarcas.ipynb). Como resultado foram obtidas as listas de:
- **Comarcas**: totalizando 321 Comarcas do Estado (_descobri que tratam-se, na realidade, de 320 Comarcas... segue a leitura..._)
- **Circunscrições Judiciárias**, totalizando 57 CJs no Estado (56 mais a Capital!)
- **Regiões Administrativas Judiciárias**, totalizando 5 RAJs no Estado
<br>
### _Script_ 2: Método POST
Faltava ainda descobrir qual a Comarca dos 645 municípios do Estado de São Paulo, para conseguir relacioná-los a lista das 321 Comarcas (até então). Descobri que por meio da [Lista Telefônica](https://www.tjsp.jus.br/ListaTelefonica) era possível pesquisar um determinado município e obter as unidades do Poder Judiciário que tem atribuição no município pesquisado! Pronto! Era necessário apenas consultar todos os municípios agora, o que foi feito com auxílio do _script_ [02_get_municipios](./scripts/02_get_municipios.ipynb).
<br>
Notei que ao escrever parte do nome do município, um método POST atuava, retornando a lista dos 10 municípios prováveis de serem solicitados pelo usuário. Fiz a requisição POST dezenas de vezes, obtendo o nome dos Município definidos pelo TJSP (que contendo erros!, por exemplo "Florínia" está errado. O Correto é"Florínea") e o Código do Município definido pelo TJSP.
Em um segundo método POST que encontrei no _site_, era possível obter a jurisdição a partir do nome do Código do Municício definido pelo TJSP. Consultei todos os 645 códigos, obtendo a lista das Comarcas.
**IMPORTANTE**: Descartei a lista das unidades do Poder Judiciário (nomes de Fórums e outros). Pode ser que essa informação seja útil em alguma ocasião. Como não era meu objetivo nesse projeto, descartei!
Após obter as informações, fiz um trabalho de ajuste dos dados para que os Municípios e Comarcas fossem vinculados aos Códigos do IBGE, corrigindo também no nome dos Municípios.
Após ajustar a tabela e como resultado, observei a existência de 320 Comarcas, contrariando a informação anteriormente obtida!
<br>
### _Script_ 3: Comarcas: o que está certo?
O _script_ [03_adjust_comarcas](./scripts/03_adjust_comarcas.ipynb) leu as informações das Comarcas obtidas no _script_ 1 e 2, visando compara-las e encontrar onde estava a diferença:
- De acordo com o _script_ 1 existem 321 Comarcas
- De acordo com o _script_ 2 existem 320 Comarcas
<br>
Com auxílio do _script_ 03 encontrei o erro que consta no ["Quem Somos"](https://www.tjsp.jus.br/QuemSomos/QuemSomos/RegioesAdministrativasJudiciarias), obtido no _script_ 01: Está listada "Vila Mimosa" como Comarca. Na realidade, trata-se de um Forum Regional no município de Campinas, pertencente a Comarca de Campinas, conforme se observa, inclusive, na hierarquia da [Secretaria da Fazenda](http://www.fazenda.sp.gov.br/ua/hierarquia3.asp?ua1=0021071).
<br>
O _script_ atualiza informações, trazendo o número da CJ para a tabela de Comarcas e excluí a tabela de Comarcas errada!
<br>
### _Script_ 4: Compilação de Dados e Mapas
Um quarto _script_ [04_geodata](./scripts/04_geodata.ipynb) compila essas informações em uma talela única, gerando um mapa contendo a delimitação dos 645 municíos com todas as informações associadas.
<br>
### _Script_ 5: _Webmap_
Para finalizar, o _script_ [05_create_map](./scripts/05_create_map.ipynb) foi também gerado um _webmap_, para facilitar a visualização de dados.
<br>
---
### _TODO_
1. Obter Entrâncias das Comarcas?? Tabular leis... [Lei 1](https://www.al.sp.gov.br/norma/59545), [Lei 2](https://www.al.sp.gov.br/repositorio/legislacao/lei.complementar/2005/lei.complementar-980-21.12.2005.html) etc.
Raw data
{
"_id": null,
"home_page": "https://github.com/open-geodata/sp_tjsp_divadmin",
"name": "sp-tjsp-divadmin",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "python,dados espaciais,geoprocessamento",
"author": "Michel Metran",
"author_email": "michelmetran@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/31/1f/e29405895ed22274842b3a0d73675535cd1568188c2ffda6988dcb049aa3/sp_tjsp_divadmin-0.0.12.tar.gz",
"platform": null,
"description": "# Tribunal de Justi\u00e7a de S\u00e3o Paulo (TJSP)\n\n[GitHub](https://github.com/open-geodata/sp_tjsp_divadmin) | [PyPI](https://pypi.org/project/sp-tjsp-divadmin)\n\n<br>\n\nPor meio do site das [Regi\u00f5es Administrativas Judici\u00e1rias](https://www.tjsp.jus.br/QuemSomos/QuemSomos/RegioesAdministrativasJudiciarias), do [TJSP](https://portal.tjsp.jus.br) foi poss\u00edvel obter a lista de:\n\n- Comarcas\n- Circunscri\u00e7\u00f5es Judici\u00e1rias (CJs)\n- Regi\u00f5es Administrativas Judici\u00e1rias (RAJs)\n\n<br>\n\nO objetivo do presente reposit\u00f3rio \u00e9 manter rotina de atualiza\u00e7\u00e3o dessas informa\u00e7\u00f5es, bem como disponibiliz\u00e1-las por meio de pacotes [PyPI](https://pypi.org/project/sp-tjsp-divadmin).\n\n> Dados Atualizados em 30.03.2023\n\n<br>\n\n---\n\n## Concep\u00e7\u00e3o do Projeto\n\n### _Script_ 1: Quem Somos\n\nA ideia iniciar foi \"raspar\" as informa\u00e7\u00f5es da lista de CJs, RAJs e Comarcas da sess\u00e3o [\"Quem Somos\"](https://www.tjsp.jus.br/QuemSomos/QuemSomos/RegioesAdministrativasJudiciarias) do _site_ do TJSP. Ainda faltaria a informa\u00e7\u00e3o de cada um dos 645 munic\u00edpios do Estado e a vincula\u00e7\u00e3o com a Comarca, assunto resolvido com outro _script_.\n\nPara raspar os dados foi usado o _Selenium_, no _script_ [01_get_comarcas](./scripts/01_get_comarcas.ipynb). Como resultado foram obtidas as listas de:\n\n- **Comarcas**: totalizando 321 Comarcas do Estado (_descobri que tratam-se, na realidade, de 320 Comarcas... segue a leitura..._)\n- **Circunscri\u00e7\u00f5es Judici\u00e1rias**, totalizando 57 CJs no Estado (56 mais a Capital!)\n- **Regi\u00f5es Administrativas Judici\u00e1rias**, totalizando 5 RAJs no Estado\n\n<br>\n\n### _Script_ 2: M\u00e9todo POST\n\nFaltava ainda descobrir qual a Comarca dos 645 munic\u00edpios do Estado de S\u00e3o Paulo, para conseguir relacion\u00e1-los a lista das 321 Comarcas (at\u00e9 ent\u00e3o). Descobri que por meio da [Lista Telef\u00f4nica](https://www.tjsp.jus.br/ListaTelefonica) era poss\u00edvel pesquisar um determinado munic\u00edpio e obter as unidades do Poder Judici\u00e1rio que tem atribui\u00e7\u00e3o no munic\u00edpio pesquisado! Pronto! Era necess\u00e1rio apenas consultar todos os munic\u00edpios agora, o que foi feito com aux\u00edlio do _script_ [02_get_municipios](./scripts/02_get_municipios.ipynb).\n\n\n\n<br>\n\nNotei que ao escrever parte do nome do munic\u00edpio, um m\u00e9todo POST atuava, retornando a lista dos 10 munic\u00edpios prov\u00e1veis de serem solicitados pelo usu\u00e1rio. Fiz a requisi\u00e7\u00e3o POST dezenas de vezes, obtendo o nome dos Munic\u00edpio definidos pelo TJSP (que contendo erros!, por exemplo \"Flor\u00ednia\" est\u00e1 errado. O Correto \u00e9\"Flor\u00ednea\") e o C\u00f3digo do Munic\u00edpio definido pelo TJSP.\n\nEm um segundo m\u00e9todo POST que encontrei no _site_, era poss\u00edvel obter a jurisdi\u00e7\u00e3o a partir do nome do C\u00f3digo do Munic\u00edcio definido pelo TJSP. Consultei todos os 645 c\u00f3digos, obtendo a lista das Comarcas.\n\n**IMPORTANTE**: Descartei a lista das unidades do Poder Judici\u00e1rio (nomes de F\u00f3rums e outros). Pode ser que essa informa\u00e7\u00e3o seja \u00fatil em alguma ocasi\u00e3o. Como n\u00e3o era meu objetivo nesse projeto, descartei!\n\nAp\u00f3s obter as informa\u00e7\u00f5es, fiz um trabalho de ajuste dos dados para que os Munic\u00edpios e Comarcas fossem vinculados aos C\u00f3digos do IBGE, corrigindo tamb\u00e9m no nome dos Munic\u00edpios.\n\nAp\u00f3s ajustar a tabela e como resultado, observei a exist\u00eancia de 320 Comarcas, contrariando a informa\u00e7\u00e3o anteriormente obtida!\n\n<br>\n\n### _Script_ 3: Comarcas: o que est\u00e1 certo?\n\nO _script_ [03_adjust_comarcas](./scripts/03_adjust_comarcas.ipynb) leu as informa\u00e7\u00f5es das Comarcas obtidas no _script_ 1 e 2, visando compara-las e encontrar onde estava a diferen\u00e7a:\n\n- De acordo com o _script_ 1 existem 321 Comarcas\n- De acordo com o _script_ 2 existem 320 Comarcas\n\n<br>\n\nCom aux\u00edlio do _script_ 03 encontrei o erro que consta no [\"Quem Somos\"](https://www.tjsp.jus.br/QuemSomos/QuemSomos/RegioesAdministrativasJudiciarias), obtido no _script_ 01: Est\u00e1 listada \"Vila Mimosa\" como Comarca. Na realidade, trata-se de um Forum Regional no munic\u00edpio de Campinas, pertencente a Comarca de Campinas, conforme se observa, inclusive, na hierarquia da [Secretaria da Fazenda](http://www.fazenda.sp.gov.br/ua/hierarquia3.asp?ua1=0021071).\n\n\n\n<br>\n\nO _script_ atualiza informa\u00e7\u00f5es, trazendo o n\u00famero da CJ para a tabela de Comarcas e exclu\u00ed a tabela de Comarcas errada!\n\n<br>\n\n### _Script_ 4: Compila\u00e7\u00e3o de Dados e Mapas\n\nUm quarto _script_ [04_geodata](./scripts/04_geodata.ipynb) compila essas informa\u00e7\u00f5es em uma talela \u00fanica, gerando um mapa contendo a delimita\u00e7\u00e3o dos 645 munic\u00edos com todas as informa\u00e7\u00f5es associadas.\n\n<br>\n\n### _Script_ 5: _Webmap_\n\nPara finalizar, o _script_ [05_create_map](./scripts/05_create_map.ipynb) foi tamb\u00e9m gerado um _webmap_, para facilitar a visualiza\u00e7\u00e3o de dados.\n\n<br>\n\n---\n\n### _TODO_\n\n1. Obter Entr\u00e2ncias das Comarcas?? Tabular leis... [Lei 1](https://www.al.sp.gov.br/norma/59545), [Lei 2](https://www.al.sp.gov.br/repositorio/legislacao/lei.complementar/2005/lei.complementar-980-21.12.2005.html) etc.\n",
"bugtrack_url": null,
"license": "",
"summary": "Divis\u00e3o Administrativa do TJSP, incluindo Comarcas, Cirscunscri\u00e7\u00f5es Judici\u00e1rias e Regi\u00f5es Administrativas Judici\u00e1rias",
"version": "0.0.12",
"project_urls": {
"Homepage": "https://github.com/open-geodata/sp_tjsp_divadmin"
},
"split_keywords": [
"python",
"dados espaciais",
"geoprocessamento"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "135f581291c2ce7be1d0945dedc3b75d4044e31a0be5c432db39d47ea505a256",
"md5": "4aada4ea30fce329f6e06e8941f41df3",
"sha256": "32996a9ffe875558cd2e73ed77ebc8a8d901a7b235e8ecf0a949ae16ce0cd976"
},
"downloads": -1,
"filename": "sp_tjsp_divadmin-0.0.12-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4aada4ea30fce329f6e06e8941f41df3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 5357416,
"upload_time": "2024-03-04T01:13:56",
"upload_time_iso_8601": "2024-03-04T01:13:56.425081Z",
"url": "https://files.pythonhosted.org/packages/13/5f/581291c2ce7be1d0945dedc3b75d4044e31a0be5c432db39d47ea505a256/sp_tjsp_divadmin-0.0.12-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "311fe29405895ed22274842b3a0d73675535cd1568188c2ffda6988dcb049aa3",
"md5": "44186bf1f0ce0f85f57d0507d701df17",
"sha256": "3e2da672a6a9a7d1789d9d603fff4f1f587b14a9c9096ed1bce8828a11f32458"
},
"downloads": -1,
"filename": "sp_tjsp_divadmin-0.0.12.tar.gz",
"has_sig": false,
"md5_digest": "44186bf1f0ce0f85f57d0507d701df17",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 5361023,
"upload_time": "2024-03-04T01:13:58",
"upload_time_iso_8601": "2024-03-04T01:13:58.975205Z",
"url": "https://files.pythonhosted.org/packages/31/1f/e29405895ed22274842b3a0d73675535cd1568188c2ffda6988dcb049aa3/sp_tjsp_divadmin-0.0.12.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-04 01:13:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "open-geodata",
"github_project": "sp_tjsp_divadmin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "sp-tjsp-divadmin"
}
JSON
