googleVis (version 0.4.4)

gvisMap: Google Maps with R

Description

The gvisMap function reads a data.frame and creates text output referring to the Google Visualisation API, which can be included into a web page, or as a stand-alone page. The maps are the well known Google Maps.

Usage

gvisMap(data, locationvar='', tipvar='',
           options = list(), chartid)

Arguments

data

a data.frame. The data has to have at least two columns with location name (locationvar) and the variable to display the text in the tip icon (tipvar).

locationvar

column name of data with the geo locations to be analysed. The locations can be provide in two formats: [object Object],[object Object]

tipvar

column name of data with the string text displayed over the tip icon.

options

list of configuration options for Google Map. [object Object] Further possible components are, taken from https://google-developers.appspot.com/chart/interactive/docs/gallery/map.html#Configuration_Options: [object Obje

chartid

character. If missing (default) a random chart id will be generated based on chart type and tempfile

Value

• gvisMap returns list of class "gvis" and "list". An object of class "gvis" is a list containing at least the following components:
• type
  Google visualisation type, here 'Map'
• chartid
  character id of the chart object. Unique chart ids are required to place several charts on the same page.
• html
  a list with the building blocks for a page [object Object],[object Object],[object Object],[object Object]

References

Google Map API: https://google-developers.appspot.com/chart/interactive/docs/gallery/map.html

Follow the link for Google's data policy.

See Also

See also print.gvis, plot.gvis for printing and plotting methods, gvisGeoMap and gvisIntensityMap for an alternative to gvisMap. Further the packages:

• R2GoogleMaps: Provides a mechanism to generate JavaScript code from R that displays data using Google Maps,http://www.omegahat.org/R2GoogleMaps/.
• RgoogleMaps: Overlays on Google map tiles in R,http://cran.r-project.org/web/packages/RgoogleMaps/index.html,
• plotGoogleMaps: Plot HTML output with Google Maps API and your own data,http://cran.r-project.org/web/packages/plotGoogleMaps/.

Examples

## Please note that by default the googleVis plot command
## will open a browser window and requires Internet
## connection to display the visualisation.
  
## Example with latitude and longitude information
## Plot Hurricane Andrew (1992) storm path:

data(Andrew)

M1 <- gvisMap(Andrew, "LatLong" , "Tip",
              options=list(showTip=TRUE, showLine=TRUE, enableScrollWheel=TRUE,
                           mapType='hybrid', useMapTypeControl=TRUE,
                           width=800,height=400))

plot(M1) 


## Example with address, here UK post-code and some html code in tooltip

df <- data.frame(Postcode=c("EC3M 7HA", "EC2P 2EJ"),
                 Tip=c("<a href='http://www.lloyds.com'>Lloyd's</a>", 
                 "<a href='http://www.guildhall.cityoflondon.gov.uk/'>Guildhall</a>"))
 
M2 <- gvisMap(df, "Postcode", "Tip",
              options=list(showTip=TRUE, mapType='normal',
              enableScrollWheel=TRUE))
 
plot(M2)