Um wrapper de API em torno de postcodes.io - pesquisa gratuita de código postal e geocodificador do Reino Unido. Este pacote ajuda a encontrar e transformar informações sobre a geografia administrativa do Reino Unido, como códigos postais, LSOA, MSOA, círculos eleitorais, condados, distritos, distritos, CCG ou NUTS.
O pacote é baseado exclusivamente em dados abertos fornecidos por postcodes.io. PostcodesioR pode ser usado por cientistas de dados ou cientistas sociais que trabalham com dados geocodificados do Reino Unido. Uma tarefa comum ao trabalhar com esses dados é agregar dados geocodificados em diferentes níveis administrativos, por exemplo, transformar dados a nível de código postal em condados ou regiões. Este pacote pode ajudar a alcançar este objetivo e em muitos outros casos quando for necessária a alteração da agregação de dados geográficos.
Este pacote pode ser instalado do GitHub (versão em desenvolvimento) ou CRAN (estável).
Para instalar o PostcodesioR use um dos seguintes comandos:
# stable version
install.packages( " PostcodesioR " )
ou
# developmental version
if ( ! require( " devtools " )) {
install.packages( " devtools " )
}
devtools :: install_github( " ropensci/PostcodesioR " )
Carregue o pacote digitando
library( PostcodesioR )
Sempre que possível, tentei retornar um quadro de dados. Infelizmente, muitas chamadas de API retornam dados mais complexos e nesses casos é mais seguro usar listas. A API limita o número de chamadas retornadas. Verifique a documentação das funções para mais detalhes.
Para obter informações adicionais sobre os dados retornados e as chamadas de função, consulte a documentação original.
A principal função deste pacote fornece informações relacionadas a um determinado código postal
lookup_result <- postcode_lookup( " EC1Y8LX " )
# overview
str( lookup_result )
## 'data.frame': 1 obs. of 38 variables:
## $ postcode : chr "EC1Y 8LX"
## $ quality : int 1
## $ eastings : int 532544
## $ northings : int 182128
## $ country : chr "England"
## $ nhs_ha : chr "London"
## $ longitude : num -0.0909
## $ latitude : num 51.5
## $ european_electoral_region : chr "London"
## $ primary_care_trust : chr "Islington"
## $ region : chr "London"
## $ lsoa : chr "Islington 023D"
## $ msoa : chr "Islington 023"
## $ incode : chr "8LX"
## $ outcode : chr "EC1Y"
## $ parliamentary_constituency : chr "Islington South and Finsbury"
## $ admin_district : chr "Islington"
## $ parish : chr "Islington, unparished area"
## $ admin_county : logi NA
## $ date_of_introduction : chr "198001"
## $ admin_ward : chr "Bunhill"
## $ ced : logi NA
## $ ccg : chr "NHS North Central London"
## $ nuts : chr "Haringey and Islington"
## $ pfa : chr "Metropolitan Police"
## $ admin_district_code : chr "E09000019"
## $ admin_county_code : chr "E99999999"
## $ admin_ward_code : chr "E05013699"
## $ parish_code : chr "E43000209"
## $ parliamentary_constituency_code: chr "E14000764"
## $ ccg_code : chr "E38000240"
## $ ccg_id_code : chr "93C"
## $ ced_code : chr "E99999999"
## $ nuts_code : chr "TLI43"
## $ lsoa_code : chr "E01002704"
## $ msoa_code : chr "E02000576"
## $ lau2_code : chr "E09000019"
## $ pfa_code : chr "E23000001"
Verifique a vinheta para ver todas as funções em ação.
Por favor, cite este pacote se ele for usado em uma publicação
Walczak, EJ, (2023). PostcodesioR: An R package for UK geocoding. Journal of Open Source Software, 8(84), 5334, https://doi.org/10.21105/joss.05334
A entrada do BibTeX está aqui:
@article{postcodesior:2023,
title = {{PostcodesioR: An R package for UK geocoding}},
author = {Eryk J. Walczak},
journal = {Journal of Open Source Software},
volume = {8},
number = {84},
pages = {5334},
year = {2023},
doi = {10.21105/joss.05334},
note = {R package version 0.3.1},
url = {https://cran.r-project.org/web/packages/PostcodesioR/},
}
Atualmente, há um limite para o número de chamadas de API que podem ser feitas. No entanto, postcodes.io fornece uma lista completa de dados de geolocalização que podem ser usados localmente sem limitações. Os dados originais são provenientes do Portal de Dados do Office for National Statistics. Esse arquivo é bastante grande, então não o incluí no pacote.
Acesse o site do pacote ou meu blog para mais exemplos.
Observe que este projeto é lançado com um Código de Conduta do Colaborador. Ao participar deste projeto você concorda em cumprir seus termos.