{"id":19856396,"url":"https://github.com/ipeagit/enderecobr","last_synced_at":"2025-05-02T01:31:29.068Z","repository":{"id":218937492,"uuid":"747706852","full_name":"ipeaGIT/enderecobr","owner":"ipeaGIT","description":"Pacote de R para padronizar endereços brasileiros","archived":false,"fork":false,"pushed_at":"2025-02-19T12:57:04.000Z","size":2111,"stargazers_count":2,"open_issues_count":15,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-21T12:56:03.265Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://ipeagit.github.io/enderecobr/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ipeaGIT.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json","zenodo":null}},"created_at":"2024-01-24T13:35:51.000Z","updated_at":"2025-02-19T13:51:09.000Z","dependencies_parsed_at":"2024-12-19T21:24:13.290Z","dependency_job_id":"19333060-0de8-4ef1-9a2e-174a1561b1ef","html_url":"https://github.com/ipeaGIT/enderecobr","commit_stats":null,"previous_names":["ipeagit/enderecopadrao","ipeagit/enderecobr"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipeaGIT%2Fenderecobr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipeaGIT%2Fenderecobr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipeaGIT%2Fenderecobr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipeaGIT%2Fenderecobr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ipeaGIT","download_url":"https://codeload.github.com/ipeaGIT/enderecobr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251969422,"owners_count":21673199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T14:15:25.223Z","updated_at":"2025-05-02T01:31:29.055Z","avatar_url":"https://github.com/ipeaGIT.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\"\n)\n```\n\n# enderecobr \u003cimg align=\"right\" src=\"man/figures/logo.svg\" alt=\"\" width=\"180\"\u003e\n\n[![CRAN\nstatus](https://www.r-pkg.org/badges/version/enderecobr)](https://CRAN.R-project.org/package=enderecobr)\n[![B\nstatus](https://github.com/ipeaGIT/enderecobr/workflows/check/badge.svg)](https://github.com/ipeaGIT/enderecobr/actions?query=workflow%3Acheck)\n[![CRAN/METACRAN Total\ndownloads](https://cranlogs.r-pkg.org/badges/grand-total/enderecobr?color=blue)](https://CRAN.R-project.org/package=enderecobr)\n[![Codecov test\ncoverage](https://codecov.io/gh/ipeaGIT/enderecobr/branch/main/graph/badge.svg)](https://app.codecov.io/gh/ipeaGIT/enderecobr?branch=main)\n[![Lifecycle:\nstable](https://lifecycle.r-lib.org/articles/figures/lifecycle-stable.svg)](https://lifecycle.r-lib.org/articles/stages.html)\n\n**enderecobr** é um pacote de R que permite padronizar endereços brasileiros\na partir de diferentes critérios. Os métodos de padronização atualmente incluem\napenas manipulações de strings, não oferecendo suporte a correspondências\nprobabilísticas entre strings.\n\n## Instalação\n\nA última versão estável pode ser baixada do CRAN com o comando a seguir:\n\n```r\ninstall.packages(\"enderecobr\")\n```\n\nCaso prefira, a versão em desenvolvimento também pode ser usada. Para isso, use\no seguinte comando:\n\n```r\n# install.packages(\"remotes\")\nremotes::install_github(\"ipeaGIT/enderecobr\")\n```\n\n## Utilização\n\nEsta seção visa oferecer apenas uma visão geral das funcionalidades do pacote.\nPara mais detalhes, leia a vignette introdutória:\n\n- [**enderecobr**: padronizador de endereços\nbrasileiros](https://ipeagit.github.io/enderecobr/articles/enderecobr.html)\n\nO **enderecobr** disponibiliza funções para padronizar diferentes campos de um\nendereço. A `padronizar_enderecos()`, carro-chefe do pacote, atua de forma\nsimultânea sobre os vários campos que podem compor um endereço. Para isso, ela\nrecebe um dataframe e a correspondência entre suas colunas e os campos a serem\npadronizados:\n\n```{r}\nlibrary(enderecobr)\n\nenderecos \u003c- data.frame(\n  logradouro = \"r ns sra da piedade\",\n  nroLogradouro = 20,\n  complemento = \"qd 20\",\n  cep = 25220020,\n  bairro = \"jd botanico\",\n  codmun_dom = 3304557,\n  uf_dom = \"rj\"\n)\n\ncampos \u003c- correspondencia_campos(\n  logradouro = \"logradouro\",\n  numero = \"nroLogradouro\",\n  complemento = \"complemento\",\n  cep = \"cep\",\n  bairro = \"bairro\",\n  municipio = \"codmun_dom\",\n  estado = \"uf_dom\"\n)\n\npadronizar_enderecos(enderecos, campos_do_endereco = campos)\n```\n\nPor trás dos panos, essa função utiliza diversas outras funções que padronizam\ncampos de forma individual. Cada uma delas recebe um vetor com valores não\npadronizados e retorna um vetor de mesmo tamanho com os respectivos valores\npadronizados. Algumas das funções disponíveis são apresentadas a seguir:\n\n```{r}\nestados \u003c- c(\"21\", \" 21\", \"MA\", \" MA \", \"ma\", \"MARANHÃO\")\npadronizar_estados(estados)\n\nmunicipios \u003c- c(\n  \"3304557\", \"003304557\", \" 3304557 \", \"RIO DE JANEIRO\", \"rio de janeiro\",\n  \"SÃO PAULO\"\n)\npadronizar_municipios(municipios)\n\nbairros \u003c- c(\n  \"PRQ IND\",\n  \"NSA SEN DE FATIMA\",\n  \"ILHA DO GOV\",\n  \"VL OLIMPICA\",\n  \"NUC RES\"\n)\npadronizar_bairros(bairros)\n\nceps \u003c- c(\"22290-140\", \"22.290-140\", \"22290 140\", \"22290140\")\npadronizar_ceps(ceps)\n\nlogradouros \u003c- c(\n  \"r. gen.. glicério, 137\",\n  \"cond pres j. k., qd 05 lt 02 1\",\n  \"av d pedro I, 020\"\n)\npadronizar_logradouros(logradouros)\n\nnumeros \u003c- c(\"0210\", \"001\", \"1\", \"\", \"S N\", \"S/N\", \"SN\", \"0180  0181\")\npadronizar_numeros(numeros)\n```\n\n## Controle de verbosidade\n\nO disparo de mensagens com informações sobre a execução das funções pode ser\ncontrolado pela opção `enderecobr.verbose`, que recebe os valores `\"quiet\"` ou\n`\"verbose\"`, como demonstrado a seguir:\n\n```r\ncampos \u003c- correspondencia_logradouro(\n  nome_do_logradouro = \"logradouro\",\n  numero = \"nroLogradouro\"\n)\n\n# quieto, por padrão\nres \u003c- padronizar_logradouros_completos(enderecos, campos)\n\n# verboso, se desejado\nrlang::local_options(\"enderecobr.verbose\" = \"verbose\")\nres \u003c- padronizar_logradouros_completos(enderecos, campos)\n#\u003e ✔ Padronizando nomes dos logradouros... [130ms]\n#\u003e ✔ Padronizando números... [111ms]\n#\u003e ✔ Trazendo números para o logradouro completo... [107ms]\n```\n\n## Nota \u003ca href=\"https://www.ipea.gov.br\"\u003e\u003cimg src=\"man/figures/ipea_logo.png\" alt=\"Ipea\" align=\"right\" width=\"300\"/\u003e\u003c/a\u003e\n\n**enderecobr** é desenvolvido por uma equipe de pesquisadores do Instituto\nde Pesquisa Econômica Aplicada (Ipea).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipeagit%2Fenderecobr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipeagit%2Fenderecobr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipeagit%2Fenderecobr/lists"}