diff --git a/README.Rmd b/README.Rmd index 1a6399e3..b3d86e6b 100644 --- a/README.Rmd +++ b/README.Rmd @@ -26,15 +26,15 @@ options(tibble.print_min = 5, tibble.print_max = 5) ## Introduction -Tidygeocoder makes getting data from geocoding services easy. The currently supported services are the [US Census geocoder](https://geocoding.geo.census.gov/), [Nominatim (OSM)](https://nominatim.org), [Geocodio](https://www.geocod.io/), and [Location IQ](https://locationiq.com/). In addition to the usage example below, you can find a blog post on geocoding landmarks in Washington, DC [here](https://jessecambon.github.io/2019/11/11/tidygeocoder-demo.html). +Tidygeocoder makes getting data from geocoder services easy. In addition to the usage example below, you can find a blog post on geocoding landmarks in Washington, DC [here](https://jessecambon.github.io/2019/11/11/tidygeocoder-demo.html). All results are returned in [tibble format](https://tibble.tidyverse.org/). Batch geocoding (geocoding multiple addresses per query) is used by default for the US Census and Geocodio services when multiple addresses are provided. Duplicate, missing/NA, and blank address data is handled elegantly - only unique addresses are passed to geocoder services, but the rows in the original data are preserved. ## Geocoder Services -The Census geocoder is restricted to street-level addresses in the United States, Geocodio covers the U.S. and Canada, while Location IQ and OSM have worldwide coverage. The Census and OSM services support batch geocoding while Location IQ and OSM do not. +The currently supported services are the [US Census geocoder](https://geocoding.geo.census.gov/), [Nominatim (OSM)](https://nominatim.org), [Geocodio](https://www.geocod.io/), and [Location IQ](https://locationiq.com/). The Census geocoder is restricted to street-level addresses in the United States, Geocodio covers the U.S. and Canada, while Location IQ and OSM have worldwide coverage. The Census and OSM services support batch geocoding (Location IQ and OSM do not). -The Census and OSM services are free while both Geocodio and Location IQ are commercial services that require API keys, but also offer free usage tiers. OSM and Location IQ both have usage frequency limits. Refer to the websites and documentation of the geocoder services for more details. +The Census and OSM services are free; Geocodio and Location IQ are commercial services that require API keys, but also offer free usage tiers. OSM and Location IQ both have usage frequency limits. Refer to the documentation of each service for more details. ## Installation diff --git a/README.md b/README.md index d91f7b42..e58c4df7 100644 --- a/README.md +++ b/README.md @@ -13,12 +13,9 @@ MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/je ## Introduction -Tidygeocoder makes getting data from geocoding services easy. The -currently supported services are the [US Census -geocoder](https://geocoding.geo.census.gov/), [Nominatim -(OSM)](https://nominatim.org), [Geocodio](https://www.geocod.io/), and -[Location IQ](https://locationiq.com/). In addition to the usage example -below, you can find a blog post on geocoding landmarks in Washington, DC +Tidygeocoder makes getting data from geocoder services easy. In addition +to the usage example below, you can find a blog post on geocoding +landmarks in Washington, DC [here](https://jessecambon.github.io/2019/11/11/tidygeocoder-demo.html). All results are returned in [tibble @@ -31,16 +28,19 @@ data are preserved. ## Geocoder Services -The Census geocoder is restricted to street-level addresses in the -United States, Geocodio covers the U.S. and Canada, while Location IQ -and OSM have worldwide coverage. The Census and OSM services support -batch geocoding while Location IQ and OSM do not. - -The Census and OSM services are free while both Geocodio and Location IQ -are commercial services that require API keys, but also offer free usage +The currently supported services are the [US Census +geocoder](https://geocoding.geo.census.gov/), [Nominatim +(OSM)](https://nominatim.org), [Geocodio](https://www.geocod.io/), and +[Location IQ](https://locationiq.com/). The Census geocoder is +restricted to street-level addresses in the United States, Geocodio +covers the U.S. and Canada, while Location IQ and OSM have worldwide +coverage. The Census and OSM services support batch geocoding (Location +IQ and OSM do not). + +The Census and OSM services are free; Geocodio and Location IQ are +commercial services that require API keys, but also offer free usage tiers. OSM and Location IQ both have usage frequency limits. Refer to -the websites and documentation of the geocoder services for more -details. +the documentation of each service for more details. ## Installation diff --git a/docs/articles/tidygeocoder.html b/docs/articles/tidygeocoder.html index 6a2a9523..029447f9 100644 --- a/docs/articles/tidygeocoder.html +++ b/docs/articles/tidygeocoder.html @@ -115,7 +115,7 @@

#> benchmark : "Public_AR_Current" #> vintage : "Current_Current" #> -#> Query completed in: 1 seconds +#> Query completed in: 1.4 seconds #> # A tibble: 2 x 3 #> singlelineaddress lat long #> <chr> <dbl> <dbl> @@ -211,7 +211,7 @@

#> benchmark : "Public_AR_Current" #> vintage : "Current_Current" #> -#> Query completed in: 1.6 seconds +#> Query completed in: 1.3 seconds knitr::kable(duplicates_geocoded) @@ -300,7 +300,7 @@

#> polygon_geojson : "1" #> format : "json" #> -#> Query completed in: 0.4 seconds +#> Query completed in: 0.6 seconds #> Total query time (including sleep): 1 seconds #> glimpse(cairo_geo) diff --git a/docs/index.html b/docs/index.html index 1918cc3a..9732f0b0 100644 --- a/docs/index.html +++ b/docs/index.html @@ -78,14 +78,14 @@

Introduction

-

Tidygeocoder makes getting data from geocoding services easy. The currently supported services are the US Census geocoder, Nominatim (OSM), Geocodio, and Location IQ. In addition to the usage example below, you can find a blog post on geocoding landmarks in Washington, DC here.

+

Tidygeocoder makes getting data from geocoder services easy. In addition to the usage example below, you can find a blog post on geocoding landmarks in Washington, DC here.

All results are returned in tibble format. Batch geocoding (geocoding multiple addresses per query) is used by default for the US Census and Geocodio services when multiple addresses are provided. Duplicate, missing/NA, and blank address data is handled elegantly - only unique addresses are passed to geocoder services, but the rows in the original data are preserved.

Geocoder Services

-

The Census geocoder is restricted to street-level addresses in the United States, Geocodio covers the U.S. and Canada, while Location IQ and OSM have worldwide coverage. The Census and OSM services support batch geocoding while Location IQ and OSM do not.

-

The Census and OSM services are free while both Geocodio and Location IQ are commercial services that require API keys, but also offer free usage tiers. OSM and Location IQ both have usage frequency limits. Refer to the websites and documentation of the geocoder services for more details.

+

The currently supported services are the US Census geocoder, Nominatim (OSM), Geocodio, and Location IQ. The Census geocoder is restricted to street-level addresses in the United States, Geocodio covers the U.S. and Canada, while Location IQ and OSM have worldwide coverage. The Census and OSM services support batch geocoding (Location IQ and OSM do not).

+

The Census and OSM services are free; Geocodio and Location IQ are commercial services that require API keys, but also offer free usage tiers. OSM and Location IQ both have usage frequency limits. Refer to the documentation of each service for more details.

diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml index 83740a9c..29b051e2 100644 --- a/docs/pkgdown.yml +++ b/docs/pkgdown.yml @@ -3,7 +3,7 @@ pkgdown: 1.5.1 pkgdown_sha: ~ articles: tidygeocoder: tidygeocoder.html -last_built: 2020-07-14T19:25Z +last_built: 2020-07-14T20:28Z urls: reference: https://jessecambon.github.io/tidygeocoder/reference article: https://jessecambon.github.io/tidygeocoder/articles diff --git a/docs/reference/figures/README-unnamed-chunk-6-1.png b/docs/reference/figures/README-unnamed-chunk-6-1.png index e7aaa321..8222c9f9 100644 Binary files a/docs/reference/figures/README-unnamed-chunk-6-1.png and b/docs/reference/figures/README-unnamed-chunk-6-1.png differ diff --git a/man/figures/README-unnamed-chunk-6-1.png b/man/figures/README-unnamed-chunk-6-1.png index e7aaa321..8222c9f9 100644 Binary files a/man/figures/README-unnamed-chunk-6-1.png and b/man/figures/README-unnamed-chunk-6-1.png differ