#66 add section to docs for searchbyterm and pkg level man file warni…

…ng about no results

fix #67 URLdecode url before printing url so users can more easily determine if the query they sent is what they expect
bump version

DESCRIPTION

@@ -5,7 +5,7 @@ Description: Retrieve, map and summarize data from the 'VertNet.org'
     parameters, including 'taxonomic' names, places, and dates. In addition, 
     there is an interface for conducting spatially delimited searches, and 
     another for requesting large 'datasets' via email.
-Version: 0.7.3.9100
+Version: 0.7.3.9310
 Authors@R: c(
     person("Scott", "Chamberlain",
         role = c("aut", "cre"),

R/rvertnet-package.R

@@ -32,6 +32,15 @@
 #' 
 #' \code{vertsearch(taxon = "aves", state = "california")}
 #' 
+#' @section No results?:
+#' 
+#' It's possible to get no results when requesting data from VertNet,
+#' then run the same function again 10 seconds later, and you do get a result.
+#' I'm not sure why this is, something having to do with Vertnet's
+#' infrastucture that I'm not aware of. Point is, if you are sure
+#' you haven't made any mistakes with the parameters, etc., then 
+#' simply run the function call again.
+#' 
 #' @importFrom jsonlite fromJSON toJSON
 #' @importFrom dplyr bind_rows tbl_df
 #' @importFrom ggplot2 ggplot position_jitter aes geom_polygon 

R/searchbyterm.R

@@ -166,6 +166,15 @@
 #' - coordinateuncertaintyinmeters (character) Coordinate uncertainty
 #' in meters (numeric) or range of uncertainty values designated by
 #' comparison operators "<", ">", "<=", or ">="
+#' 
+#' @section No results?:
+#' 
+#' It's possible to get no results with a call to `searchbyterm()`,
+#' then run it again 10 seconds later, and you do get a result.
+#' I'm not sure why this is, something having to do with Vertnet's
+#' infrastucture that I'm not aware of. Point is, if you are sure
+#' you haven't made any mistakes with the parameters, etc., then 
+#' simply run the function call again.
 #'
 #' @return A list with two slots:
 #' 
@@ -174,6 +183,7 @@
 #' 
 #' @references
 #' https://github.com/VertNet/webapp/wiki/The-API-search-function
+#' 
 #' @details `searchbyterm()` builds a query from input parameters
 #' based on Darwin Core (dwc) terms (for the full list of terms, see
 #' https://code.google.com/p/darwincore/wiki/DarwinCoreTerms).

R/zzz.R

@@ -73,7 +73,7 @@ vert_GET <- function(fxn="searchbyterm", args, limit = 1000, messages = TRUE,
     res <- get_terms()
     df <- df[ , names(df) %in% res ]
   }
-  mssg(messages, paste("\nLast Query URL: \"", tt$url, "\"", sep = ""))
+  mssg(messages, paste("\nLast Query URL: \"", URLdecode(tt$url), "\"", sep = ""))
   mssg(messages, paste("\nMatching records:", NROW(df), "returned,", avail, "available", sep = " "))
   list(meta = make_meta(out), data = tbl_df(df))
 }