DPIRD 科学 - 西澳大利亚 （独立出版商） （预览版）

此 API 提供 DPIRD 网站上已提供的“降雨量到日期”、“潜在产量”和“土壤水”工具的后端

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域 ：      - 美国政府 （GCC）      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有 逻辑应用区域 ：      - Azure 政府区域      - Azure 中国区域      - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域 ：      - 美国政府 （GCC）      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域 ：      - 美国政府 （GCC）      - 美国政府 （GCC High）      - 由世纪互联运营的中国云      - 美国国防部（DoD）

联系人​​
Name	保罗·库姆西
URL	https://www.sevensigma.com.au
Email	paul.culmsee@sevensigma.com.au

连接器元数据
发布者	保罗·库姆西
网站	https://www.agric.wa.gov.au/
隐私策略	https://www.agric.wa.gov.au/apis/api-terms-and-conditions
类别	商业智能;数据

正在创建连接

连接器支持以下身份验证类型：

默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
API 密钥	securestring	此 API 的 API 密钥	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

获取单站	获取特定工作站的元数据
获取单站降雨	根据已接收的降雨量，返回迄今为止的降雨量、历史降雨数据和预计的降雨数据
获取土壤水	根据收到的降雨和土壤类型返回土壤中的水量。
获取工作站	返回可用于科学 API 的工作站列表。
获取潜在收益	获取潜在收益
获取附近的工作站	返回附近车站的列表，按距离排序。 使用分页控制返回的工作站数。 默认情况下返回 5 个工作站。 按位置升序距离排序。
获取黄色点	运行 Moin 或 Chris Yellow Spot 模型。

获取单站

操作 ID:

GetStation

获取特定工作站的元数据

参数

名称	密钥	必需	类型	说明
工作站代码	stationCode	True	string	一个区分大小写的工作站代码。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
数据	data	stationModel

获取单站降雨

操作 ID:

GetStationRainfall

根据已接收的降雨量，返回迄今为止的降雨量、历史降雨数据和预计的降雨数据

参数

名称	密钥	必需	类型	说明
工作站代码	stationCode	True	string	一个区分大小写的工作站代码。
夏季开始日期	summerStartDate		date	夏天开始的日期。 默认值为上一年的 1/11
成长季节开始日期	growingSeasonStartDate		date	生长季节开始的日期。 默认为当前年份的 1/4。
成长季节结束日期	endDate		date	生长季节的结束日期。 默认为当前年份的 31/10。
预测日期	forecastDate		date	执行投影的日期。 可用于查看历史预测。 默认为当前日期。
要包含的字段	select		string	要包含在结果中的字段的逗号分隔列表。 请注意，除非明确包含，否则不包括工作站代码或名称。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
数据	data	stationRainfallModel

获取土壤水

操作 ID:

GetSoilWater

根据收到的降雨和土壤类型返回土壤中的水量。

参数

名称	密钥	必需	类型	说明
工作站代码	stationCode		string	一个区分大小写的工作站代码。
纬度	latitude		number	要按十进制度搜索的纬度。
经度	longitude		number	要按十进制度搜索的经度。
开始日期	startDate	True	string	时间段的开始日期。
结束日期	endDate	True	string	时间段的结束日期。
土壤代码	soilType	True	string	土壤类型的代码
裁剪初始化周期	faoInitialisationDays		integer	作物初始化期间使用的天数，用于估计作物疏散。
作物蒸发初始化期	faoInitialisationCropCoefficient		number	初始化期间作物使用的潜在蒸发比例
作物开发中的天数	faoDevelopmentDays		integer	作物开发期间使用的天数，用于估计作物疏散。
作物蒸发开发期。	faoDevelopmentCropCoefficient		number	开发期间作物使用的潜在蒸发的比例。
作物中季的天数	faoMidSeasonDays		integer	作物中季期间天数，用于估计作物疏散。
作物蒸发中季期间	faoMidSeasonCropCoefficient		number	赛季中期使用的潜在蒸发比例
作物后期的天数	faoLateSeasonDays		integer	作物后期周期的天数，用于估计作物疏散。
作物蒸发后期季节。	faoLateSeasonCropCoefficient		number	季末作物使用的潜在蒸发比例。
4月25日之后的降雨量（毫米）	faoBreakOfSeason3Days25April		integer	4月25日之后的降雨量，这引发了本赛季的休息。
6月5日之后的降雨量（毫米）	faoBreakOfSeason3Days5June		integer	6月5日之后的降雨量，这引发了本赛季的中断。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
数据	data	soilWaterModel	土壤水数据

获取工作站

操作 ID:

GetStations

返回可用于科学 API 的工作站列表。

参数

名称	密钥	必需	类型	说明
工作站代码	stationCode		string	区分大小写的工作站代码的逗号分隔列表。 限制将返回的工作站。
查询偏移量	offset		integer	分页偏移量参数指定要从集合返回的第一个条目。
要检索的记录数	limit		integer	分页限制参数限制返回的条目数。
要排序依据的字段	sort		string	要排序依据的字段的逗号分隔列表。 默认为升序。 下行前的“-”。 对于风场，只能按最低传感器进行排序或选择。
要包含的字段	select		string	要包含在结果中的字段的逗号分隔列表。 请注意，除非明确包含，否则不包括工作站代码或名称。
工作站组	group		string	将工作站筛选到预定义组。 需要在后端支持这些项。 “all”返回所有工作站，“api”返回与 API 一起使用的默认工作站，“web”返回由 weather.agric.wa.gov.au 使用的列表，“rtd”返回具有科学完整数据集的工作站。
可用值为“all”、“wa”、“sa”、“nsw”、“vic”、“qld”、“tas”、“nt”	state		string	按状态筛选。 默认情况下，返回所有状态。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
收藏	collection	array of stationModel	工作站集合

获取潜在收益

操作 ID:

GetPotentialYield

获取潜在收益

参数

名称	密钥	必需	类型	说明
工作站代码	stationCode		string	一个区分大小写的工作站代码。
纬度	latitude		number	要按十进制度搜索的纬度。
经度	longitude		number	要按十进制度搜索的经度。
夏季开始日期	summerStartDate		date	夏天开始的日期。 默认值为上一年的 1/11
成长季节开始日期	growingSeasonStartDate		date	生长季节开始的日期。 默认为当前年份的 1/4。
成长季节结束日期	endDate		date	生长季节的结束日期。 默认为当前年份的 31/10。
预测日期	forecastDate		date	执行投影的日期。 可用于查看历史预测。 默认为当前日期。
要使用的水使用效率。	waterUseEfficiency		integer	要使用的水使用效率。
蒸发。	evaporation		integer	蒸发。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
数据	data	potentialYieldModel	潜在收益数据

获取附近的工作站

操作 ID:

GetNearbyWeatherStations

返回附近车站的列表，按距离排序。 使用分页控制返回的工作站数。 默认情况下返回 5 个工作站。 按位置升序距离排序。

参数

名称	密钥	必需	类型	说明
纬度	latitude	True	number	要按十进制度搜索的纬度。
经度	longitude	True	number	要按十进制度搜索的经度。
搜索半径	radius		integer	仅查找此公里范围内的车站。 默认值为 100 公里。
查询偏移量	offset		integer	分页偏移量参数指定要从集合返回的第一个条目。
要检索的记录数	limit		integer	分页限制参数限制返回的条目数。
要排序依据的字段	sort		string	要排序依据的字段的逗号分隔列表。 默认为升序。 下行前的“-”。 对于风场，只能按最低传感器进行排序或选择。
要包含的字段	select		string	要包含在结果中的字段的逗号分隔列表。 请注意，除非明确包含，否则不包括工作站代码或名称。
工作站组	group		string	将工作站筛选到预定义组。 需要在后端支持这些项。 “all”返回所有工作站，“api”返回与 API 一起使用的默认工作站，“web”返回由 weather.agric.wa.gov.au 使用的列表，“rtd”返回具有科学完整数据集的工作站。
可用值为“all”、“wa”、“sa”、“nsw”、“vic”、“qld”、“tas”、“nt”	state		string	按状态筛选。 默认情况下，返回所有状态。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
收藏	collection	array of stationModel	工作站集合

获取黄色点

操作 ID:

GetYellowSpot

运行 Moin 或 Chris Yellow Spot 模型。

参数

名称	密钥	必需	类型	说明
工作站代码	stationCode		string	一个区分大小写的工作站代码。
要为其运行模型的日期	date		string	格式 YYYY-MM-DD。 如果未提供，则默认为当前日期
仅返回结果的一部分。	select		string	选项包括“moin”、“chris”、“moinMaturation”、“moinModel”、“chrisMaturation”、“chrisModel”。 可以将多个选项作为逗号分隔字符串提供。“moinMaturation，chrisMaturation”。 默认情况下，返回所有结果。

返回

名称	路径	类型	说明
元数据	metadata	apiMetaDataModel	所有响应的包装器都提供与 API 调用相关的有用信息。
成熟	data.moin.maturation	maturationModel	成熟
模型	data.moin.model	yellowSpotModel	模型
成熟	data.chris.maturation	maturationModel	成熟
模型	data.chris.model	yellowSpotModel	模型

定义

apiMetaDataModel

所有响应的包装器都提供与 API 调用相关的有用信息。

名称	路径	类型	说明
状态	status	integer	状态
链接	links	linksModel	与终结点相关的一系列链接。
收藏	collection	paginationModel	分页详细信息

yellowSpotModel

模型

名称	路径	类型	说明
date	date	string	日期。
minimum	temperature.minimum	float	当天的最低温度。
maximum	temperature.maximum	float	当天的最高温度。
平均	temperature.average	float	当天的平均温度。
movingAverage	temperature.movingAverage	float	移动平均值。
雨	rainfall.rain	float	期间每日降雨量
movingSum	rainfall.movingSum	float	降雨移动总和。
合适	suitable		适合的模型
maturationProgress	maturationProgress		模型成熟进度

maturationModel

成熟

名称	路径	类型	说明
date	date	string	已计算到期日期（如果已发生）。
进展	progress	float	当前成熟度为请求日期的目标百分比。 如果请求日期是到期日的计算日期，则为 100%;如果之后会变大。
目标	target	integer	达到成熟所需的合适天数。

soilWaterModel

土壤水数据

名称	路径	类型	说明
soilWater	soilWater	array of object	土壤水数据
date	soilWater.date	string	夏季开始日期。
雨量	soilWater.rainfall	float	当天下降的雨量。
休耕地	soilWater.fallow	float	草场的土壤水以毫米为单位。
剪切	soilWater.crop	float	裁剪围场的土壤水以毫米为单位。
breakOfSeason	breakOfSeason	string	赛季休息

potentialYieldModel

潜在收益数据

名称	路径	类型	说明
forecastDate	summary.forecastDate	string	forecastDate
inGrowingSeason	summary.inGrowingSeason	boolean	inGrowingSeason
startDate	summary.summer.startDate	string	夏季开始日期。
结束日期	summary.summer.endDate	string	夏季结束（季节开始前一天）
cumulativeRainfall	summary.summer.cumulativeRainfall	float	夏季雨量下降。
decile	summary.summer.decile	integer	今年夏天降雨的历史十分化。
startDate	summary.growingSeason.startDate	string	季节开始的日期
结束日期	summary.growingSeason.endDate	string	季节结束的日期，或当前日期（如果当前在季节内）。
cumulativeRainfall	summary.growingSeason.cumulativeRainfall	float	开始和结束日期之间的降雨量。
decile	summary.growingSeason.decile	integer	鉴于目前的累计降雨量，这是降雨将适合的历史十分位数。
potentialYield	potentialYield	array of object	本赛季的潜在产量和预期降雨量，以十分位数计算。
decile	potentialYield.decile	integer	十二分位数从 1 到 9
projectedRainfall	potentialYield.projectedRainfall	float	预计十分位数的降雨量为毫米。
potentialYield	potentialYield.potentialYield		吨/公顷的潜在产量。

stationRainfallModel

名称	路径	类型	说明
forecastDate	forecastDate	string	这是唯一区分大小写的气象站代码。
startDate	summary.summer.startDate	string	夏季开始日期。
结束日期	summary.summer.endDate	string	夏季结束（季节开始前一天）
cumulativeRainfall	summary.summer.cumulativeRainfall	float	夏季雨量下降。
decile	summary.summer.decile	integer	今年夏天降雨的历史十分化。
startDate	summary.season.startDate	string	季节开始日期。
结束日期	summary.season.endDate	string	季节结束的日期，或当前日期（如果当前在季节内）
cumulativeRainfall	summary.season.cumulativeRainfall	float	开始和结束日期之间的降雨量。
decile	summary.season.decile	integer	鉴于目前的累计降雨量，这是降雨将适合的历史十分位数。
currentSeasonalRainfall	summary.currentSeasonalRainfall	array of object	季节降雨摘要
date	summary.currentSeasonalRainfall.date	string	降雨发生日期。
雨量	summary.currentSeasonalRainfall.rainfall	float	给定日发生的降雨。
cumulativeRainfall	summary.currentSeasonalRainfall.cumulativeRainfall	float	本赛季迄今累计降雨。
projectedSeasonalRainfall	summary.projectedSeasonalRainfall	array of object	预计季节降雨
date	summary.projectedSeasonalRainfall.date	string	预计降雨量的日期。
deciles	summary.projectedSeasonalRainfall.deciles	array of object
decile	summary.projectedSeasonalRainfall.deciles.decile	integer	十二分位数从 1 到 9
雨量	summary.projectedSeasonalRainfall.deciles.rainfall	float	预计十分位数的降雨量。
historicalRainfall	summary.historicalRainfall	array of object	历史季节降雨
date	summary.historicalRainfall.date	string	历史降雨量的月份和日数。
deciles	summary.historicalRainfall.deciles	array of object	预计降雨量值（以十分位数表示）。
decile	summary.historicalRainfall.deciles.decile	integer	十二分位数从 1 到 9
雨量	summary.historicalRainfall.deciles.rainfall	float	预计十分位数的降雨量。

paginationModel

分页详细信息

名称	路径	类型	说明
计数	count	integer	计数
limit	limit	integer	limit
偏移	offset	integer	偏移
链接	links	linksModel	与终结点相关的一系列链接。

stationModel

名称	路径	类型	说明
stationCode	stationCode	string	工作站的唯一标识符。 区分大小写。
stationName	stationName	string	气象站的人类可读名称。
latitude	latitude	float	天气站的纬度（以十进制度为单位）用于在地图上显示。
longitude	longitude	float	天气站的经度（以十进制度为单位）用于在地图上显示。
所有者	owner	string	气象站的所有者。
状态	state	string	该站所在的澳大利亚州。
startYear	startYear	number	车站开始的一年
endYear	endYear	boolean	车站关闭的一年。 如果仍在运行，则为 Null。

linksModel

与终结点相关的一系列链接。

名称	路径	类型	说明
URL	href	string	指定链接指向的页面的 URL。
关系	rel	string	指定当前文档与链接文档之间的关系。