heatmapGoogleMaps: Create a heatmap visualization of spatial data points on...

Description Usage Arguments Value Author(s) See Also Examples

Description

Creates a htm file to visualize data in SpatialPointsDataFrames as a Google Maps heatmap. Heatmaps can be based upon the number of points in a geographic area (default) or weighted by a field in the supplied SpatialPointsDataFrame.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
heatmapGoogleMaps(SP, 
                  filename = '',
                  zcol = 1,
                  add = FALSE, 
                  previousMap = NULL,
                  weightedColumn=NULL,
                  excludeZeroWeights=TRUE,
                  heatmapDissipating=FALSE,
                  heatmapRadius=.5,
                  heatmapGradient=NULL,
                  map.width="100%",
                  map.height="100%",
                  layerName="",
                  layerNameEnabled = TRUE,
                  layerGroupName = FALSE,
                  control.width="100%",
                  control.height="100%",
                  zoom = 15, 
                  fitBounds = TRUE,
                  mapTypeId = 'HYBRID', 
                  disableDoubleClickZoom = FALSE, 
                  draggable = TRUE, 
                  keyboardShortcuts = TRUE, 
                  mapTypeControlOptions = 'DEFAULT',
                  navigationControl = TRUE,
                  navigationControlOptions = 'DEFAULT', 
                  scaleControlOptions = 'STANDARD',
                  noClear = FALSE,
                  scrollwheel = TRUE, 
                  streetViewControl = FALSE,
                  control=TRUE,
                  map = "map",
                  mapCanvas = "map_canvas",
                  css = "",                                     
                  api="https://maps.googleapis.com/maps/api/js?libraries=visualization",
                  openMap = TRUE,
                  trafficLayerEnabled = NULL,
                  trafficLayerName = "Traffic",
                  transitLayerEnabled = NULL,
                  transitLayerName = "Transit",
                  bicycleLayerEnabled = NULL,
                  bicycleLayerName = "Bicycle",
                  ...) 

Arguments

SP

object of Spatial-class with associated coordinate reference systems

filename

the name of the output htm or html file. If filename is not defined the function creates temporary file.

zcol

variable column name, or column number after removing spatial coordinates from x@data: 1 refers to the first non-coordinate column

add

logical; if TRUE the result of the function will be a list stored as variable in the R. It is possible to combine more layers in the one plot, previously saved output from plotGoogleMaps should be given in the previousMap attribute.

previousMap

previously saved variable from plotGoogleMaps or bubbleGoogleMaps when attribute add is TRUE. It is solution for combining more than one layers in the one plot.

weightedColumn

column name to use for heatmap weights or NULL to just use lat-long points for heatmap

excludeZeroWeights

logical; if TRUE zero values are excluded from weightedColumn

heatmapDissipating

logical; specifies whether heatmaps dissipate on zoom. When dissipating is false the radius of influence increases with zoom level to ensure that the color intensity is preserved at any given geographic location. Defaults to false. (Source: Google heatmap API documentation)

heatmapRadius

the radius of influence for each data point, in pixels (Source: Google heatmap API documentation)

heatmapGradient

NULL to use Google default gradient colors or a vector of gradient colors to use: first color for areas of lowest intensity, last color for areas of highest density

map.width

the width of the map. Can be in percent or in pixels (px)

map.height

the height of the map. Can be in percent or in pixels (px)

layerName

the name of the layer. Layer name appears on the check box for switching layer of and on in output htm.

layerNameEnabled

controls whether the layer is enabled (shown) when the map is loaded. Default is TRUE

layerGroupName

character string to show above control in legend. Useful for identifying groups of map layers. Default is FALSE to indicate no grouping text to display

control.width

the width of the part of htm for controlling layer (legend, opacity,...) Can be in percent or in pixels (px).

control.height

the height of the part of htm for controlling layer (legend, opacity,...) Can be in percent or in pixels (px).

zoom

the initial Map zoom level.Zoom levels between 0 (the lowest zoom level, in which the entire world can be seen on one map) to 19 (the highest zoom level, down to individual buildings) are possible within the normal maps view. Argument fitBounds should be FALSE.

fitBounds

sets the maps to fit to the boundary box values of sp object

mapTypeId

the initial Map mapTypeId. 'HYBRID' - map type displays a transparent layer of major streets on satellite images. 'ROADMAP' - map type displays a normal street map. 'SATELLITE' - map type displays satellite images. 'TERRAIN' - map type displays maps with physical features such as terrain and vegetation.

disableDoubleClickZoom

enables or disables zoom and center on double click.

draggable

if FALSE, prevents the map from being dragged

keyboardShortcuts

if FALSE, prevents the map from being controlled by the keyboard.

mapTypeControlOptions

the initial display options for the Map type control. 'DEFAULT' - uses the default map type control. 'DROPDOWN_MENU' - a dropdown menu for the screen realestate conscious. 'HORIZONTAL_BAR' - the standard horizontal radio buttons bar.

navigationControl

enabled or disabled state of the navigation control

navigationControlOptions

the initial display options for the navigation control. 'ANDROID' - the small zoom control similar to the one used by the native Maps application on Android. 'DEFAULT' - the default navigation control. The control which DEFAULT maps to will vary according to map size and other factors. It may change in future versions of the API. 'SMALL' - the small, zoom only control. 'ZOOM_PAN' - the larger control, with the zoom slider and pan directional pad.

scaleControlOptions

the initial display options for the scale control.

noClear

if TRUE, do not clear the contents of the Map div.

scrollwheel

if FALSE, disables scrollwheel zooming on the map.

streetViewControl

The initial enabled or disabled state of the Street View pegman control

control

if FALSE, disables control.

map

name of map object in JavaScript

mapCanvas

name of map DIV element

css

CSS for mapCanvas and cBoxes

api

see https://developers.google.com/maps/documentation/javascript/tutorial

openMap

if TRUE map is opened by default browser

trafficLayerEnabled

If TRUE, display current traffic conditions. If NULL (default), do not add traffic map layer (for backwards compatibility)

trafficLayerName

Layer name to use for traffic layer in map legend. Default is "Traffic". Has no effect if trafficLayerEnabled is NULL

transitLayerEnabled

If TRUE, display transit map layer. If NULL (default), do not add transit map layer (for backwards compatibility)

transitLayerName

Layer name to use for transit layer in map legend. Default is "Transit". Has no effect if transitLayerEnabled is NULL

bicycleLayerEnabled

If TRUE, display bicycle map layer. If NULL (default), do not add bicycle map layer (for backwards compatibility)

bicycleLayerName

Layer name to use for bicycle layer in map legend. Default is "Bicycle". Has no effect if bicycleLayerEnabled is NULL

...

optional arguments

Value

This function returns a list with HTML, JavaScript, Google Maps API key and else what is necessary for the final web map. The second output is html file ready to use.

Author(s)

Milan Kilibarda <kili@grf.bg.ac.rs>, Dan Cheng <dan.cheng@insightanalyticsinc.com>

See Also

bubbleGoogleMaps, ellipseGoogleMaps, plotGoogleMaps, segmentGoogleMaps, symbolGoogleMaps

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
# Data preparation
# Point data
data(meuse)
require(maptools)
coordinates(meuse)<-~x+y
proj4string(meuse) <- CRS('+init=epsg:28992')

# Create heat map of point data based upon the number of cadmium
# observations
m<-heatmapGoogleMaps(meuse,heatmapRadius = .003,zcol = "cadmium") 

# Create heat map of point data weighted by cadmium values
m<-heatmapGoogleMaps(meuse,heatmapRadius = .003,weightedColumn = "cadmium") 

plotGoogleMaps documentation built on May 2, 2019, 5:45 p.m.