diff --git a/DESCRIPTION b/DESCRIPTION index abc90d1f..4026a933 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: tidygeocoder Type: Package Title: Geocoding Made Easy -Version: 1.0.4.9000 +Version: 1.0.5 Authors@R: c(person(given = "Jesse", family = "Cambon", diff --git a/README.md b/README.md index bf4f3229..c490ae87 100644 --- a/README.md +++ b/README.md @@ -81,7 +81,7 @@ some_addresses <- tribble( lat_longs <- some_addresses %>% geocode(addr, method = 'osm', lat = latitude , long = longitude) #> Passing 3 addresses to the Nominatim single address geocoder -#> Query completed in: 3 seconds +#> Query completed in: 3.6 seconds ``` The `geocode()` function geocodes addresses contained in a dataframe. @@ -96,7 +96,7 @@ documentation for details. |:---------------------|:-------------------------------------------|---------:|-----------:| | White House | 1600 Pennsylvania Ave NW, Washington, DC | 38.89770 | -77.03655 | | Transamerica Pyramid | 600 Montgomery St, San Francisco, CA 94111 | 37.79520 | -122.40279 | -| Willis Tower | 233 S Wacker Dr, Chicago, IL 60606 | 41.87887 | -87.63591 | +| Willis Tower | 233 S Wacker Dr, Chicago, IL 60606 | 41.87535 | -87.63576 | Now that we have the longitude and latitude coordinates, we can use ggplot to plot our addresses on a map. @@ -137,11 +137,11 @@ reverse <- lat_longs %>% #> Query completed in: 3 seconds ``` -| name | latitude | longitude | address\_found | place\_id | osm\_type | osm\_id | osm\_lat | osm\_lon | office | house\_number | road | city | state | postcode | country | country\_code | boundingbox | tourism | neighbourhood | county | building | suburb | -|:---------------------|---------:|-----------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------|----------:|:----------|----------:|:-------------------|:--------------------|:------------|:--------------|:------------------------------|:--------------|:---------------------|:---------|:--------------|:--------------|:-----------------------------------------------------|:---------------------|:--------------|:--------------|:-------------|:-------| -| White House | 38.89770 | -77.03655 | White House, 1600, Pennsylvania Avenue Northwest, Washington, District of Columbia, 20500, United States | 147370996 | way | 238241022 | 38.897699700000004 | -77.03655315 | White House | 1600 | Pennsylvania Avenue Northwest | Washington | District of Columbia | 20500 | United States | us | 38.8974908 , 38.897911 , -77.0368537, -77.0362519 | NA | NA | NA | NA | NA | -| Transamerica Pyramid | 37.79520 | -122.40279 | Transamerica Pyramid, 600, Montgomery Street, Chinatown, San Francisco, San Francisco City and County, San Francisco, California, 94111, United States | 95364489 | way | 24222973 | 37.795200550000004 | -122.40279267840137 | NA | 600 | Montgomery Street | San Francisco | California | 94111 | United States | us | 37.7948854 , 37.7954472 , -122.4031399, -122.4024317 | Transamerica Pyramid | Chinatown | San Francisco | NA | NA | -| Willis Tower | 41.87887 | -87.63591 | Willis Tower, 233, South Wacker Drive, Printer’s Row, Loop, Chicago, Cook County, Illinois, 60606, United States | 103673983 | way | 58528804 | 41.878871700000005 | -87.63590893936448 | NA | 233 | South Wacker Drive | Chicago | Illinois | 60606 | United States | us | 41.8785389 , 41.8791932 , -87.6363362, -87.6354746 | NA | Printer’s Row | Cook County | Willis Tower | Loop | +| name | latitude | longitude | address\_found | place\_id | osm\_type | osm\_id | osm\_lat | osm\_lon | office | house\_number | road | city | state | postcode | country | country\_code | boundingbox | tourism | neighbourhood | county | suburb | +|:---------------------|---------:|-----------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------|----------:|:----------|----------:|:-------------------|:--------------------|:------------|:--------------|:------------------------------|:--------------|:---------------------|:---------|:--------------|:--------------|:-----------------------------------------------------|:---------------------|:--------------|:--------------|:-------| +| White House | 38.89770 | -77.03655 | White House, 1600, Pennsylvania Avenue Northwest, Washington, District of Columbia, 20500, United States | 159859857 | way | 238241022 | 38.897699700000004 | -77.03655315 | White House | 1600 | Pennsylvania Avenue Northwest | Washington | District of Columbia | 20500 | United States | us | 38.8974908 , 38.897911 , -77.0368537, -77.0362519 | NA | NA | NA | NA | +| Transamerica Pyramid | 37.79520 | -122.40279 | Transamerica Pyramid, 600, Montgomery Street, Chinatown, San Francisco, San Francisco City and County, San Francisco, California, 94111, United States | 106590650 | way | 24222973 | 37.795200550000004 | -122.40279267840137 | NA | 600 | Montgomery Street | San Francisco | California | 94111 | United States | us | 37.7948854 , 37.7954472 , -122.4031399, -122.4024317 | Transamerica Pyramid | Chinatown | San Francisco | NA | +| Willis Tower | 41.87535 | -87.63576 | South Wacker Drive, Printer’s Row, Loop, Chicago, Cook County, Illinois, 60606, United States | 182316972 | way | 337681342 | 41.8753503 | -87.6357587 | NA | NA | South Wacker Drive | Chicago | Illinois | 60606 | United States | us | 41.8749718 , 41.8757997 , -87.6361005, -87.6354602 | NA | Printer’s Row | Cook County | Loop | ## In the Wild @@ -193,22 +193,22 @@ citation('tidygeocoder') Cambon J, Hernangómez D, Belanger C, Possenriede D (2021). tidygeocoder: An R package for geocoding. Journal of Open Source Software, 6(65), 3544, https://doi.org/10.21105/joss.03544 (R package - version 1.0.4) + version 1.0.5) A BibTeX entry for LaTeX users is @Article{, title = {tidygeocoder: An R package for geocoding}, author = {Jesse Cambon and Diego Hernangómez and Christopher Belanger and Daniel Possenriede}, - doi = {10.21105/joss.03544}, - url = {https://doi.org/10.21105/joss.03544}, + year = {2021}, journal = {Journal of Open Source Software}, publisher = {The Open Journal}, - year = {2021}, + doi = {10.21105/joss.03544}, + url = {https://doi.org/10.21105/joss.03544}, volume = {6}, number = {65}, pages = {3544}, - note = {R package version 1.0.4}, + note = {R package version 1.0.5}, } diff --git a/_pkgdown.yml b/_pkgdown.yml index 9d74a1a8..149f2548 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -40,7 +40,9 @@ reference: - extract_results - extract_reverse_results - title: Deprecated Functions - desc: Use `geo()` instead. + desc: + Deprecated lifecycle + Use `geo()` instead contents: - geo_census - geo_osm diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html index a7364ece..bac665ea 100644 --- a/docs/LICENSE-text.html +++ b/docs/LICENSE-text.html @@ -87,7 +87,7 @@ tidygeocoder - 1.0.4.9000 + 1.0.5 diff --git a/docs/LICENSE.html b/docs/LICENSE.html index e1813410..8d237a5c 100644 --- a/docs/LICENSE.html +++ b/docs/LICENSE.html @@ -87,7 +87,7 @@ tidygeocoder - 1.0.4.9000 + 1.0.5 diff --git a/docs/authors.html b/docs/authors.html index 9094e673..729305dc 100644 --- a/docs/authors.html +++ b/docs/authors.html @@ -87,7 +87,7 @@ tidygeocoder - 1.0.4.9000 + 1.0.5 @@ -174,19 +174,19 @@

Citation

Source: inst/CITATION -

Cambon J, Hernangómez D, Belanger C, Possenriede D (2021). tidygeocoder: An R package for geocoding. Journal of Open Source Software, 6(65), 3544, https://doi.org/10.21105/joss.03544 (R package version 1.0.4)

+

Cambon J, Hernangómez D, Belanger C, Possenriede D (2021). tidygeocoder: An R package for geocoding. Journal of Open Source Software, 6(65), 3544, https://doi.org/10.21105/joss.03544 (R package version 1.0.5)

@Article{,
   title = {tidygeocoder: An R package for geocoding},
   author = {Jesse Cambon and Diego Hernangómez and Christopher Belanger and Daniel Possenriede},
-  doi = {10.21105/joss.03544},
-  url = {https://doi.org/10.21105/joss.03544},
+  year = {2021},
   journal = {Journal of Open Source Software},
   publisher = {The Open Journal},
-  year = {2021},
+  doi = {10.21105/joss.03544},
+  url = {https://doi.org/10.21105/joss.03544},
   volume = {6},
   number = {65},
   pages = {3544},
-  note = {R package version 1.0.4},
+  note = {R package version 1.0.5},
 }
@@ -168,7 +168,7 @@

lat_longs <- some_addresses %>% geocode(addr, method = 'osm', lat = latitude , long = longitude) #> Passing 3 addresses to the Nominatim single address geocoder -#> Query completed in: 3 seconds +#> Query completed in: 3.6 seconds

The geocode() function geocodes addresses contained in a dataframe. The Nominatim (“osm”) geocoding service is used here, but other services can be specified with the method argument. Only latitude and longitude are returned from the geocoding service in this example, but full_results = TRUE can be used to return all of the data from the geocoding service. See the geo() function documentation for details.

@@ -199,8 +199,8 @@

- - + +
Willis Tower 233 S Wacker Dr, Chicago, IL 6060641.87887-87.6359141.87535-87.63576
@@ -232,12 +232,12 @@

- + - + @@ -250,7 +250,6 @@

- @@ -275,7 +274,6 @@

tourism neighbourhood county -building suburb @@ -284,7 +282,7 @@

38.89770 -77.03655 White House, 1600, Pennsylvania Avenue Northwest, Washington, District of Columbia, 20500, United States -147370996 +159859857 way 238241022 38.897699700000004 @@ -302,14 +300,13 @@

NA NA NA -NA Transamerica Pyramid 37.79520 -122.40279 Transamerica Pyramid, 600, Montgomery Street, Chinatown, San Francisco, San Francisco City and County, San Francisco, California, 94111, United States -95364489 +106590650 way 24222973 37.795200550000004 @@ -327,31 +324,29 @@

Chinatown San Francisco NA -NA Willis Tower -41.87887 --87.63591 -Willis Tower, 233, South Wacker Drive, Printer’s Row, Loop, Chicago, Cook County, Illinois, 60606, United States -103673983 +41.87535 +-87.63576 +South Wacker Drive, Printer’s Row, Loop, Chicago, Cook County, Illinois, 60606, United States +182316972 way -58528804 -41.878871700000005 --87.63590893936448 +337681342 +41.8753503 +-87.6357587 +NA NA -233 South Wacker Drive Chicago Illinois 60606 United States us -41.8785389 , 41.8791932 , -87.6363362, -87.6354746 +41.8749718 , 41.8757997 , -87.6361005, -87.6354602 NA Printer’s Row Cook County -Willis Tower Loop @@ -392,22 +387,22 @@

Cambon J, Hernangómez D, Belanger C, Possenriede D (2021). tidygeocoder: An R package for geocoding. Journal of Open Source Software, 6(65), 3544, https://doi.org/10.21105/joss.03544 (R package - version 1.0.4) + version 1.0.5) A BibTeX entry for LaTeX users is @Article{, title = {tidygeocoder: An R package for geocoding}, author = {Jesse Cambon and Diego Hernangómez and Christopher Belanger and Daniel Possenriede}, - doi = {10.21105/joss.03544}, - url = {https://doi.org/10.21105/joss.03544}, - journal = {Journal of Open Source Software}, - publisher = {The Open Journal}, - year = {2021}, + year = {2021}, + journal = {Journal of Open Source Software}, + publisher = {The Open Journal}, + doi = {10.21105/joss.03544}, + url = {https://doi.org/10.21105/joss.03544}, volume = {6}, number = {65}, pages = {3544}, - note = {R package version 1.0.4}, + note = {R package version 1.0.5}, }

Or refer to the citation page.

diff --git a/docs/reference/figures/README-usamap-1.png b/docs/reference/figures/README-usamap-1.png index 5ec81673..24297933 100644 Binary files a/docs/reference/figures/README-usamap-1.png and b/docs/reference/figures/README-usamap-1.png differ diff --git a/docs/reference/geo.html b/docs/reference/geo.html index cb6563da..6a711286 100644 --- a/docs/reference/geo.html +++ b/docs/reference/geo.html @@ -99,7 +99,7 @@ tidygeocoder - 1.0.4.9000 + 1.0.5 @@ -468,21 +468,21 @@

Examp
# \donttest{ geo(street = "600 Peachtree Street NE", city = "Atlanta", state = "Georgia", method = "census") -
#> Passing 1 address to the US Census single address geocoder
#> Query completed in: 5.6 seconds
#> # A tibble: 1 × 5 +
#> Passing 1 address to the US Census single address geocoder
#>
#> [-------------------------------------] 0/1 ( 0%) Elapsed: 0s Remaining: ?s
#>
#> [=====================================] 1/1 (100%) Elapsed: 10s Remaining: 0s
#>
#> # A tibble: 1 × 5 #> street city state lat long #> <chr> <chr> <chr> <dbl> <dbl> #> 1 600 Peachtree Street NE Atlanta Georgia 33.8 -84.4
geo(address = c("Tokyo, Japan", "Lima, Peru", "Nairobi, Kenya"), method = 'osm') -
#> Passing 3 addresses to the Nominatim single address geocoder
#> Query completed in: 3 seconds
#> # A tibble: 3 × 3 +
#> Passing 3 addresses to the Nominatim single address geocoder
#>
#> [-------------------------------------] 0/3 ( 0%) Elapsed: 0s Remaining: ?s
#>
#> [===========>-------------------------] 1/3 ( 33%) Elapsed: 1s Remaining: 2s
#>
#> [========================>------------] 2/3 ( 67%) Elapsed: 2s Remaining: 1s
#>
#> [=====================================] 3/3 (100%) Elapsed: 3s Remaining: 0s
#>
#> # A tibble: 3 × 3 #> address lat long #> <chr> <dbl> <dbl> #> 1 Tokyo, Japan 35.7 140. -#> 2 Lima, Peru -12.1 -77.0 -#> 3 Nairobi, Kenya -1.30 36.8
+#> 2 Lima, Peru -12.0 -77.1 +#> 3 Nairobi, Kenya -1.28 36.8
geo("100 Main St New York, NY", full_results = TRUE, method = "census", api_options = list(census_return_type = 'geographies')) -
#> Passing 1 address to the US Census single address geocoder
#> Query completed in: 1.8 seconds
#> # A tibble: 1 × 28 +
#> Passing 1 address to the US Census single address geocoder
#>
#> [-------------------------------------] 0/1 ( 0%) Elapsed: 0s Remaining: ?s
#>
#> [=====================================] 1/1 (100%) Elapsed: 2s Remaining: 0s
#>
#> # A tibble: 1 × 28 #> address lat long matchedAddress tigerLine.tiger… tigerLine.side #> <chr> <dbl> <dbl> <chr> <chr> <chr> #> 1 100 Main St New York, NY 40.7 -74.0 100 MAIN ST, … 59662602 R @@ -495,7 +495,7 @@

Examp #> # addressComponents.state <chr>, addressComponents.zip <chr>, …

geo(county = 'Jefferson', state = "Kentucky", country = "US", method = 'osm') -
#> Passing 1 address to the Nominatim single address geocoder
#> Query completed in: 1 seconds
#> # A tibble: 1 × 5 +
#> Passing 1 address to the Nominatim single address geocoder
#>
#> [-------------------------------------] 0/1 ( 0%) Elapsed: 0s Remaining: ?s
#>
#> [=====================================] 1/1 (100%) Elapsed: 1s Remaining: 0s
#>
#> # A tibble: 1 × 5 #> county state country lat long #> <chr> <chr> <chr> <dbl> <dbl> #> 1 Jefferson Kentucky US 38.2 -85.7
# } diff --git a/docs/reference/index.html b/docs/reference/index.html index 906b70b3..dbad328a 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -87,7 +87,7 @@ tidygeocoder - 1.0.4.9000 + 1.0.5
@@ -352,7 +352,7 @@

Deprecated Functions

-

Use geo() instead.

+

Deprecated lifecycle Use geo() instead

diff --git a/docs/reference/reverse_geo.html b/docs/reference/reverse_geo.html index ab8a000c..a9e82bb8 100644 --- a/docs/reference/reverse_geo.html +++ b/docs/reference/reverse_geo.html @@ -98,7 +98,7 @@ tidygeocoder - 1.0.4.9000 + 1.0.5 @@ -401,7 +401,7 @@

See a

Examples

# \donttest{ reverse_geo(lat = 38.895865, long = -77.0307713, method = 'osm') -
#> Passing 1 coordinate to the Nominatim single coordinate geocoder
#> Query completed in: 1 seconds
#> # A tibble: 1 × 3 +
#> Passing 1 coordinate to the Nominatim single coordinate geocoder
#>
#> [-------------------------------------] 0/1 ( 0%) Elapsed: 0s Remaining: ?s
#>
#> [=====================================] 1/1 (100%) Elapsed: 1s Remaining: 0s
#>
#> # A tibble: 1 × 3 #> lat long address #> <dbl> <dbl> <chr> #> 1 38.9 -77.0 L’Enfant's plan, Pennsylvania Avenue, Washington, District of Col…
@@ -410,11 +410,11 @@

Examp long = c(-77.0307713, -79.3839347, 600), method = 'osm', full_results = TRUE ) -

#> Passing 2 coordinates to the Nominatim single coordinate geocoder
#> Query completed in: 2 seconds
#> # A tibble: 3 × 22 +
#> Passing 2 coordinates to the Nominatim single coordinate geocoder
#>
#> [-------------------------------------] 0/2 ( 0%) Elapsed: 0s Remaining: ?s
#>
#> [=================>-------------------] 1/2 ( 50%) Elapsed: 1s Remaining: 1s
#>
#> [=====================================] 2/2 (100%) Elapsed: 2s Remaining: 0s
#>
#> # A tibble: 3 × 22 #> lat long address place_id licence osm_type osm_id osm_lat osm_lon tourism #> <dbl> <dbl> <chr> <int> <chr> <chr> <int> <chr> <chr> <chr> -#> 1 38.9 -77.0 L’Enfan… 3.02e8 Data ©… way 9.00e8 38.895… -77.03… L’Enfa… -#> 2 43.7 -79.4 Toronto… 1.37e8 Data ©… way 1.99e8 43.653… -79.38… NA +#> 1 38.9 -77.0 L’Enfan… 2.71e8 Data ©… way 9.00e8 38.895… -77.03… L’Enfa… +#> 2 43.7 -79.4 Toronto… 1.48e8 Data ©… way 1.99e8 43.653… -79.38… NA #> 3 NA NA NA NA NA NA NA NA NA NA #> # … with 12 more variables: road <chr>, city <chr>, state <chr>, #> # postcode <chr>, country <chr>, country_code <chr>, boundingbox <list>, diff --git a/inst/CITATION b/inst/CITATION index f82a6f19..e9e58c25 100644 --- a/inst/CITATION +++ b/inst/CITATION @@ -1,6 +1,7 @@ # http://r-pkgs.had.co.nz/inst.html#inst-citation -version_note <- "R package version 1.0.4" +# IMPORTANT: update the version note before release +version_note <- "R package version 1.0.5" citHeader("To cite tidygeocoder use:") @@ -13,11 +14,11 @@ citEntry( person("Christopher", "Belanger"), person("Daniel", "Possenriede") ), - doi = "10.21105/joss.03544", - url = "https://doi.org/10.21105/joss.03544", + year = "2021", journal = "Journal of Open Source Software", publisher = "The Open Journal", - year = "2021", + doi = "10.21105/joss.03544", + url = "https://doi.org/10.21105/joss.03544", volume = "6", number = "65", pages = "3544", diff --git a/man/figures/README-usamap-1.png b/man/figures/README-usamap-1.png index 5ec81673..24297933 100644 Binary files a/man/figures/README-usamap-1.png and b/man/figures/README-usamap-1.png differ