Airly (niezależny wydawca)

Airly dostarcza dokładne, hiper-lokalne dane na temat zanieczyszczenia powietrza w społeczności. Jest to pierwszy krok w kierunku zrozumienia zagrożeń dla zdrowia i wprowadzania ulepszeń.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa	Class	Regions
Copilot Studio	Premium	Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD)
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD)
Power Apps	Premium	Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD)
Power Automate	Premium	Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD)

Kontakt
Name	Tomasz Poszytek
adres URL	https://aka.ms/poszytek
Email	tomasz@poszytek.eu

Metadane łącznika
Publisher	Tomasz Poszytek
Witryna internetowa	https://airly.org/
Zasady ochrony prywatności	https://airly.org/en/terms-conditions/
Kategorie	Internet rzeczy; Styl życia i rozrywka

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:


Wartość domyślna	Parametry tworzenia połączenia.	Wszystkie regiony	Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name	Typ	Description	Wymagane
Klucz interfejsu API	securestring	Klucz interfejsu API dla tego interfejsu API	Prawda

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	100	60 sekund

Akcje

Pobieranie instalacji według identyfikatora	Operacja zwraca metadane pojedynczej instalacji podane przez InstallationId.
Pobieranie najbliższych pomiarów	Punkt końcowy zwraca miary instalacji znajdującej się najbliżej danej lokalizacji.
Pobieranie pomiarów dla punktu	Punkt końcowy zwraca miary dla dowolnej lokalizacji geograficznej. Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu). Zwracana wartość jest średnią ważoną, z odwrotnie proporcjonalną do odległości od czujnika do danego punktu.
Pobieranie pomiarów instalacji	Punkt końcowy zwraca miary dla instalacji podanej przez InstallationId.
Uzyskiwanie dostępnych indeksów	Punkt końcowy zwraca listę wszystkich typów indeksów obsługiwanych w interfejsie API wraz z listami poziomów zdefiniowanych dla każdego typu indeksu.
Uzyskiwanie dostępnych pomiarów	Punkt końcowy zwraca listę wszystkich typów miar obsługiwanych w interfejsie API wraz z ich nazwami i jednostkami.
Uzyskiwanie najbliższych instalacji	Punkt końcowy zwraca listę instalacji znajdujących się najbliżej danego punktu posortowanego według odległości do tego punktu.

Pobieranie instalacji według identyfikatora

Identyfikator operacji:: GetInstallationByID

Operacja zwraca metadane pojedynczej instalacji podane przez InstallationId.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator instalacji	InstallationID	True	integer	Identyfikator pojedynczej instalacji w celu pobrania metadanych.

Zwraca

Nazwa	Ścieżka	Typ	Opis
		array of object
Id	id	integer	Unikatowy identyfikator instalacji. O identyfikatorze InstallationId można wykonywać zapytania dotyczące pomiarów z konkretnej instalacji.
Szerokość	location.latitude	float	Współrzędne instalacji — szerokość geograficzna. Dokładna lokalizacja czujnika na mapie.
Długość	location.longitude	float	Współrzędne instalacji — długość geograficzna. Dokładna lokalizacja czujnika na mapie.
Identyfikator lokalizacji	locationId	integer	Unikatowy identyfikator lokalizacji.
Country	address.country	string	Kraj instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Miejscowość	address.city	string	Miasto instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Ulica	address.street	string	Ulica instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Number	address.number	string	Numer ulicy instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Adres wyświetlania 1	address.displayAddress1	string	Dodatkowe pole opisujące adres, np. nazwę szkoły lub numer. Pole opcjonalne.
Wyświetl adres 2	address.displayAddress2	string	Dodatkowe pole opisujące adres, np. nazwę szkoły lub numer. Pole opcjonalne.
Elevation	elevation	float	Wysokość, na której zainstalowano urządzenie; metrów powyżej średniego poziomu morza (mamsl).
Airly	airly	boolean	Flaga wskazująca, czy ta instalacja jest urządzeniem Airly, czy nie; np. stacje GIOŚ są oznaczone jako fałszywe.
Id	sponsor.id	integer	Identyfikator sponsora.
Name	sponsor.name	string	Nazwa sponsora tej instalacji.
Description	sponsor.description	string	Dodatkowy opis sponsora tej instalacji.
Logo	sponsor.logo	string	Adres URL wskazujący logo sponsora (obraz jpg).
Link	sponsor.link	string	Adres URL wskazujący witrynę internetową sponsora.

Pobieranie najbliższych pomiarów

Identyfikator operacji:: GetNearestMeasurements

Punkt końcowy zwraca miary instalacji znajdującej się najbliżej danej lokalizacji.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Szerokość	lat	True	number	Szerokość geograficzna jako stopień dziesiętny, np. 50,062006.
Długość	lng	True	number	Długość geograficzna jako stopień dziesiętny, np. 19,940984.
Maksymalna odległość (KM)	maxDistanceKM		float	Przeszukana instalacja musi znajdować się w tym limicie od danego punktu (w km). Wartość ujemna oznacza brak limitu.
Typ indeksu	indexType		string	Wybiera typ indeksu, który ma być obliczany i zwracany w odpowiedzi.
Język	Accept-Language		string	Język, w którym powinny zostać zwrócone opisy tekstu.

Zwraca

Nazwa	Ścieżka	Typ	Opis
Od daty/godziny — bieżąca	current.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — bieżąca	current.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	current.values	array of object	Wartości — bieżące.
Nazwa miary — bieżąca	current.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — bieżąca	current.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	current.indexes	array of object	Indeksy — bieżące.
Nazwa indeksu — bieżąca	current.indexes.name	string	Nazwa indeksu (np. CAQI lub PIJP).
Wartość indeksu — bieżąca	current.indexes.value	float	Wartość liczbowa indeksu obliczeniowego.
Poziom — bieżący	current.indexes.level	string	Dyskretny poziom indeksu (np. WYSOKI lub NISKI itp.).
Opis — bieżący	current.indexes.description	string	Opis poziomu indeksu. Tekst przetłumaczony i zwrócony w języku zgodnie z nagłówkiem żądania Accept-Language.
Porady — aktualne	current.indexes.advice	string	Dodatkowy tekst z poradami dotyczącymi bieżącego poziomu indeksu. Tekst przetłumaczony i zwrócony w języku zgodnie z nagłówkiem żądania Accept-Language.
Kolor — bieżący	current.indexes.color	string	Kolor reprezentujący poziom indeksu w postaci trójki szesnastkowej RGB (np. #D1CF1E).
standards	current.standards	array of object	Standardy — bieżące.
Nazwa Standardowa — bieżąca	current.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prąd	current.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — bieżący	current.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — bieżący	current.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnie — bieżące	current.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
historia	history	array of object	Wpisy historyczne.
Od daty/godziny — historia	history.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — historia	history.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	history.values	array of object	Wartości — historia.
Nazwa miary — historia	history.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — historia	history.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	history.indexes	array of object	Indeksy — historia.
Nazwa Standardowa — historia	history.indexes.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — historia	history.indexes.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — historia	history.indexes.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — historia	history.indexes.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — historia	history.indexes.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
standards	history.standards	array of object	Standardy — historia.
Nazwa Standardowa — historia	history.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — historia	history.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — historia	history.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — historia	history.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — historia	history.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
prognoza	forecast	array of object	Wpisy prognozy.
Od daty/godziny — prognoza	forecast.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — prognoza	forecast.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	forecast.values	array of object	Wartości — prognoza.
Nazwa miary — prognoza	forecast.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — prognoza	forecast.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	forecast.indexes	array of object	Indeksy — prognoza.
Nazwa Standardowa — prognoza	forecast.indexes.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prognoza	forecast.indexes.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — prognoza	forecast.indexes.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — prognoza	forecast.indexes.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — prognoza	forecast.indexes.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
standards	forecast.standards	array of object	Standardy — prognoza.
Nazwa Standardowa — prognoza	forecast.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prognoza	forecast.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — prognoza	forecast.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — prognoza	forecast.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — prognoza	forecast.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).

Pobieranie pomiarów dla punktu

Identyfikator operacji:: GetMeasurementsForPoint

Punkt końcowy zwraca miary dla dowolnej lokalizacji geograficznej. Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu). Zwracana wartość jest średnią ważoną, z odwrotnie proporcjonalną do odległości od czujnika do danego punktu.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Szerokość	lat	True	number	Szerokość geograficzna jako stopień dziesiętny, np. 50,062006.
Długość	lng	True	number	Długość geograficzna jako stopień dziesiętny, np. 19,940984.
Typ indeksu	indexType		string	Wybiera typ indeksu, który ma być obliczany i zwracany w odpowiedzi.
Język	Accept-Language		string	Język, w którym powinny zostać zwrócone opisy tekstu.

Zwraca

Nazwa	Ścieżka	Typ	Opis
Od daty/godziny — bieżąca	current.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — bieżąca	current.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	current.values	array of object	Wartości — bieżące.
Nazwa miary — bieżąca	current.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — bieżąca	current.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	current.indexes	array of object	Indeksy — bieżące.
Nazwa indeksu — bieżąca	current.indexes.name	string	Nazwa indeksu (np. CAQI lub PIJP).
Wartość indeksu — bieżąca	current.indexes.value	float	Wartość liczbowa indeksu obliczeniowego.
Poziom — bieżący	current.indexes.level	string	Dyskretny poziom indeksu (np. WYSOKI lub NISKI itp.).
Opis — bieżący	current.indexes.description	string	Opis poziomu indeksu. Tekst przetłumaczony i zwrócony w języku zgodnie z nagłówkiem żądania Accept-Language.
Porady — aktualne	current.indexes.advice	string	Dodatkowy tekst z poradami dotyczącymi bieżącego poziomu indeksu. Tekst przetłumaczony i zwrócony w języku zgodnie z nagłówkiem żądania Accept-Language.
Kolor — bieżący	current.indexes.color	string	Kolor reprezentujący poziom indeksu w postaci trójki szesnastkowej RGB (np. #D1CF1E).
standards	current.standards	array of object	Standardy — bieżące.
Nazwa Standardowa — bieżąca	current.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prąd	current.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — bieżący	current.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — bieżący	current.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnie — bieżące	current.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
historia	history	array of object	Wpisy historyczne.
Od daty/godziny — historia	history.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — historia	history.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	history.values	array of object	Wartości — historia.
Nazwa miary — historia	history.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — historia	history.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	history.indexes	array of object	Indeksy — historia.
Nazwa Standardowa — historia	history.indexes.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — historia	history.indexes.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — historia	history.indexes.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — historia	history.indexes.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — historia	history.indexes.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
standards	history.standards	array of object	Standardy — historia.
Nazwa Standardowa — historia	history.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — historia	history.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — historia	history.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — historia	history.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — historia	history.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
prognoza	forecast	array of object	Wpisy prognozy.
Od daty/godziny — prognoza	forecast.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — prognoza	forecast.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	forecast.values	array of object	Wartości — prognoza.
Nazwa miary — prognoza	forecast.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — prognoza	forecast.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	forecast.indexes	array of object	Indeksy — prognoza.
Nazwa Standardowa — prognoza	forecast.indexes.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prognoza	forecast.indexes.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — prognoza	forecast.indexes.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — prognoza	forecast.indexes.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — prognoza	forecast.indexes.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
standards	forecast.standards	array of object	Standardy — prognoza.
Nazwa Standardowa — prognoza	forecast.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prognoza	forecast.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — prognoza	forecast.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — prognoza	forecast.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — prognoza	forecast.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).

Pobieranie pomiarów instalacji

Identyfikator operacji:: GetMeasurementsForInstallation

Punkt końcowy zwraca miary dla instalacji podanej przez InstallationId.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Identyfikator instalacji	installationId	True	integer	Identyfikator instalacji, dla którego są zwracane pomiary.
Język	Accept-Language		string	Język, w którym powinny zostać zwrócone opisy tekstu.
Typ indeksu	indexType		string	Wybiera typ indeksu, który ma być obliczany i zwracany w odpowiedzi.

Zwraca

Nazwa	Ścieżka	Typ	Opis
Od daty/godziny — bieżąca	current.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — bieżąca	current.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	current.values	array of object	Wartości — bieżące.
Nazwa miary — bieżąca	current.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — bieżąca	current.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	current.indexes	array of object	Indeksy — bieżące.
Nazwa indeksu — bieżąca	current.indexes.name	string	Nazwa indeksu (np. CAQI lub PIJP).
Wartość indeksu — bieżąca	current.indexes.value	float	Wartość liczbowa indeksu obliczeniowego.
Poziom — bieżący	current.indexes.level	string	Dyskretny poziom indeksu (np. WYSOKI lub NISKI itp.).
Opis — bieżący	current.indexes.description	string	Opis poziomu indeksu. Tekst przetłumaczony i zwrócony w języku zgodnie z nagłówkiem żądania Accept-Language.
Porady — aktualne	current.indexes.advice	string	Dodatkowy tekst z poradami dotyczącymi bieżącego poziomu indeksu. Tekst przetłumaczony i zwrócony w języku zgodnie z nagłówkiem żądania Accept-Language.
Kolor — bieżący	current.indexes.color	string	Kolor reprezentujący poziom indeksu w postaci trójki szesnastkowej RGB (np. #D1CF1E).
standards	current.standards	array of object	Standardy — bieżące.
Nazwa Standardowa — bieżąca	current.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prąd	current.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — bieżący	current.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — bieżący	current.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnie — bieżące	current.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
historia	history	array of object	Wpisy historyczne.
Od daty/godziny — historia	history.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — historia	history.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	history.values	array of object	Wartości — historia.
Nazwa miary — historia	history.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — historia	history.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	history.indexes	array of object	Indeksy — historia.
Nazwa Standardowa — historia	history.indexes.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — historia	history.indexes.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — historia	history.indexes.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — historia	history.indexes.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — historia	history.indexes.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
standards	history.standards	array of object	Standardy — historia.
Nazwa Standardowa — historia	history.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — historia	history.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — historia	history.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — historia	history.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — historia	history.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
prognoza	forecast	array of object	Wpisy prognozy.
Od daty/godziny — prognoza	forecast.fromDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas rozpoczęcia, od którego dane w tym ładunku zostały zmierzone i uśrednione.
Till DateTime — prognoza	forecast.tillDateTime	string	ISO8601 znacznik czasu. Data i godzina w formacie UTC. Pole reprezentuje czas zakończenia, do którego dane w tym ładunku zostały zmierzone i uśrednione.
values	forecast.values	array of object	Wartości — prognoza.
Nazwa miary — prognoza	forecast.values.name	string	Nazwa (typ) podanej miary; np. PM10.
Wartość miary — prognoza	forecast.values.value	float	Mierzona wartość danego typu pomiaru, np. stężenie 25μg/m3.
Indeksy	forecast.indexes	array of object	Indeksy — prognoza.
Nazwa Standardowa — prognoza	forecast.indexes.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prognoza	forecast.indexes.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — prognoza	forecast.indexes.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — prognoza	forecast.indexes.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — prognoza	forecast.indexes.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).
standards	forecast.standards	array of object	Standardy — prognoza.
Nazwa Standardowa — prognoza	forecast.standards.name	string	Nazwa tego standardu. Obecnie obsługiwane są tylko standardy WHO.
Zanieczyszczający — prognoza	forecast.standards.pollutant	string	Nazwa zanieczyszczającego, do którego stosuje się ten standard, obecnie obsługiwane są tylko pm10 i PM25.
Limit — prognoza	forecast.standards.limit	float	Pewien średni poziom stężenia zanieczyszczeń, który nie powinien być przekroczony w danym okresie czasu; innymi słowy, jest to wartość, dla której stężenie zanieczyszczeń osiąga 100% limitu.
Procent — prognoza	forecast.standards.percent	float	Wartość stężenia danego zanieczyszczeń wyrażonego jako wartość procentowa tego stężenia w normie /granicze, np. dla standardu 50μg/m3 PM10 stężenie 25μg/m3 jest wyrażone jako 50%.
Średnio — prognoza	forecast.standards.averaging	string	Wartości pomiarów są interpolowane przez pomiary średnie z pobliskich czujników (do 15 km od danego punktu).

Uzyskiwanie dostępnych indeksów

Identyfikator operacji:: GetAvailableIndexes

Punkt końcowy zwraca listę wszystkich typów indeksów obsługiwanych w interfejsie API wraz z listami poziomów zdefiniowanych dla każdego typu indeksu.

Zwraca

Nazwa	Ścieżka	Typ	Opis
		array of object
Nazwa indeksu	name	string	Nazwa indeksu.
Poziomy	levels	array of object	Lista dostępnych poziomów indeksów.
Wartość minimalna	levels.minValue	float	Minimalna wartość indeksu może zwrócić dla danego poziomu.
Wartość maksymalna	levels.maxValue	float	Maksymalna wartość indeksu może zwrócić dla danego poziomu.
Wartości	levels.values	string	Wartości, które indeks może zwrócić dla danego poziomu.
Nazwa poziomu	levels.level	string
Opis poziomu	levels.description	string
Kolor	levels.color	string	Kolor reprezentujący poziom indeksu w postaci trójki szesnastkowej RGB (np. #D1CF1E).

Uzyskiwanie dostępnych pomiarów

Identyfikator operacji:: GetAvailableMeasurements

Punkt końcowy zwraca listę wszystkich typów miar obsługiwanych w interfejsie API wraz z ich nazwami i jednostkami.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Język	Accept-Language		string	Język, w którym powinny zostać zwrócone opisy tekstu.

Zwraca

Nazwa	Ścieżka	Typ	Opis
		array of object
Name	name	string	Nazwa tego typu miary, np. PM10.
Etykieta	label	string	Opisowa nazwa tego typu miary (przetłumaczone pole).
Unit	unit	string	Jednostka tego typu pomiaru, np. μg/m3.

Uzyskiwanie najbliższych instalacji

Identyfikator operacji:: GetNearestInstallations

Punkt końcowy zwraca listę instalacji znajdujących się najbliżej danego punktu posortowanego według odległości do tego punktu.

Parametry

Nazwa	Klucz	Wymagane	Typ	Opis
Szerokość	lat	True	float	Szerokość geograficzna jako stopień dziesiętny, np. 50,062006.
Długość	lng	True	float	Długość geograficzna jako stopień dziesiętny, np. 19,940984.
Maksymalna odległość (KM)	maxDistanceKM		float	Wartość domyślna 3.0. Wszystkie zwrócone instalacje muszą znajdować się w tym limicie od danego punktu (w km). Wartość ujemna oznacza brak limitu.
Maksymalna liczba zwróconych wyników	maxResults		integer	Wartość domyślna 1. Maksymalna liczba instalacji do zwrócenia. Wartość ujemna oznacza brak limitu

Zwraca

Nazwa	Ścieżka	Typ	Opis
		array of object
Id	id	integer	Unikatowy identyfikator instalacji. O identyfikatorze InstallationId można wykonywać zapytania dotyczące pomiarów z konkretnej instalacji.
Szerokość	location.latitude	float	Współrzędne instalacji — szerokość geograficzna. Dokładna lokalizacja czujnika na mapie.
Długość	location.longitude	float	Współrzędne instalacji — długość geograficzna. Dokładna lokalizacja czujnika na mapie.
Identyfikator lokalizacji	locationId	integer	Unikatowy identyfikator lokalizacji.
Country	address.country	string	Kraj instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Miejscowość	address.city	string	Miasto instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Ulica	address.street	string	Ulica instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Number	address.number	string	Numer ulicy instalacji. Atrybut jest opcjonalny, może być pusty lub ma wartość null.
Adres wyświetlania 1	address.displayAddress1	string	Dodatkowe pole opisujące adres, np. nazwę szkoły lub numer. Pole opcjonalne.
Wyświetl adres 2	address.displayAddress2	string	Dodatkowe pole opisujące adres, np. nazwę szkoły lub numer. Pole opcjonalne.
Elevation	elevation	float	Wysokość, na której zainstalowano urządzenie; metrów powyżej średniego poziomu morza (mamsl).
Airly	airly	boolean	Flaga wskazująca, czy ta instalacja jest urządzeniem Airly, czy nie; np. stacje GIOŚ są oznaczone jako fałszywe.
Id	sponsor.id	integer	Identyfikator sponsora.
Name	sponsor.name	string	Nazwa sponsora tej instalacji.
Description	sponsor.description	string	Dodatkowy opis sponsora tej instalacji.
Logo	sponsor.logo	string	Adres URL wskazujący logo sponsora (obraz jpg).
Link	sponsor.link	string	Adres URL wskazujący witrynę internetową sponsora.

Udostępnij przez

Airly (niezależny wydawca)

Tworzenie połączenia

Domyślny

Limity ograniczania

Akcje

Pobieranie instalacji według identyfikatora

Parametry

Zwraca

Pobieranie najbliższych pomiarów

Parametry

Zwraca

Pobieranie pomiarów dla punktu

Parametry

Zwraca

Pobieranie pomiarów instalacji

Parametry

Zwraca

Uzyskiwanie dostępnych indeksów

Zwraca

Uzyskiwanie dostępnych pomiarów

Parametry

Zwraca

Uzyskiwanie najbliższych instalacji

Parametry

Zwraca