cepR Ă© um pacote para R que acessa
dados postais do Brasil tais como nomes de bairros, cidades, estados,
logradouros, CEPs e outras informaçÔes de interesse como altitude,
longitude e latitude. Os dados sĂŁo do projeto
CEPaberto e para utilizar este pacote Ă©
preciso se cadastrar no site do
CEPaberto e obter um token
pessoal. VocĂȘ pode contribuir para o projeto CEPaberto clicando na aba
âColaborarâ do site. Para instalar o
cepR é só seguir as instruçÔes abaixo. Um banco de dados com
endereços postais do estado de SĂŁo Paulo estĂĄ incluĂdo no pacote e pode
ser acessado com data("sp")
. SugestÔes, pull requests e comentårios
sĂŁo muito bem-vindos!
CRAN:
install.packages("cepR")
GitHub:
# install.packages("remotes")
remotes::install_github("RobertMyles/cepR")
Ă possĂvel buscar os nomes das cidades e municipios com busca_estado()
library(cepR)
token <- "XXXXXXXXXXX" # seu token
sp <- busca_estado(estado = "SP", token = token)
sp
# A tibble: 863 x 2
estado municipio
<chr> <chr>
1 SP Adamantina
2 SP Adolfo
3 SP Agisse (Rancharia)
4 SP AguaĂ
5 SP Ăguas da Prata
6 SP Ăguas de LindĂłia
7 SP Ăguas de Santa BĂĄrbara
8 SP Ăguas de SĂŁo Pedro
9 SP Ăgua Vermelha (SĂŁo Carlos)
10 SP Agudos
# ... with 853 more rows
Pode-se também buscar os endereços por CEP. Por exemplo, o valor default do CEP é o da Praça da Sé:
> busca_cep(token = token)
# A tibble: 1 x 10
estado cidade bairro cep logradouro latitude
<chr> <chr> <chr> <chr> <chr> <chr>
1 SP SĂŁo Paulo SĂ© 01001000 Praça da SĂ©, lado Ămpar -23.5479099981
# ... with 4 more variables: longitude <chr>, altitude <chr>, ddd <chr>,
# cod_IBGE <chr>
TambĂ©m Ă© possĂvel buscar por mĂșltiplos CEPs. Ă importante atentar para o limite de 1 pesquisa por segundo por token, portanto pesquisas com muitos itens podem demorar bastante. O valor default dos CEPs da função busca_multi sĂŁo ambos na Praça da SĂ©:
> busca_multi(token = token)
# A tibble: 2 x 10
estado cidade bairro cep logradouro latitude longitude altitude ddd cod_IBGE
<chr> <chr> <chr> <chr> <chr> <dbl> <dbl> <dbl> <dbl> <chr>
1 SP São Paulo Sé 01001000 Praça da Sé -23.5 -46.6 760 11 3550308
2 SP São Paulo Sé 01001001 Praça da Sé -23.5 -46.6 760 11 3550308
Para mais, veja o projeto CEPAberto.
cepR is a package for accessing Brazilian address data: neighbourhood names, city and state names, actual addresses, postal codes, and other info such as altitude, longitude & latitude. The data come from the CEPaberto project, and to use the package, youâll need a personal access token from the CEP Aberto site. Suggestions, pull requests, criticisms all welcome. You can install the package as shown in Instalação above. If you use it regularly, please consider donating to the CEPAberto project.
The package is aimed at a Brazilian audience, so if you donât speak Portuguese:
The others arenât too hard to figure out đ”.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.