Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ropensci/geojsonio
Convert many data formats to & from GeoJSON & TopoJSON
https://github.com/ropensci/geojsonio
geojson io r r-package rstats topojson
Last synced: 3 days ago
JSON representation
Convert many data formats to & from GeoJSON & TopoJSON
- Host: GitHub
- URL: https://github.com/ropensci/geojsonio
- Owner: ropensci
- License: other
- Created: 2014-04-01T17:20:23.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2023-10-25T15:12:42.000Z (about 1 year ago)
- Last Synced: 2024-10-11T17:50:09.792Z (23 days ago)
- Topics: geojson, io, r, r-package, rstats, topojson
- Language: R
- Homepage: https://docs.ropensci.org/geojsonio
- Size: 4.71 MB
- Stars: 151
- Watchers: 14
- Forks: 59
- Open Issues: 9
-
Metadata Files:
- Readme: README.Rmd
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# geojsonio
[](https://github.com/ropensci/geojsonio/actions?query=workflow%3AR-CMD-check)
[](https://cran.r-project.org/web/checks/check_results_geojsonio.html)
[](https://app.codecov.io/github/ropensci/geojsonio?branch=main)
[](https://github.com/r-hub/cranlogs.app)
[](https://cran.r-project.org/package=geojsonio)
[](https://www.repostatus.org/#inactive)
```{r echo=FALSE}
library("knitr")
hook_output <- knitr::knit_hooks$get("output")
knitr::knit_hooks$set(output = function(x, options) {
lines <- options$output.lines
if (is.null(lines)) {
return(hook_output(x, options)) # pass to default hook
}
x <- unlist(strsplit(x, "\n"))
more <- "..."
if (length(lines)==1) { # first n lines
if (length(x) > lines) {
# truncate the output, but add ....
x <- c(head(x, lines), more)
}
} else {
x <- c(if (abs(lines[1])>1) more else NULL,
x[lines],
if (length(x)>lines[abs(length(lines))]) more else NULL
)
}
# paste these lines together
x <- paste(c(x, ""), collapse = "\n")
hook_output(x, options)
})
knitr::opts_chunk$set(
comment = "#>",
collapse = TRUE,
warning = FALSE,
message = FALSE,
eval = FALSE
)
```
__Convert various data formats to GeoJSON or TopoJSON__
This package is a utility to convert geographic data to GeoJSON and TopoJSON formats. Nothing else. We hope to do this one job very well, and handle all reasonable use cases.
Functions in this package are organized first around what you're working with or want to get, GeoJSON or TopoJSON, then convert to or read from various formats:
* `geojson_list()`/`topojson_list()` - convert to GeoJSON/TopoJSON as R list format
* `geojson_json()`/`topojson_json()` - convert to GeoJSON/TopoJSON as JSON
* `geojson_sp()` - convert output of `geojson_list()` or `geojson_json()` to `sp` spatial objects
* `geojson_sf()` - convert output of `geojson_list()` or `geojson_json()` to `sf` objects
* `geojson_read()`/`topojson_read()` - read a GeoJSON/TopoJSON file from file path or URL
* `geojson_write()`/`topojson_write()` - write a GeoJSON/TopoJSON file locally
Each of the above functions have methods for various objects/classes, including `numeric`, `data.frame`, `list`, `SpatialPolygons`, `SpatialLines`, `SpatialPoints`, etc.
Additional functions:
* `map_gist()` - push up a GeoJSON or topojson file as a GitHub gist (renders as an interactive map)
* `map_leaf()` - create a local interactive map using the `leaflet` package
## \*json Info
* GeoJSON - [spec](https://www.rfc-editor.org/rfc/rfc7946)
* [GeoJSON lint](https://geojsonlint.com/)
* TopoJSON - [spec](https://github.com/topojson/topojson-specification/blob/master/README.md)
## Install
_Mac_
Install `GDAL` on the command line first, e.g., using `homebrew`
```
brew install gdal
```
_Linux_
Get deps first
```{r}
#| echo: true
#| eval: true
remotes::system_requirements("ubuntu", "20.04", package = "geojsonio")
```
__Install geojsonio__
Stable version from CRAN
```{r}
install.packages("geojsonio")
```
Or development version from GitHub
```{r}
install.packages("remotes")
remotes::install_github("ropensci/geojsonio")
```
```{r}
library("geojsonio")
```
## What's the future of geojsonio?
geojsonio is stable and we expect it to stay on CRAN. The package is a
dependency for a number of other packages and is downloaded tens of thousands
of times per month; moving forward the priority with this package is to make
sure that those packages and users are able to keep using the package.
That said, we do not anticipate much further development; there will not likely
be many major new features added or new interfaces developed. We'll avoid
making breaking changes as much as possible.
If you find bugs in geojsonio or want to contribute new features: please feel
free to submit PRs! So long as the existing interface stays intact, we'd be
more than happy to make the package more useful for you. That said, we don't
anticipate being particularly responsive to feature requests
(without a matching PR) moving forward.
## Meta
* Please [report any issues or bugs](https://github.com/ropensci/geojsonio/issues).
* License: MIT
* Get citation information for `geojsonio` in R doing `citation(package = 'geojsonio')`
* Please note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/). By contributing to this project, you agree to abide by its terms.