daily_observed_latlng: daily_observed_latlng

Description Usage Arguments Details Value References Examples

View source: R/weather-daily.R

Description

daily_observed_latlng pulls historical weather data from aWhere's API based on latitude & longitude

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
daily_observed_latlng(
  latitude,
  longitude,
  day_start,
  day_end,
  propertiesToInclude = "",
  keyToUse = awhereEnv75247$uid,
  secretToUse = awhereEnv75247$secret,
  tokenToUse = awhereEnv75247$token,
  apiAddressToUse = awhereEnv75247$apiAddress
)

Arguments

latitude

the latitude of the requested location (double)

longitude

the longitude of the requested locations (double)

day_start

character string of the first day for which you want to retrieve data, in the form: YYYY-MM-DD

day_end

character string of the last day for which you want to retrieve data, in the form: YYYY-MM-DD

propertiesToInclude

character vector of properties to retrieve from API. Valid values are temperatures, precipitation, solar, relativeHumidity, wind (optional)

keyToUse

aWhere API key to use. For advanced use only. Most users will not need to use this parameter (optional)

secretToUse

aWhere API secret to use. For advanced use only. Most users will not need to use this parameter (optional)

tokenToUse

aWhere API token to use. For advanced use only. Most users will not need to use this parameter (optional)

apiAddressToUse

Address of aWhere API to use. For advanced use only. Most users will not need to use this parameter (optional)

Details

This function returns weather data on Min/Max Temperature, Precipitation, Min/Max Humidity, Solar Radiation, and Maximum Wind Speed, Morning Max Windspeed, and Average Windspeed for the location specified by latitude and longitude. Default units are returned by the API. Latitude and longitude must be in decimal degrees.

The Weather APIs provide access to aWhere's agriculture-specific Weather Terrain system, and allows retrieval and integration of data across all different time ranges, long term normals, daily observed, current weather, and forecasts. These APIs are designed for efficiency, allowing you to customize the responses to return just the attributes you need.

Understanding the recent and long-term daily weather is critical for making in-season decisions. This API opens the weather attributes that matter most to agriculture.

Note about dates: The system does not adjust for any difference in dates between the location of the user and where data is being requested from. It is the responsibility of the user to ensure a valid date range is specified given any differences in timezone. These differences can have implications for whether a given date should be requested from the daily_observed functions or the forecast functions

Value

data.frame of requested data for dates requested

References

https://docs.awhere.com/knowledge-base-docs/daily-observed-weather-by-geolocation/

Examples

1
2
3
4
5
## Not run: daily_observed_latlng(latitude = 39.8282
                               ,longitude = -98.5795
                               ,day_start = '2018-10-28'
                               ,day_end = '2018-12-01')
## End(Not run)

aWhereAPI/aWhere-R-Library documentation built on Nov. 5, 2021, 3:35 a.m.