Package geoplot. February 15, 2013

Transcription

1 Type Package Package geoplot February 15, 2013 Title Geocodes street or ip addresses and plots them on a map. Version 2.1 Date Author Maintainer <> Depends R(>= ), rjson, RgoogleMaps There are 4 primary functions and RgoogleMaps and rjson are dependencies. This package resolves street address to point and bo coordinates, resolves ip address to point coordinates, plot resolved points on specified Google maps and determine distance between 2 points in km or mi using haversine formula. License GPL-2 LazyLoad yes Repository CRAN Date/Publication :18:55 NeedsCompilation no R topics documented: geoplot-package addrlistlookup degrees2radians geoaddress geoip geoplot haversine iplistlookup Inde 11 1

2 2 geoplot-package geoplot-package Geocodes street address or ip address, plots on Google map, determines distance between 2 points. There are 4 primary functions: 1) Resolve street address to point and bo coordinates. 2) Resolve ip address to point coordinates. 3) Plot resolved points on specified Google map. 4) Determine distance between 2 points in km or mi using haversine formula. Details Package: geoplot Type: Package Version: 2.1 Date: License: GPL-2 INSTRUCTIONS: To resolve (geocode) a single address to coordinates: <- geoaddress(c("001","202 South Central Avenue","Flagler Beach","FL","32136","US")) Plot the address on a map: geoplot() To geocode and plot a data frame of addresses: (see geoaddr for format) addr <- load( ListOfAddresses.rda ) geoaddr <- addrlistlookup(addr) geoplot(geoaddr) To geocode a single ip address: <- geoip(" ") Plot on the map: geoplot() To geocode and plot a data frame of ips: (see geoip for format) ips <- load( ListOfIPs.rda ) geoips <- iplistlookup(ips) geoplot(geoips)

3 addrlistlookup 3 To determine the distance between 2 points: haversine(" "," "," "," ") To determine the distance between 2 points resolved above: haversine(geoaddr[1,3],geoaddr[1,4],geoaddr[2,3],geoaddr[2,4]) haversine(geoips[1,3],geoips[1,4],geoips[2,3],geoips[2,4]) <> References Eamples <- geoaddress(c("001","202 South Central Avenue","Flagler Beach","FL","32136","US")) geoplot() y <- geoip(" ") geoplot(y) haversine( , , , ) addrlistlookup addrlistlookup This function runs a list through the geoaddress function for geocoding. addrlistlookup() A data frame containing: id, address, city, state/province, postal and country. The id is simply an identifier. The remaining address elements do not have to be universally populated. A concatenation of the vector elements occurs but the input specification is only rigid in that id and 4 elements are needed.

4 4 degrees2radians Value The returned value is a data frame containing the elements: id, address, latitude (point coordinate), longitude (point coordinate), north bo coordinate, south bo coordinate, east bo coordinate, west bo coordinate. id address latitude longitude bo_north bo_south bo_east bo_west User defined identifier. This can be arbitrary Concatenated address data. Point coordinate - latitude. Point coordinate - longitude. Bo coordinate - North. Bo coordinate - South. Bo coordinate - East. Bo coordinate - West. geoaddress, geoplot Eamples id <- c( , , , , ) address <- c( 537 LINDEN AVENUE, 4163 KENWOOD PLACE, 4670 POINTE LANE, 4077 MARIGOLD LANE, 193 MULBERRY LANE ) city <- c( ORLANDO, JUPITER, POMPANO BEACH, MIAMI, JUPITER ) stateprov <- c( FL, FL, FL, FL, FL ) postal <- c( 32805, 33478, 33060, 33179, ) country <- c( US, US, US, US, US ) <- data.frame(id,address,city,stateprov,postal,country) addrlistlookup() degrees2radians degrees2radians This is a conversion from degrees to radians for the haversine function. This is not intended to be used independently. degrees2radians()

5 geoaddress 5 Degrees measure. geoaddress geoaddress Implements a lookup using the Google Maps API to determine point and bo coordinates for a given address. geoaddress() is a list or data frame containing: id, address, city, state/province, postal & country. The id is simply an identifier field and the remaining address elements do not have to be universally populated. A concatenation of the vector elements occurs but the input specification is only rigid in that id and 4 elements are needed. Details Value The GoogleMaps API is interfaced by rendering an address via URL in the following format: PATTERN: The output is a web page containing the XML document with the data fields which are then ingested. The returned value is a list containing the elements: id, address, latitude (point coordinate), longitude (point coordinate), north bo coordinate, south bo coordinate, east bo coordinate, west bo coordinate. id address latitude longitude bo_north User defined identifier. Concatenated address data. Point coordinate - latitude. Point coordinate - longitude. Bo coordinate - North.

6 6 geoip bo_south bo_east bo_west Bo coordinate - South. Bo coordinate - East. Bo coordinate - West. addrlistlookup, geoplot Eamples <- c("001","202 South Central Avenue","Flagler Beach","FL","32136","US") geoaddress() geoip iplistlookup Implements a lookup using the InfoDB API to determine point coordinates for a given ip address. There is a package dependency here for rjson and you must have this. Also, you should get your own API code and supplement it for the one used here. See Details Section. geoip() is the ip address in ipv4 format Details The lookup here is performed by using the InfoDB ip lookup page at via API call to http which is structured as follows: PATTERN: You can get your own API key, (yes, it s free), and supplement it into the code for the geoip function at The data will be returned in a JSON document on a page which is ingested.

7 geoplot 7 Value A list is returned containing the following elements: ipaddress statuscode latitude longitude statusmessage countrycode countryname regionname cityname zipcode timezone Input ip address. Returned status code from lookup. Point coordinate - latitude. Point coordinate - longitude. Returned status message from lookup. Country code from ip lookup. Country name from ip lookup. State/region/province from ip lookup. City from ip lookup. Postal code from ip lookup. Timezone from ip lookup. References iplistlookup, geoplot Eamples <- " " geoip() geoplot geoplot This function plots either a single or list of latitude/longitude coordinates on a Google Map. The RgoogleMaps package is a dependency. geoplot(,zoom,maptype,color)

8 8 haversine zoom maptype color is a data frame with latitude and longitude in the 3rd and 4th column respectively. This aligns with the oupput of geoaddress and geoip. This is the zoom level of the map. Default is 6, play around to see what works best. This is the type of map. Options are: roadmap, mobile, satellite, terrain, hybrid, mapmaker-roadmap, mapmaker-hybrid. See package RgoogleMaps for descriptions. This is the color for the plotted points. The default is red. geoaddress, geoip, addrlistlookup, iplistlookup Eamples <- geoaddress(c("001","202 South Central Avenue","Flagler Beach","FL","32136","US")) geoplot(,zoom=6,maptype="mobile",color= "red") haversine haversine This is the haversine formula for determining distance between coordinated on a globe. haversine(lat, Lon, ylat, ylon) Lat Lon ylat ylon Position 1 latitude. Position 1 longitude. Position 2 latitude. Position 2 longitude.

9 iplistlookup 9 Value The output is a list with the coordinates, distance in kilometers and miles. Lat Lon ylat ylon distkm distmi Position 1 latitude. Position 1 longitude. Position 2 latitude. Position 2 longitude. Distance between points in kilometers. Distance between points in miles. Note There is some variation between computations due to the measurement used for the Earth s radius. This implementation uses the mean radius measurement of 6371 km versus the equitorial radius of Feel free to adjust if your opinion differs! References degrees2radians, geoaddress, geoip Eamples haversine(" "," "," "," ") iplistlookup iplistlookup This function geocodes a list of ip addresses. iplistlookup()

10 10 iplistlookup is a list containing ip addresses. Value A data frame is returned containing the following elements: ipaddress statuscode latitude longitude statusmessage countrycode countryname regionname cityname zipcode timezone Input ip address. Returned status code from lookup. Point coordinate - latitude. Point coordinate - longitude. Returned status message from lookup. Country code from ip lookup. Country name from ip lookup. State/region/province from ip lookup. City from ip lookup. Postal code from ip lookup. Timezone from ip lookup. geoip, geoplot Eamples ips <- c( , , , , ) <- data.frame(ips) iplistlookup()

11 Inde Topic address addrlistlookup, 3 geoaddress, 5 Topic distance haversine, 8 Topic geoaddress addrlistlookup, 3 geoaddress, 5 Topic geocode geoaddress, 5 Topic geoip geoip, 6 iplistlookup, 9 Topic geoplot geoplot, 7 geoplot-package, 2 Topic haversine degrees2radians, 4 haversine, 8 Topic ipaddress geoip, 6 iplistlookup, 9 Topic radians degrees2radians, 4 addrlistlookup, 3, 6, 8 degrees2radians, 4, 9 geoaddress, 4, 5, 8, 9 geoip, 6, 8 10 geoplot, 4, 6, 7, 7, 10 geoplot-package, 2 haversine, 8 iplistlookup, 7, 8, 9 11