Partilhar via


Airly (Editora Independente)

A Airly fornece dados precisos e hiperlocais sobre a poluição do ar em sua comunidade. Este é o primeiro passo para compreender os riscos para a saúde e fazer melhorias.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Tomasz Poszytek
URL https://aka.ms/poszytek
Email tomasz@poszytek.eu
Metadados do conector
Editora Tomasz Poszytek
Sítio Web https://airly.org/
Política de privacidade https://airly.org/en/terms-conditions/
Categorias Internet das Coisas; Estilo de vida e entretenimento

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de API securestring A chave de API para esta api Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Obtenha as instalações mais próximas

O ponto de extremidade retorna a lista de instalações mais próximas de um determinado ponto, ordenadas por distância a esse ponto.

Obtenha as medições mais próximas

O ponto de extremidade retorna medições para uma instalação mais próxima de um determinado local.

Obtenha medições disponíveis

O endpoint retorna uma lista de todos os tipos de medição suportados na API, juntamente com seus nomes e unidades.

Obter instalação por ID

A operação retorna metadados de instalação única, fornecidos por InstallationId.

Obter medições para instalação

Endpoint retorna medições para instalação de concreto fornecidas por InstallationId.

Obter medições para um ponto

O ponto de extremidade retorna medições para qualquer localização geográfica. Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado). O valor retornado é uma média ponderada, com o peso inversamente proporcional à distância do sensor até o ponto dado.

Obter índices disponíveis

O ponto de extremidade retorna uma lista de todos os tipos de índice suportados na API, juntamente com listas de níveis definidos por cada tipo de índice.

Obtenha as instalações mais próximas

O ponto de extremidade retorna a lista de instalações mais próximas de um determinado ponto, ordenadas por distância a esse ponto.

Parâmetros

Name Chave Necessário Tipo Description
Latitude
lat True float

Latitude como grau decimal, por exemplo, 50,062006.

Longitude
lng True float

Longitude como grau decimal, por exemplo, 19,940984.

Distância máxima (KM)
maxDistanceKM float

Valor padrão 3.0. Todas as instalações devolvidas devem estar localizadas dentro deste limite a partir do ponto determinado (em km). Valor negativo significa sem limite.

Max retornou resultados
maxResults integer

Valor padrão 1. Número máximo de instalações a devolver. Valor negativo significa sem limite

Devoluções

Name Caminho Tipo Description
array of object
Id
id integer

Identificador de instalação exclusivo. Tendo InstallationId, você pode consultar medições de uma instalação específica.

Latitude
location.latitude float

Coordenadas de instalação - latitude. Localização exata do sensor no mapa.

Longitude
location.longitude float

Coordenadas de instalação - longitude. Localização exata do sensor no mapa.

ID da localização
locationId integer

Identificador de localização único.

Country
address.country string

País de instalação. O atributo é opcional, pode estar vazio ou nulo.

City
address.city string

Cidade de instalação. O atributo é opcional, pode estar vazio ou nulo.

Rua
address.street string

Rua da instalação. O atributo é opcional, pode estar vazio ou nulo.

Número
address.number string

Número da rua de instalação. O atributo é opcional, pode estar vazio ou nulo.

Endereço de visualização 1
address.displayAddress1 string

Campo extra que descreve o endereço, por exemplo, nome ou número da escola. Campo opcional.

Endereço de visualização 2
address.displayAddress2 string

Campo extra que descreve o endereço, por exemplo, nome ou número da escola. Campo opcional.

Elevation
elevation float

Altitude em que o dispositivo está instalado; metros acima do nível médio do mar (MAMSL).

Arejado
airly boolean

Sinalizador que indica se esta instalação é um dispositivo Airly ou não; Por exemplo, as estações GIOŚ são sinalizadas como falsas.

Id
sponsor.id integer

Identificador do patrocinador.

Nome
sponsor.name string

Nome do patrocinador desta instalação.

Description
sponsor.description string

Descrição adicional do patrocinador desta instalação.

Logótipo
sponsor.logo string

URL apontando para o logotipo do patrocinador (imagem jpg).

Link
sponsor.link string

URL apontando para o site do patrocinador.

Obtenha as medições mais próximas

O ponto de extremidade retorna medições para uma instalação mais próxima de um determinado local.

Parâmetros

Name Chave Necessário Tipo Description
Latitude
lat True number

Latitude como grau decimal, por exemplo, 50,062006.

Longitude
lng True number

Longitude como grau decimal, por exemplo, 19,940984.

Distância máxima (KM)
maxDistanceKM float

A instalação pesquisada deve estar localizada dentro deste limite a partir do ponto determinado (em km). Valor negativo significa sem limite.

Tipo de índice
indexType string

Seleciona o tipo de índice que deve ser calculado e retornado em resposta.

Linguagem
Accept-Language string

Idioma em que as descrições de texto devem ser retornadas.

Devoluções

Name Caminho Tipo Description
De DateTime - atual
current.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - atual
current.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
current.values array of object

Valores - atual.

Nome da medição - atual
current.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor de medição - corrente
current.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
current.indexes array of object

Índices - atual.

Nome do índice - atual
current.indexes.name string

Nome do índice (por exemplo, CAQI ou PIJP).

Valor do índice - atual
current.indexes.value float

Valor numérico do índice calculado.

Nível - atual
current.indexes.level string

Nível discreto do índice (por exemplo, ALTO, ou BAIXO, etc.).

Descrição - atual
current.indexes.description string

Descrição do nível do índice. O texto traduzido e retornado em um idioma de acordo com Accept-Language cabeçalho da solicitação.

Conselhos - atual
current.indexes.advice string

Texto adicional com conselhos sobre o nível atual do índice. O texto traduzido e retornado em um idioma de acordo com Accept-Language cabeçalho da solicitação.

Cor - atual
current.indexes.color string

Cor que representa o nível do índice em uma forma de triplo RGB hexadecimal (por exemplo, #D1CF1E).

standards
current.standards array of object

Normas - atuais.

Nome padrão - atual
current.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - corrente
current.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - atual
current.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - atual
current.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - atual
current.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

histórico
history array of object

Entradas históricas.

De DateTime - história
history.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - história
history.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
history.values array of object

Valores - história.

Nome da medição - histórico
history.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor da medição - histórico
history.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
history.indexes array of object

Índices - história.

Nome padrão - histórico
history.indexes.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - história
history.indexes.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - histórico
history.indexes.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Porcentagem - história
history.indexes.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - história
history.indexes.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

standards
history.standards array of object

Padrões - história.

Nome padrão - histórico
history.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - história
history.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - histórico
history.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Porcentagem - história
history.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - história
history.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

previsão
forecast array of object

Entradas de previsão.

De DateTime - previsão
forecast.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - previsão
forecast.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
forecast.values array of object

Valores - previsão.

Nome da medição - previsão
forecast.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor de medição - previsão
forecast.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
forecast.indexes array of object

Índices - previsão.

Nome padrão - previsão
forecast.indexes.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - previsão
forecast.indexes.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - previsão
forecast.indexes.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - previsão
forecast.indexes.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - previsão
forecast.indexes.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

standards
forecast.standards array of object

Normas - previsão.

Nome padrão - previsão
forecast.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - previsão
forecast.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - previsão
forecast.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - previsão
forecast.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - previsão
forecast.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

Obtenha medições disponíveis

O endpoint retorna uma lista de todos os tipos de medição suportados na API, juntamente com seus nomes e unidades.

Parâmetros

Name Chave Necessário Tipo Description
Linguagem
Accept-Language string

Idioma em que as descrições de texto devem ser retornadas.

Devoluções

Name Caminho Tipo Description
array of object
Nome
name string

Nome deste tipo de medição, por exemplo, PM10.

Etiqueta
label string

Nome descritivo deste tipo de medida (campo traduzido).

Unidade
unit string

Unidade deste tipo de medida, por exemplo, μg/m3.

Obter instalação por ID

A operação retorna metadados de instalação única, fornecidos por InstallationId.

Parâmetros

Name Chave Necessário Tipo Description
ID de instalação
InstallationID True integer

Id da instalação única para obter metadados.

Devoluções

Name Caminho Tipo Description
array of object
Id
id integer

Identificador de instalação exclusivo. Tendo InstallationId, você pode consultar medições de uma instalação específica.

Latitude
location.latitude float

Coordenadas de instalação - latitude. Localização exata do sensor no mapa.

Longitude
location.longitude float

Coordenadas de instalação - longitude. Localização exata do sensor no mapa.

ID da localização
locationId integer

Identificador de localização único.

Country
address.country string

País de instalação. O atributo é opcional, pode estar vazio ou nulo.

City
address.city string

Cidade de instalação. O atributo é opcional, pode estar vazio ou nulo.

Rua
address.street string

Rua da instalação. O atributo é opcional, pode estar vazio ou nulo.

Número
address.number string

Número da rua de instalação. O atributo é opcional, pode estar vazio ou nulo.

Endereço de visualização 1
address.displayAddress1 string

Campo extra que descreve o endereço, por exemplo, nome ou número da escola. Campo opcional.

Endereço de visualização 2
address.displayAddress2 string

Campo extra que descreve o endereço, por exemplo, nome ou número da escola. Campo opcional.

Elevation
elevation float

Altitude em que o dispositivo está instalado; metros acima do nível médio do mar (MAMSL).

Arejado
airly boolean

Sinalizador que indica se esta instalação é um dispositivo Airly ou não; Por exemplo, as estações GIOŚ são sinalizadas como falsas.

Id
sponsor.id integer

Identificador do patrocinador.

Nome
sponsor.name string

Nome do patrocinador desta instalação.

Description
sponsor.description string

Descrição adicional do patrocinador desta instalação.

Logótipo
sponsor.logo string

URL apontando para o logotipo do patrocinador (imagem jpg).

Link
sponsor.link string

URL apontando para o site do patrocinador.

Obter medições para instalação

Endpoint retorna medições para instalação de concreto fornecidas por InstallationId.

Parâmetros

Name Chave Necessário Tipo Description
ID de instalação
installationId True integer

Identificador de instalação para o qual as medições são retornadas.

Linguagem
Accept-Language string

Idioma em que as descrições de texto devem ser retornadas.

Tipo de índice
indexType string

Seleciona o tipo de índice que deve ser calculado e retornado em resposta.

Devoluções

Name Caminho Tipo Description
De DateTime - atual
current.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - atual
current.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
current.values array of object

Valores - atual.

Nome da medição - atual
current.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor de medição - corrente
current.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
current.indexes array of object

Índices - atual.

Nome do índice - atual
current.indexes.name string

Nome do índice (por exemplo, CAQI ou PIJP).

Valor do índice - atual
current.indexes.value float

Valor numérico do índice calculado.

Nível - atual
current.indexes.level string

Nível discreto do índice (por exemplo, ALTO, ou BAIXO, etc.).

Descrição - atual
current.indexes.description string

Descrição do nível do índice. O texto traduzido e retornado em um idioma de acordo com Accept-Language cabeçalho da solicitação.

Conselhos - atual
current.indexes.advice string

Texto adicional com conselhos sobre o nível atual do índice. O texto traduzido e retornado em um idioma de acordo com Accept-Language cabeçalho da solicitação.

Cor - atual
current.indexes.color string

Cor que representa o nível do índice em uma forma de triplo RGB hexadecimal (por exemplo, #D1CF1E).

standards
current.standards array of object

Normas - atuais.

Nome padrão - atual
current.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - corrente
current.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - atual
current.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - atual
current.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - atual
current.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

histórico
history array of object

Entradas históricas.

De DateTime - história
history.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - história
history.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
history.values array of object

Valores - história.

Nome da medição - histórico
history.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor da medição - histórico
history.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
history.indexes array of object

Índices - história.

Nome padrão - histórico
history.indexes.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - história
history.indexes.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - histórico
history.indexes.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Porcentagem - história
history.indexes.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - história
history.indexes.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

standards
history.standards array of object

Padrões - história.

Nome padrão - histórico
history.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - história
history.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - histórico
history.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Porcentagem - história
history.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - história
history.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

previsão
forecast array of object

Entradas de previsão.

De DateTime - previsão
forecast.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - previsão
forecast.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
forecast.values array of object

Valores - previsão.

Nome da medição - previsão
forecast.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor de medição - previsão
forecast.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
forecast.indexes array of object

Índices - previsão.

Nome padrão - previsão
forecast.indexes.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - previsão
forecast.indexes.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - previsão
forecast.indexes.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - previsão
forecast.indexes.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - previsão
forecast.indexes.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

standards
forecast.standards array of object

Normas - previsão.

Nome padrão - previsão
forecast.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - previsão
forecast.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - previsão
forecast.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - previsão
forecast.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - previsão
forecast.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

Obter medições para um ponto

O ponto de extremidade retorna medições para qualquer localização geográfica. Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado). O valor retornado é uma média ponderada, com o peso inversamente proporcional à distância do sensor até o ponto dado.

Parâmetros

Name Chave Necessário Tipo Description
Latitude
lat True number

Latitude como grau decimal, por exemplo, 50,062006.

Longitude
lng True number

Longitude como grau decimal, por exemplo, 19,940984.

Tipo de índice
indexType string

Seleciona o tipo de índice que deve ser calculado e retornado em resposta.

Linguagem
Accept-Language string

Idioma em que as descrições de texto devem ser retornadas.

Devoluções

Name Caminho Tipo Description
De DateTime - atual
current.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - atual
current.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
current.values array of object

Valores - atual.

Nome da medição - atual
current.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor de medição - corrente
current.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
current.indexes array of object

Índices - atual.

Nome do índice - atual
current.indexes.name string

Nome do índice (por exemplo, CAQI ou PIJP).

Valor do índice - atual
current.indexes.value float

Valor numérico do índice calculado.

Nível - atual
current.indexes.level string

Nível discreto do índice (por exemplo, ALTO, ou BAIXO, etc.).

Descrição - atual
current.indexes.description string

Descrição do nível do índice. O texto traduzido e retornado em um idioma de acordo com Accept-Language cabeçalho da solicitação.

Conselhos - atual
current.indexes.advice string

Texto adicional com conselhos sobre o nível atual do índice. O texto traduzido e retornado em um idioma de acordo com Accept-Language cabeçalho da solicitação.

Cor - atual
current.indexes.color string

Cor que representa o nível do índice em uma forma de triplo RGB hexadecimal (por exemplo, #D1CF1E).

standards
current.standards array of object

Normas - atuais.

Nome padrão - atual
current.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - corrente
current.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - atual
current.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - atual
current.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - atual
current.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

histórico
history array of object

Entradas históricas.

De DateTime - história
history.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - história
history.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
history.values array of object

Valores - história.

Nome da medição - histórico
history.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor da medição - histórico
history.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
history.indexes array of object

Índices - história.

Nome padrão - histórico
history.indexes.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - história
history.indexes.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - histórico
history.indexes.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Porcentagem - história
history.indexes.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - história
history.indexes.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

standards
history.standards array of object

Padrões - história.

Nome padrão - histórico
history.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - história
history.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - histórico
history.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Porcentagem - história
history.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - história
history.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

previsão
forecast array of object

Entradas de previsão.

De DateTime - previsão
forecast.fromDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de início a partir da qual os dados nesta carga útil foram medidos e calculados em média.

Till DateTime - previsão
forecast.tillDateTime string

ISO8601 carimbo de data/hora. Data e hora em UTC. O campo representa a hora de término para a qual os dados nesta carga útil foram medidos e calculados em média.

values
forecast.values array of object

Valores - previsão.

Nome da medição - previsão
forecast.values.name string

Nome (tipo) da medição dada; por exemplo, PM10.

Valor de medição - previsão
forecast.values.value float

Valor medido do tipo de medição dado, por exemplo, concentração de 25 μg/m3.

índices
forecast.indexes array of object

Índices - previsão.

Nome padrão - previsão
forecast.indexes.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - previsão
forecast.indexes.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - previsão
forecast.indexes.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - previsão
forecast.indexes.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - previsão
forecast.indexes.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

standards
forecast.standards array of object

Normas - previsão.

Nome padrão - previsão
forecast.standards.name string

Nome desta norma. Atualmente, apenas as normas da OMS são suportadas.

Poluente - previsão
forecast.standards.pollutant string

Nome do poluente ao qual esta norma se aplica, atualmente apenas as PM10 e PM25 são suportadas.

Limite - previsão
forecast.standards.limit float

Determinado nível médio de concentração do poluente que não deve ser excedido durante um determinado período de tempo; Por outras palavras, este é o valor para o qual a concentração de poluentes atinge 100% do limite.

Percentagem - previsão
forecast.standards.percent float

Valor de concentração de um dado poluente expresso em percentagem desta concentração no padrão/limite, por exemplo, para um padrão de 50μg/m3 de PM10 a concentração de 25μg/m3 é expressa como 50%.

Média - previsão
forecast.standards.averaging string

Os valores de medição são interpolados por medições médias de sensores próximos (até 1,5 km de distância do ponto dado).

Obter índices disponíveis

O ponto de extremidade retorna uma lista de todos os tipos de índice suportados na API, juntamente com listas de níveis definidos por cada tipo de índice.

Devoluções

Name Caminho Tipo Description
array of object
Nome do índice
name string

Nome do índice.

níveis
levels array of object

Lista de níveis de índices disponíveis.

Valor mínimo
levels.minValue float

Valor mínimo que o índice pode retornar para o nível dado.

Valor máximo
levels.maxValue float

Valor máximo que o índice pode retornar para o nível dado.

Valores
levels.values string

Valores que o índice pode retornar para o nível dado.

Nome do nível
levels.level string
Descrição do nível
levels.description string
Cor
levels.color string

Cor que representa o nível do índice em uma forma de triplo RGB hexadecimal (por exemplo, #D1CF1E).