Penulis: Jason Bryer, Ph.D. [email protected]
Situs web: https://jbryer.github.io/brickset/
Paket ini menyediakan fungsi untuk mengakses data tentang set LEGO dari situs web Brickset. Paket ini juga berisi data.frame
dengan semua set Lego (n = 18.455) dari tahun 1970 hingga 2022. Set data ini dibuat menggunakan fungsi getSets
dan disarankan agar Anda menggunakan bingkai data ini untuk mengurangi jumlah panggilan API. Lihat skrip build.r untuk bagaimana bingkai data dibuat. Informasi tentang variabel termasuk di bawah ini.
Anda dapat mengunduh dari cran menggunakan:
install.packages( ' brickset ' )
Atau versi pengembangan terbaru menggunakan paket remotes
:
remotes :: install_github( ' jbryer/brickset ' )
Untuk menggunakan API Brickset, Anda harus terlebih dahulu membuat akun Brickset dan meminta kunci API. Dokumentasi API bata lengkap tersedia di sini: https://brickset.com/article/52664/api-version-3-documentation
Sebagian besar fungsi memerlukan nama pengguna, kata sandi, dan kunci API bata. Anda dapat meneruskan ini sebagai parameter, atau Anda dapat mengatur opsi ini:
options( brickset_key = ' YOUR_API_KEY ' ,
brickset_username = ' YOUR_USERNAME ' ,
brickset_password = ' YOUR_PASSWORD ' )
Fungsi checkKey
akan memverifikasi bahwa kunci API Anda valid:
brickset :: checkKey()
# > [1] TRUE
Anda dapat memeriksa penggunaan API Anda dengan fungsi getKeyUsageStats
.
brickset :: getKeyUsageStats()
# > dateStamp count
# > 1 2023-03-30T00:00:00Z 3
# > 2 2023-03-24T00:00:00Z 2
# > 3 2023-03-23T00:00:00Z 2
# > 4 2023-03-22T00:00:00Z 16
# > 5 2023-03-21T00:00:00Z 2
Fungsi getSets
mengembalikan semua set Lego dari tahun tertentu.
sets2021 <- brickset :: getSets( 2021 )
head( sets2021 , n = 3 )
# > setID name year theme themeGroup
# > 1 31026 Police Station 2021 Icons Model making
# > 2 31754 Volkswagen T2 Camper Van 2021 Icons Model making
# > 3 31025 Flower Bouquet 2021 Icons Model making
# > subtheme category released pieces minifigs
# > 1 Modular Buildings Collection Normal TRUE 2923 5
# > 2 Vehicles Normal TRUE 2207 NA
# > 3 Botanical Collection Normal TRUE 756 NA
# > bricksetURL rating reviewCount packagingType
# > 1 https://brickset.com/sets/10278-1 4.4 4 Box
# > 2 https://brickset.com/sets/10279-1 4.1 0 Box
# > 3 https://brickset.com/sets/10280-1 4.3 3 Box
# > availability agerange_min US_retailPrice US_dateFirstAvailable
# > 1 LEGO exclusive 18 199.99 2021-01-02T00:00:00Z
# > 2 LEGO exclusive 18 179.99 2021-08-02T00:00:00Z
# > 3 Retail 18 59.99 2021-01-02T00:00:00Z
# > US_dateLastAvailable UK_retailPrice UK_dateFirstAvailable
# > 1 <NA> 169.99 2021-01-01T00:00:00Z
# > 2 2022-11-12T00:00:00Z 139.99 2021-08-01T00:00:00Z
# > 3 <NA> 54.99 2021-01-01T00:00:00Z
# > UK_dateLastAvailable CA_retailPrice CA_dateFirstAvailable
# > 1 <NA> 269.99 2021-01-02T00:00:00Z
# > 2 2022-11-29T00:00:00Z 249.99 2021-08-03T00:00:00Z
# > 3 <NA> 79.99 2021-01-02T00:00:00Z
# > CA_dateLastAvailable DE_retailPrice DE_dateFirstAvailable
# > 1 <NA> 199.99 2021-01-02T00:00:00Z
# > 2 2022-11-12T00:00:00Z 159.99 2021-08-02T00:00:00Z
# > 3 <NA> 59.99 2021-01-02T00:00:00Z
# > DE_dateLastAvailable height width depth weight
# > 1 <NA> 47.6 57.7 11.8 4.012
# > 2 2022-11-30T00:00:00Z 37.4 57.8 11.2 2.945
# > 3 <NA> 38.2 26.2 7.1 0.760
# > thumbnailURL
# > 1 https://images.brickset.com/sets/small/10278-1.jpg
# > 2 https://images.brickset.com/sets/small/10279-1.jpg
# > 3 https://images.brickset.com/sets/small/10280-1.jpg
# > imageURL
# > 1 https://images.brickset.com/sets/images/10278-1.jpg
# > 2 https://images.brickset.com/sets/images/10279-1.jpg
# > 3 https://images.brickset.com/sets/images/10280-1.jpg
Fungsi getReviews
akan mengembalikan semua ulasan untuk set yang diberikan.
reviews29830 <- brickset :: getReviews( 29830 )
names( reviews29830 )
# > [1] "author" "datePosted" "title"
# > [4] "review" "HTML" "overall"
# > [7] "parts" "buildingExperience" "playability"
# > [10] "valueForMoney"
getThemes
dan getSubthemes
mengembalikan informasi tentang tema Lego.
getThemes() | > head( n = 3 )
# > theme setCount subthemeCount yearFrom yearTo
# > 1 {Unknown IP} 5 0 2023 2023
# > 2 4 Juniors 24 5 2003 2004
# > 3 Action Wheelers 9 0 2000 2001
getSubthemes( ' Toy Story ' )
# > theme subtheme setCount yearFrom yearTo
# > 1 Toy Story Buildable Figures 2 2010 2010
# > 2 Toy Story Original Film 2 2010 2010
# > 3 Toy Story Toy Story 2 3 2010 2010
# > 4 Toy Story Toy Story 3 8 2010 2010
getYears( ' Toy Story ' )
# > theme year setCount
# > 1 Toy Story 2010 15
getInstructions
akan mengembalikan meja dengan URL ke instruksi bangunan.
instructions <- getInstructions( setID = 29830 )
instructions
# > URL
# > 1 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313846.pdf
# > 2 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313848.pdf
# > 3 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313849.pdf
# > 4 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313850.pdf
# > description
# > 1 BI 3103, 112+4/65+200G, 10270 V29 1/2
# > 2 BI 3103, 96+4/65+200G,10270 V29 2/2
# > 3 BI 3103, 112+4/65+200G, V39/142 1/2
# > 4 BI 3103, 96+4/65+200G, V39/142 2/2
legosets
Bingkai data legosets
berisi semua set Lego (n = 18.455) dari tahun 1970 hingga 2022.
data( " legosets " , package = " brickset " )
ggplot( legosets , aes( x = year )) + geom_bar() +
ggtitle( ' Number of LEGO sets by year ' ) +
xlab( ' Year ' ) + ylab( ' Number of LEGO Sets ' )
ggplot( legosets , aes( x = pieces , y = US_retailPrice )) +
geom_point() +
ggtitle( ' Cost of LEGO sets by number of pieces ' ) +
xlab( ' Number of LEGO pieces ' ) + ylab( ' US Retail Price (dollars) ' )
Variabel dalam bingkai data legosets
adalah:
Jenis | Unik_values | |
---|---|---|
setid | bilangan bulat | 18455 |
nama | karakter | 15372 |
tahun | bilangan bulat | 53 |
tema | karakter | 154 |
Thenegroup | karakter | 16 |
subtema | karakter | 901 |
kategori | karakter | 7 |
dilepaskan | logis | 2 |
bagian-bagian | bilangan bulat | 1403 |
minifigs | bilangan bulat | 34 |
BricksetUrl | karakter | 18455 |
peringkat | numerik | 31 |
ReviewCount | bilangan bulat | 64 |
PackagingType | karakter | 18 |
tersedianya | karakter | 10 |
Agerange_min | bilangan bulat | 16 |
US_Retailprice | numerik | 142 |
Us_dateFirStavailable | Tanggal | 881 |
US_DATELASTAVAILABLE | Tanggal | 2125 |
Uk_retailprice | numerik | 210 |
Uk_dateFirStavailable | Tanggal | 825 |
Uk_datelastavailable | Tanggal | 1984 |
Ca_retailprice | numerik | 162 |
Ca_dateFirStavailable | Tanggal | 641 |
Ca_datelastavailable | Tanggal | 1808 |
De_retailprice | numerik | 155 |
De_dateFirStavailable | Tanggal | 428 |
De_datelastavailable | Tanggal | 1176 |
tinggi | numerik | 241 |
lebar | numerik | 286 |
kedalaman | numerik | 279 |
berat | numerik | 1046 |
Thumbnailurl | karakter | 17420 |
ImageUrl | karakter | 17420 |
Harap dicatat bahwa proyek Brickset dirilis dengan Kode Etik Kontributor. Dengan berkontribusi pada proyek ini, Anda setuju untuk mematuhi persyaratannya.