Widget Qualità dell'aria: nuovo feed migliorato
Air Quality Widget - New Improved Feed

Posted on July 28th 2015
Condividere: aqicn.org/faq/2015-07-28/air-quality-widget-new-improved-feed/it/
{ widget : feed }

Per migliorare l'integrazione dei nostri widget AQI all'interno di siti Web esterni, abbiamo sviluppato un nuovo feed API widget. Rispetto al feed widget esistente, questo nuovo feed API offre molta più flessibilità per l'integrazione, ma anche molte più opzioni per personalizzare l'aspetto del widget.

Beijing Air Quality.
29
Good
Updated on Wed. 1:00
PM2.5 AQI
Beijing PM25 (fine particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
21
PM10 AQI
Beijing PM10 (respirable particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
11
O3 AQI
Beijing O3 (ozone)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
29

Puoi, ad esempio, visualizzare un piccolo widget semplice come Beijing

29
(muovi il mouse sul numero AQI per visualizzare i dettagli) o un widget più grande con i dettagli sugli inquinanti delle ultime 24 ore, come mostrato a destra.

Il nuovo framework supporta anche modelli, più lingue (inglese, cinese semplificato e tradizionale, spagnolo, ...) nonché la possibilità di effettuare integrazioni programmatiche con callback Javascript basati su dati.

A. Configurazione di base

L'integrazione di base è semplice e diretta. Devi prima aggiungere il seguente pezzo di codice:

  
<script  type="text/javascript"  charset="utf-8">  
	(function  (w,  d,  t,  f)  {  
		w[f]  =  w[f]  ||  function  (c,  k,  n)  {  
			s  =  w[f],  k  =  s['k']  =  (s['k']  ||  (k  ?  ('&k='  +  k)  :  ''));  s['c']  =  
				c  =  (c  instanceof  Array)  ?  c  :  [c];  s['n']  =  n  =  n  ||  0;  L  =  d.createElement(t),  e  =  d.getElementsByTagName(t)[0];  
			L.async  =  1;  L.src  =  '//feed.aqicn.org/feed/'  +  (c[n].city)  +  '/'  +  (c[n].lang  ||  '')  +  '/feed.v1.js?n='  +  n  +  k;  
			e.parentNode.insertBefore(L,  e);  
		};  
	})(window,  document,  'script',  '_aqiFeed');    
</script>

Quindi, aggiungi semplicemente questo altro codice per includere il widget:

  
<span  id="city-aqi-container"></span>  
  
<script  type="text/javascript"  charset="utf-8">  
	_aqiFeed({  container:  "city-aqi-container",  city:  "beijing"  });  
</script>

La funzione `_aqiFeed` prende come argomento il blocco di configurazione per il widget. Il parametro `container: "city-aqi-container"` si riferisce all'id del tag in cui si vuole inserire il widget (es. `<span id='city-aqi-container'></span>`), e il parametro city il nome della città per la quale si desidera mostrare la lettura attuale della qualità dell'aria (ad esempio `city: "london"`).

B. Specificazione della lingua

北京
29

È inoltre possibile specificare la lingua da utilizzare impostando l'opzione lang . Ad esempio, per includere il widget in cinese (come mostrato a destra), utilizza il seguente codice:

  
_aqiFeed({  
	container:"city-aqi-container",  
	city:"beijing",  
	lang:"cn"  
});  

Le lingue attualmente supportate sono:

  • "en": English
  • "cn": Chinese
  • "jp": Japanese
  • "es": Spanish
  • "kr": Korean
  • "ru": Russian
  • "hk": Traditional Chinese
  • "fr": French
  • "pl": Polish
  • "de": German
  • "pt": Portuguese
  • "vn": Vietnamese
  • "it": Italian
  • "id": Indonesian
  • "nl": Dutch
  • "fa": Persian
  • "th": Thai
  • "hu": Hungarian
  • "el": Greek
  • "ro": Romanian
  • "bg": Bulgarian
  • "ur": Urdu
  • "hi": Hindi
  • "ar": Arabic
  • "sr": Serbian
  • "bn": Bangla
  • "hu": Hungarian
  • "bs": Bosnian
  • "hr": Croatian
  • "tr": Turkish
  • "uk": Ukrainian
  • "cs": Czech
  • "be": Belarusian
  • "km": Khmer
  • "lo": Lao

    Se non specificato o impostato su null , viene utilizzato l'inglese.

  • C. Specificazione del formato di visualizzazione

    Beijing AQI is
    29

    on Wednesday 1:00

    È possibile personalizzare il testo da visualizzare all'interno del widget specificando l'opzione display . Ad esempio, per visualizzare sia il nome testuale "AQI" che l'orario di aggiornamento (come mostrato nel widget a sinistra), è possibile utilizzare il seguente codice:

    >
      
    _aqiFeed({    
    	display:"%cityname  AQI  is  %aqi<br><small>on  %date</small>",  
    	container:"city-aqi-container-display",    
    	city:"beijing"  
    });  
    

    Il parametro display è una stringa basata su HTML e può contenere una qualsiasi delle seguenti parole chiave:

    • `%cityname` per il nome della città (ad esempio Beijing ),
    • `%aqi` per il valore AQI decorato (ad esempio 58 ),
    • "%aqiv" per il valore AQI non decorato (testo grezzo) (ad esempio 58 ),
    • `%style` per la dichiarazione css dei dettagli AQI decorati (ad esempio background-color: #ffde33;color:#000000; ),
    • "%date" per l'ora in cui l'AQI è stato aggiornato (ad esempio Wed 20:00 ),
    • "%impact" per l'impatto sulla salute associato (ad es. Good , Moderate ...)
    • "%attribution" per l'attribuzione dei dati AQI (ad es. Beijing Environmental Protection Monitoring Center )
    • "%dettagli" per i dettagli AQI completi (il contenuto del popup visualizzato quando si sposta il mouse sul valore AQI).

    Ecco alcuni esempi:

    Display Configuration Result
    %cityname Air Quality is <b>%impact</b>.
    Beijing Air Quality is Good.
    %aqi <small>(%impact)</small>
    29
    (Good)
    <span style='%style;font-size:12px;padding:5px 10px;'>%cityname AQI: %impact</span>
    Beijing AQI: Good
    %cityname Air Quality is <span style='%style;padding:0 5px'>%impact</span> (%aqiv on %date)
    Beijing Air Quality is Good (
    29
    on Wednesday 1:00)
    %cityname Air Quality is provided by %attribution
    Beijing Air Quality is provided by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心)
    <div style='%style;max-width:180px;text-align:center;'><small>%cityname AQI:</small> <div style='font-size:88px;height:60px;padding-top:30px;'>%aqiv</div> %impact</div>
    Beijing AQI:
    29
    Good
    %details
    Beijing Air Quality.
    29
    Good
    Updated on Wed. 1:00
    PM2.5 AQI
    Beijing PM25 (fine particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    21
    PM10 AQI
    Beijing PM10 (respirable particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    11
    O3 AQI
    Beijing O3 (ozone)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    29

    D. Richiamata programmatica

    Se preferisci l'integrazione fai-da-te, puoi anche specificare una richiamata della funzione JavaScript da eseguire quando i dati vengono caricati. Devi solo aggiungere l'opzione callback nel blocco parametri, come ad esempio:

      
    _aqiFeed({  city:"beijing",  callback:function(aqi){  
    	/*  Do  whatever  you  want  with  the  AQI  object  */  
    	console.log(aqi);    
    }  });

    Ad esempio, supponendo che tu stia utilizzando anche jquery, il seguente codice:

      
    <div  id='my-container'></div>  
    <script  type="text/javascript"  charset="utf-8">  
    	_aqiFeed({  
    		city:  "beijing",  lang:  "pl",  callback:  function  (aqi)  {  
    			$("#my-container").html(aqi.details);  
    		}  
    	});  
    </script>

    produrrà il seguente contenuto:

    Pekin Jakość powietrza.
    29
    Good
    Poprawiony: Środa 1:00
    PM2.5 AQI
    Pekin PM25 (fine particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    21
    PM10 AQI
    Pekin PM10 (respirable particulate matter)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    11
    O3 AQI
    Pekin O3 (ozone)  measured by Beijing Environmental Protection Monitoring Center (北京市环境保护监测中心).
Values are converted to the US EPA AQI standard.
    29

    Gli oggetti aqi contengono tutte le parole chiave menzionate nella sezione C (formato di visualizzazione).

    E. Includere più widget

    È possibile includere più widget in una singola pagina. Tutto ciò che serve è passare alla funzione `_aqiFeed` un array con tutti i widget che devi includere. Ad esempio, per inserire Londra, Parigi e New York, potete utilizzare questo codice:

      
    var  cities  =  ["london",  "newyork",  "seoul",  "guangzhou",  "tokyo",  "shanghai",  "paris","hongkong"];  
      
    var  aqiWidgetConfig  =  [];    
    cities.forEach(function(city)  {  aqiWidgetConfig.push({city:city,  callback:  displayCity});  });  
    _aqiFeed(aqiWidgetConfig);  
      
    function  displayCity(aqi)  {  
    	$("#mutiple-city-aqi").append(aqi.text("<center>%cityname<br>%aqi<br><small>%date</small></center>"));  
    }  
    
    The result is:
    London
    76
    Tuesday 16:00
    New-york
    -
    Thursday 9:00
    Seoul
    38
    Wednesday 2:00
    Guangzhou
    99
    Wednesday 1:00
    Setagaya
    30
    Wednesday 1:00
    Shanghai
    74
    Wednesday 0:00
    Paris
    78
    Tuesday 15:00
    HongKong
    69
    Wednesday 0:00

    F. Utilizzo del mangime

    Questo feed widget è fornito gratuitamente e al solo scopo di integrare il feed in altri siti Web (ad esempio, le app sono escluse) e a condizione di un utilizzo ragionevole e accettabile. Ci riserviamo il diritto di modificare la struttura del feed (formato dei dati) in qualsiasi momento e senza preavviso, quindi è meglio contattarci se prevedi di effettuare un'integrazione personalizzata.

    Quando si esegue l'integrazione, ci sono alcune regole deontologiche che dovrebbero essere applicate quando si utilizza il feed di dati:

    • Innanzitutto, assicurati sempre che sia presente l'attribuzione all'APE di origine. Tutti i dati sulla qualità dell'aria che puoi trovare sul progetto World Air Quality Index sono frutto del duro lavoro di tutte le EPA di tutto il mondo, quindi assicurati di fornire anche l'attribuzione per il loro lavoro. Se utilizzi l'API programmatica, l'attribuzione è disponibile dal campo attribution .
    • Se appartieni a un'istituzione e utilizzi i dati, per favore, mostra rispetto e ripaga i crediti per il nostro lavoro. Se stai cercando di recuperare il feed di dati, tieni presente che questo progetto si basa su progetti di sponsorizzazione e cooperazione, quindi considera di supportarci piuttosto che eliminarci, soprattutto se sei un'istituzione o un'università su larga scala.
    • In realtà, non comportatevi come il WRI ( World Resource Institute ): eliminando il feed di dati complessivo del progetto World Air Quality Index e comportandosi così a buon mercato da non dare nemmeno alcuna attribuzione per il nostro lavoro, e questo nonostante i loro 80 anni. milioni di finanziamenti annuali in USD. Non ci credi? Controlla questa istantanea .

    G. Miglioramenti futuri

    Questa è la prima versione di questa nuova API del feed widget. Ci sono già alcuni miglioramenti in cantiere, come larghezza e altezza grafica regolabili, scala AQI selezionabile, ecc. Se desideri suggerire altri miglioramenti specifici, sentiti libero di inviarci un messaggio.

    Conosci stazioni di controllo della qualità dell'aria nella tua zona? perché non partecipi alla mappa con la tua stazione di misurazione della qualità dell'aria?
    Scopri di più su
    > aqicn.org/gaia/ <
    Iscriviti alla nostra mailing list mensile gratuita e ricevi una notifica quando sono disponibili nuovi articoli.

    Clicca qui per vedere tutte le voci delle FAQ

    Informazioni sulla misurazione della qualità dell'aria e dell'inquinamento:

    Informazioni sui livelli di qualità dell'aria

    -Valori dell'indice di qualità dell'aria (AQI).Livelli di preoccupazione per la salute
    0 - 50BuonaLa qualità dell'aria è considerata soddisfacente e l'inquinamento atmosferico presenta rischi minimi o nulli
    51 -100ModeratoLa qualità dell'aria è accettabile; tuttavia, per alcuni inquinanti può esserci un problema di salute moderato per un numero molto limitato di persone che sono insolitamente sensibili all'inquinamento atmosferico.
    101-150Malsano per gruppi sensibiliI residenti appartenenti a gruppi sensibili (per patologie) possono avere effetti sulla salute. È improbabile che gli effetti siano seri per tutta la popolazione.
    151-200malsanoOgnuno può iniziare a sperimentare effetti sulla salute; i membri di gruppi sensibili possono avere effetti sulla salute più gravi
    201-300Molto malsanoAvvisi sulla salute delle condizioni di emergenza. È più probabile che l'intera popolazione sia colpita.
    300+PericolosoAllerta salute: chiunque può essere soggetto a effetti piu gravi sulla propria salute

    Per saperne di più sulla qualità dell'aria e sull'inquinamento, consulta l' argomento Qualità dell'aria di Wikipedia o la guida Airnow sulla qualità dell'aria e la tua salute .

    Per consigli sanitari molto utili del dottor Richard Saint Cyr MD di Pechino, controlla il blog www.myhealthbeijing.com .


    Avviso di utilizzo: Tutti i dati relativi alla qualità dell'aria non sono validati al momento della pubblicazione e, a causa dell'assicurazione della qualità, questi dati possono essere modificati, senza preavviso, in qualsiasi momento. Il World Air Quality Index progetto ha esercitato tutte le ragionevoli capacità e attenzione nella compilazione del contenuto di queste informazioni e in nessun caso il World Air Quality Index team di progetto o i suoi agenti sono responsabili in contratto, illecito o altro per qualsiasi perdita, danno o danno derivante direttamente o indirettamente dalla fornitura di questi dati.



    Settings


    Language Settings:


    Temperature unit:
    Celcius