DPIRD Science – Nyugat-Ausztrália (Független Kiadó) (előzetes verzió)

Ez az API a DPIRD webhelyén már elérhető esőzések, lehetséges hozamok és talajvíz eszközök háttérrendszerét biztosítja

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket:      - Azure Government-régiók      - Azure China-régiók      - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	prémium	Az összes Power Apps-régió , kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
Név	Paul Culmsee
URL	https://www.sevensigma.com.au
Email	paul.culmsee@sevensigma.com.au

Összekötő metaadatai
Kiadó	Paul Culmsee
Webhely	https://www.agric.wa.gov.au/
Adatvédelmi irányelvek	https://www.agric.wa.gov.au/apis/api-terms-and-conditions
Kategóriák	Üzleti intelligencia; Adat

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
API-kulcs	securestring	Az API API-kulcsa	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

Egyetlen állomás esőzésének lekérése	Az eddigi csapadékmennyiséget, a korábbi csapadékadatokat és a várható csapadékadatokat adja vissza a már kapott csapadéktól függően
Egyetlen állomás lekérése	Egy adott állomás metaadatainak lekérése
Közeli állomások lekérése	A közeli állomások listáját adja vissza távolság szerint rendezve. Lapozással szabályozhatja a visszaadott állomások számát. Alapértelmezés szerint 5 állomást ad vissza. Rendezés a helytől való távolság alapján növekvő sorrendben.
Potenciális hozam lekérése	Potenciális hozam lekérése
Sárga pont lekérése	Futtassa a Moin vagy Chris Yellow Spot modellt.
Talajvíz lekérése	A talajban lévő víz mennyiségét adja vissza a kapott csapadéktól és a talaj típusától függően.
Állomások lekérése	A Science API-val használható állomások listáját adja vissza.

Egyetlen állomás esőzésének lekérése

Műveletazonosító:

GetStationRainfall

Az eddigi csapadékmennyiséget, a korábbi csapadékadatokat és a várható csapadékadatokat adja vissza a már kapott csapadéktól függően

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Állomáskód	stationCode	True	string	Egyetlen kis- és nagybetűkre érzékeny állomáskód.
Nyár kezdési dátuma	summerStartDate		date	A nyár kezdete. Alapértelmezett érték az előző év 1/11-ére
Termesztési szezon kezdési dátuma	growingSeasonStartDate		date	A termesztési időszak kezdete. Alapértelmezés szerint az aktuális év 1/4-e.
Termesztési szezon záródátuma	endDate		date	A termesztési időszak záró dátuma. Alapértelmezés szerint az aktuális év 31/10-e.
Előrejelzés dátuma	forecastDate		date	A előrejelzések elvégzésének dátuma. Az előzmény-előrejelzések megtekintésére használható. Alapértelmezett érték az aktuális dátumra.
Belefoglalandó mezők	select		string	Az eredménybe belefoglalandó mezők vesszővel tagolt listája. Vegye figyelembe, hogy ez nem tartalmaz állomáskódokat vagy neveket, kivéve, ha kifejezetten szerepel benne.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
adat	data	stationRainfallModel

Egyetlen állomás lekérése

Műveletazonosító:

GetStation

Egy adott állomás metaadatainak lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Állomáskód	stationCode	True	string	Egyetlen kis- és nagybetűkre érzékeny állomáskód.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
adat	data	stationModel

Közeli állomások lekérése

Műveletazonosító:

GetNearbyWeatherStations

A közeli állomások listáját adja vissza távolság szerint rendezve. Lapozással szabályozhatja a visszaadott állomások számát. Alapértelmezés szerint 5 állomást ad vissza. Rendezés a helytől való távolság alapján növekvő sorrendben.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Szélesség	latitude	True	number	A keresendő szélesség decimális fokban.
Hosszúság	longitude	True	number	A keresendő hosszúság decimális fokban.
Keresési sugár	radius		integer	Csak ebben a kilométer-tartományban lévő állomásokat keresse. Alapértelmezés szerint 100km.
Lekérdezés eltolása	offset		integer	A lapozási eltolás paraméter adja meg az első olyan bejegyzést, amely egy gyűjteményből tér vissza.
Lekérendő rekordok száma	limit		integer	A lapozási korlát paraméter korlátozza a visszaadott bejegyzések számát.
Rendezendő mezők	sort		string	A rendezendő mezők vesszővel tagolt listája. Alapértelmezés szerint növekvő. Előre fel van függve a "-" a csökkenőhöz. Szélmezők esetén csak a legalacsonyabb érzékelő alapján rendezhet vagy választhat.
Belefoglalandó mezők	select		string	Az eredménybe belefoglalandó mezők vesszővel tagolt listája. Vegye figyelembe, hogy ez nem tartalmaz állomáskódokat vagy neveket, kivéve, ha kifejezetten szerepel benne.
Állomáscsoport	group		string	Szűrje az állomásokat egy előre definiált csoportra. Ezeket a háttérrendszerben kell támogatni. Az "all" az összes állomást visszaadja, az "api" az API-val használt alapértelmezett állomásokat adja vissza, a "web" a weather.agric.wa.gov.au által használt listát, az "rtd" pedig tudományosan teljes adatkészletekkel rendelkező állomásokat ad vissza.
A rendelkezésre álló értékek a következők: 'all', 'wa', 'sa', 'nsw', 'vic', 'qld', 'tas', 'nt'	state		string	Szűrés állapot szerint. Alapértelmezés szerint a rendszer minden állapotot visszaad.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
gyűjtemény	collection	array of stationModel	Állomások gyűjteménye

Potenciális hozam lekérése

Műveletazonosító:

GetPotentialYield

Potenciális hozam lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Állomáskód	stationCode		string	Egyetlen kis- és nagybetűkre érzékeny állomáskód.
Szélesség	latitude		number	A keresendő szélesség decimális fokban.
Hosszúság	longitude		number	A keresendő hosszúság decimális fokban.
Nyár kezdési dátuma	summerStartDate		date	A nyár kezdete. Alapértelmezett érték az előző év 1/11-ére
Termesztési szezon kezdési dátuma	growingSeasonStartDate		date	A termesztési időszak kezdete. Alapértelmezés szerint az aktuális év 1/4-e.
Termesztési szezon záródátuma	endDate		date	A termesztési időszak záró dátuma. Alapértelmezés szerint az aktuális év 31/10-e.
Előrejelzés dátuma	forecastDate		date	A előrejelzések elvégzésének dátuma. Az előzmény-előrejelzések megtekintésére használható. Alapértelmezett érték az aktuális dátumra.
A vízfelhasználás hatékonysága.	waterUseEfficiency		integer	A vízfelhasználás hatékonysága.
A párolgás.	evaporation		integer	A párolgás.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
adat	data	potentialYieldModel	Potenciális hozamadatok

Sárga pont lekérése

Műveletazonosító:

GetYellowSpot

Futtassa a Moin vagy Chris Yellow Spot modellt.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Állomáskód	stationCode		string	Egyetlen kis- és nagybetűkre érzékeny állomáskód.
A modell futtatásának dátuma	date		string	formátum: YYYYY-MM-DD. Alapértelmezett érték az aktuális napra, ha nincs megadva
Az eredményeknek csak egy részét adja vissza.	select		string	A lehetőségek a következők: "moin", "chris", "moinMaturation", "moinModel", "chrisMaturation", "chrisModel". Több lehetőség is megadható vesszővel tagolt sztringként, azaz. 'moinMaturation,chrisMaturation'. Alapértelmezés szerint a rendszer minden eredményt visszaad.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
érés	data.moin.maturation	maturationModel	érés
modell	data.moin.model	yellowSpotModel	modell
érés	data.chris.maturation	maturationModel	érés
modell	data.chris.model	yellowSpotModel	modell

Talajvíz lekérése

Műveletazonosító:

GetSoilWater

A talajban lévő víz mennyiségét adja vissza a kapott csapadéktól és a talaj típusától függően.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Állomáskód	stationCode		string	Egyetlen kis- és nagybetűkre érzékeny állomáskód.
Szélesség	latitude		number	A keresendő szélesség decimális fokban.
Hosszúság	longitude		number	A keresendő hosszúság decimális fokban.
Kezdő dátum	startDate	True	string	Az időszak kezdő dátuma.
Befejező dátum	endDate	True	string	Az időszak záró dátuma.
Talajkód	soilType	True	string	Egy talajtípus kódja
Körülvágás inicializálási időszaka	faoInitialisationDays		integer	A termés inicializálási időszakában a növény evapotranspirációjának becsléséhez használt napok száma.
Körülvágási párolgás inicializálási időszaka	faoInitialisationCropCoefficient		number	A körülvágás által az inicializálási időszakban használt lehetséges párolgás aránya
Napok a növénytermesztésben	faoDevelopmentDays		integer	A növénytermesztési időszak napjainak száma, amelyeket a növény evapotranspirációjának becsléséhez használnak.
A körülvágási párolgás fejlesztési időszaka.	faoDevelopmentCropCoefficient		number	A termés által a fejlesztési időszakban használt lehetséges párolgás aránya.
A szezon közepe táján töltött napok	faoMidSeasonDays		integer	A növénytermés időszakközi napjainak száma, amelyeket a növény evapotranspirációjának becsléséhez használnak.
Termés párolgása a szezon közepén	faoMidSeasonCropCoefficient		number	A szezon közepén használt lehetséges párolgás aránya
Napok a termés késői szezonjában	faoLateSeasonDays		integer	A növénytermés időszak végén eltelt napjainak száma, amelyeket a növény evapotranspirációjának becsléséhez használnak.
A termés párolgása a szezon végén.	faoLateSeasonCropCoefficient		number	A termés által a szezon végén használt lehetséges párolgás aránya.
Eső (mm) április 25. után	faoBreakOfSeason3Days25April		integer	Az április 25-e utáni esőzések száma, amely kiváltja a szezon szünetét.
Eső (mm) június 5. után	faoBreakOfSeason3Days5June		integer	A június 5. utáni esőzések száma, amely kiváltja a szezon szünetét.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
adat	data	soilWaterModel	Talajvízadatok

Állomások lekérése

Műveletazonosító:

GetStations

A Science API-val használható állomások listáját adja vissza.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Állomáskódok	stationCode		string	A kis- és nagybetűk megkülönböztetésével rendelkező állomáskódok vesszővel tagolt listája. Korlátozza a visszaadott állomásokat.
Lekérdezés eltolása	offset		integer	A lapozási eltolás paraméter adja meg az első olyan bejegyzést, amely egy gyűjteményből tér vissza.
Lekérendő rekordok száma	limit		integer	A lapozási korlát paraméter korlátozza a visszaadott bejegyzések számát.
Rendezendő mezők	sort		string	A rendezendő mezők vesszővel tagolt listája. Alapértelmezés szerint növekvő. Előre fel van függve a "-" a csökkenőhöz. Szélmezők esetén csak a legalacsonyabb érzékelő alapján rendezhet vagy választhat.
Belefoglalandó mezők	select		string	Az eredménybe belefoglalandó mezők vesszővel tagolt listája. Vegye figyelembe, hogy ez nem tartalmaz állomáskódokat vagy neveket, kivéve, ha kifejezetten szerepel benne.
Állomáscsoport	group		string	Szűrje az állomásokat egy előre definiált csoportra. Ezeket a háttérrendszerben kell támogatni. Az "all" az összes állomást visszaadja, az "api" az API-val használt alapértelmezett állomásokat adja vissza, a "web" a weather.agric.wa.gov.au által használt listát, az "rtd" pedig tudományosan teljes adatkészletekkel rendelkező állomásokat ad vissza.
A rendelkezésre álló értékek a következők: 'all', 'wa', 'sa', 'nsw', 'vic', 'qld', 'tas', 'nt'	state		string	Szűrés állapot szerint. Alapértelmezés szerint a rendszer minden állapotot visszaad.

Válaszok

Name	Elérési út	Típus	Description
metaadat	metadata	apiMetaDataModel	Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.
gyűjtemény	collection	array of stationModel	Állomások gyűjteménye

Definíciók

apiMetaDataModel

Az API-hívással kapcsolatos hasznos információkat tartalmazó összes válasz burkolója.

Name	Elérési út	Típus	Description
állapot	status	integer	állapot
links	links	linksModel	A végponthoz kapcsolódó hivatkozások sorozata.
gyűjtemény	collection	paginationModel	Lapozás részletei

yellowSpotModel

modell

Name	Elérési út	Típus	Description
date	date	string	A dátum.
minimális	temperature.minimum	float	A napi minimális hőmérséklet.
maximális	temperature.maximum	float	A napi maximális hőmérséklet.
átlagos	temperature.average	float	A napi átlaghőmérséklet.
movingAverage	temperature.movingAverage	float	A mozgóátlag.
eső	rainfall.rain	float	Az időszak napi csapadéka
movingSum	rainfall.movingSum	float	A csapadék mozgó összege.
megfelelő	suitable		A modell megfelelő
érésProgress	maturationProgress		Modell érési folyamata

maturationModel

érés

Name	Elérési út	Típus	Description
date	date	string	A lejárat számított dátuma, ha megtörtént.
haladás	progress	float	Jelenlegi érés a cél százalékos értékeként a kérelem dátumától kezdve. Ha a kérelem dátuma a lejárat számított dátuma, akkor ez 100%; ha utána nagyobb lesz.
céladatbázis	target	integer	Az érés eléréséhez szükséges megfelelő napok száma.

soilWaterModel

Talajvízadatok

Name	Elérési út	Típus	Description
soilWater	soilWater	array of object	a talajvíz adatai
date	soilWater.date	string	A nyári kezdési dátum.
Csapadék	soilWater.rainfall	float	Az eső mennyisége, amely a napon esett.
ugar	soilWater.fallow	float	A talajvíz mm-ben egy pardockhoz.
körülvág	soilWater.crop	float	A talajvíz mm-ben egy levágott paddockhoz.
breakOfSeason	breakOfSeason	string	Szezontörés

potentialYieldModel

Potenciális hozamadatok

Name	Elérési út	Típus	Description
forecastDate	summary.forecastDate	string	forecastDate
inGrowingSeason	summary.inGrowingSeason	boolean	inGrowingSeason
startDate	summary.summer.startDate	string	A nyári kezdési dátum.
befejezési dátum	summary.summer.endDate	string	A nyári időszak vége (a szezon kezdete előtti nap)
cumulativeRainfall	summary.summer.cumulativeRainfall	float	A nyári időszakban esett eső mennyisége.
decilis	summary.summer.decile	integer	A történelmi hanyatlás ezen a nyáron eső esik bele.
startDate	summary.growingSeason.startDate	string	A szezon kezdete
befejezési dátum	summary.growingSeason.endDate	string	Az a dátum, amikor a szezon véget ér, vagy az aktuális dátum, ha jelenleg a szezonon belül van.
cumulativeRainfall	summary.growingSeason.cumulativeRainfall	float	Az eső mennyisége, amely a kezdési és a befejezési dátum között esett.
decilis	summary.growingSeason.decile	integer	Tekintettel a jelenlegi kumulatív csapadékra, ez az a történelmi decilis, amelybe a csapadék beleférne.
potentialYield	potentialYield	array of object	A potenciális hozam és a várható csapadék a szezonban, decilis.
decilis	potentialYield.decile	integer	Az 1 és 9 közötti decilis
projectedRainfall	potentialYield.projectedRainfall	float	A várható csapadék a decilis mm- ben.
potentialYield	potentialYield.potentialYield		A potenciális hozam tonnában/ha-ban.

stationRainfallModel

Name	Elérési út	Típus	Description
forecastDate	forecastDate	string	Ez az egyedi, kis- és nagybetűkre érzékeny időjárási állomás kódja.
startDate	summary.summer.startDate	string	A nyári kezdési dátum.
befejezési dátum	summary.summer.endDate	string	A nyári időszak vége (a szezon kezdete előtti nap)
cumulativeRainfall	summary.summer.cumulativeRainfall	float	A nyári időszakban esett eső mennyisége.
decilis	summary.summer.decile	integer	A történelmi hanyatlás ezen a nyáron eső esik bele.
startDate	summary.season.startDate	string	A szezon kezdési dátuma.
befejezési dátum	summary.season.endDate	string	Az a dátum, amikor a szezon véget ér, vagy az aktuális dátum, ha jelenleg a szezonon belül van
cumulativeRainfall	summary.season.cumulativeRainfall	float	Az eső mennyisége, amely a kezdési és a befejezési dátum között esett.
decilis	summary.season.decile	integer	Tekintettel a jelenlegi kumulatív csapadékra, ez az a történelmi decilis, amelybe a csapadék beleférne.
currentSeasonalRainfall	summary.currentSeasonalRainfall	array of object	A szezon csapadékösszegzője
date	summary.currentSeasonalRainfall.date	string	Az esőzés dátuma.
Csapadék	summary.currentSeasonalRainfall.rainfall	float	Az adott napon bekövetkezett csapadék.
cumulativeRainfall	summary.currentSeasonalRainfall.cumulativeRainfall	float	Az idei szezonban eddig bekövetkezett halmozott csapadék.
projectedSeasonalRainfall	summary.projectedSeasonalRainfall	array of object	Az előre jelzett szezon csapadéka
date	summary.projectedSeasonalRainfall.date	string	Az előre jelzett csapadék dátuma.
deciles	summary.projectedSeasonalRainfall.deciles	array of object
decilis	summary.projectedSeasonalRainfall.deciles.decile	integer	Az 1 és 9 közötti decilis
Csapadék	summary.projectedSeasonalRainfall.deciles.rainfall	float	A várható csapadék a decilis.
historicalRainfall	summary.historicalRainfall	array of object	A történelmi szezon csapadék
date	summary.historicalRainfall.date	string	A történelmi csapadék hónapja és napja deciles.
deciles	summary.historicalRainfall.deciles	array of object	Az előre jelzett csapadékértékek decilis szerint.
decilis	summary.historicalRainfall.deciles.decile	integer	Az 1 és 9 közötti decilis
Csapadék	summary.historicalRainfall.deciles.rainfall	float	A várható csapadék a decilis.

paginationModel

Lapozás részletei

Name	Elérési út	Típus	Description
count	count	integer	count
limit	limit	integer	limit
eltolás	offset	integer	eltolás
links	links	linksModel	A végponthoz kapcsolódó hivatkozások sorozata.

stationModel

Name	Elérési út	Típus	Description
stationCode	stationCode	string	Az állomás egyedi azonosítója. Kis- és nagybetűk megkülönböztetése.
stationName	stationName	string	A meteorológiai állomás olvasható neve.
latitude	latitude	float	Az időjárási állomás szélessége decimális fokban, térképen való megjelenítéshez.
hosszúság	longitude	float	Az időjárási állomás hosszúsága decimális fokban, térképen való megjelenítéshez.
tulajdonos	owner	string	A meteorológiai állomás tulajdonosa.
state	state	string	Az ausztrál államban, amelyben az állomás található.
startYear	startYear	number	Az állomás indításának éve
endYear	endYear	boolean	Az az év, amikor az állomást kikapcsolták. Null érték, ha még mindig fut.

linksModel

A végponthoz kapcsolódó hivatkozások sorozata.

Name	Elérési út	Típus	Description
URL	href	string	Annak a lapnak az URL-címét adja meg, amelyre a hivatkozás mutat.
Kapcsolat	rel	string	Az aktuális dokumentum és a csatolt dokumentum közötti kapcsolatot adja meg.