mapdist: Compute map distances using Google

In fresques/ggmap: Spatial Visualization with ggplot2

Description

Compute map distances using Google Maps. Note that in most cases by using this function you are agreeing to the Google Maps API Terms of Service at https://developers.google.com/maps/terms.

Usage

mapdist(from, to, mode = c("driving", "walking", "bicycling", "transit"),
  output = c("simple", "all"), messaging = FALSE, language = "en-EN",
  urlonly = FALSE, override_limit = FALSE, ext = "com", inject = "",
  usingPlaceIDs = FALSE, ...)

Arguments

from	name of origin addresses in a data frame (vector accepted)
to	name of destination addresses in a data frame (vector accepted)
mode	driving, bicycling, or walking
output	amount of output
messaging	turn messaging on/off
language	language
urlonly	return only the url?
override_limit	override the current query count (.GoogleDistQueryCount)
ext	domain extension (e.g. "com", "co.nz")
inject	character string to add to the url
usingPlaceIDs	indicate that from and to fields contain placeIDs. Turns of URL encoding of addresses.
...	...

Details

if parameters from and to are specified as geographic coordinates, they are reverse geocoded with revgeocode. note that the google maps api limits to 2500 element queries a day.

mapdist now makes a single query to the mapdist api. The returned data frame will have length(from)*length(to) rows

Value

a data frame (output="simple") or all of the geocoded information (output="all")

Author(s)

David Kahle [e-mail]

See Also

http://code.google.com/apis/maps/documentation/distancematrix/

Examples

## Not run: # online queries draw R CMD check times

mapdist("waco, texas", "houston, texas")

from <- c("houston, texas", "dallas")
to <- "waco, texas"
mapdist(from, to)
mapdist(from, to, mode = "bicycling")
mapdist(from, to, mode = "walking")

# google requires a key for mode="transit"
register_google(key = "[your key here]")
from <- "city hall houston texas"
to <- "nrg stadium houston texas"
mapdist(from, to, mode = "transit")

from <- c("houston", "houston", "dallas")
to <- c("waco, texas", "san antonio", "houston")
mapdist(from, to)


# geographic coordinates are accepted as well
(wh <- as.numeric(geocode("the white house, dc")))
(lm <- as.numeric(geocode("lincoln memorial washington dc")))
mapdist(wh, lm, mode = "walking")
distQueryCheck()


## End(Not run)

fresques/ggmap documentation built on May 28, 2019, 8:40 p.m.