میپ ویب سروس: ریئل ٹائم ایئر کوالٹی ٹائل API
Map Web Service: Real-time Air Quality Tile API

Posted on September 18th 2015
(re-edited on December 31st 2019)
بانٹیں: aqicn.org/faq/2015-09-18/map-web-service-real-time-air-quality-tile-api/ur/

Map Overlay Process
(Attribution: Essentials of
Geographic Information Systems
)

ہم حال ہی میں دنیا بھر میں کچھ اور EPAs (ماحولیاتی تحفظ ایجنسیوں) کے ساتھ تعاون کر رہے ہیں۔ ہمارے پاس موجود تمام درخواستوں میں سے، یہ دراصل ایک ویب میپ سروس فراہم کرنا ہے تاکہ EPA خود اپنی ویب سائٹ سے نقشے پر اصل وقت میں ہوا کے معیار کا ڈیٹا شامل کر سکے۔

ہماری طرف سے اس طرح کی میپ ویب سروس استعمال کرنے کا ایک واضح فائدہ یہ ہے کہ ہم اس پار باؤنڈری ڈیٹا سے استفادہ کر رہے ہیں جسے ہم کر رہے ہیں، یعنی دنیا بھر میں فضائی معیار کی معلومات ملک کی حدود کے بغیر فراہم کی جاتی ہیں۔

دوسرا فائدہ نہ صرف یہ ہے کہ یہ ایک مفت سروس ہے، بلکہ یہ گوگل، بنگ یا لیفلیٹ کی معیاری میپ ٹیکنالوجیز کے ساتھ بھی مکمل طور پر ہم آہنگ ہے، جو کسی بھی موجودہ ویب سائٹ کے ساتھ فوری اور آسان انضمام کی اجازت دیتی ہے۔


--

ٹائل میپ سروس اینڈ پوائنٹ

ٹائل میپ سرور url `https://tiles.aqicn.org/tiles/{aqi}/{z}/{x}/{y}.png` سے دستیاب ہے، جہاں aqi سے مراد مارکر کی قسم ہے پلاٹ بنایا جائے، جو ہو سکتا ہے:

  • usepa-aqi: Plots markers based on the composite AQI calculated with the US EPA standard.
  • usepa-pm25: PM2.5 based AQI - if a station does not have PM2.5 reading, then it is not plotted.
  • usepa-10: Same as above, but for PM10.
  • usepa-o3: Same as above, but for Ozone (based on the 1 hour breakpoints).
  • usepa-no2: Same as above, but for Nitrogen Dioxide.
  • usepa-so2: Same as above, but for Sulfur Dioxide.
  • usepa-co: Same as above, but for Carbon Monoxide.
  • asean-pm10: Asean PM10 raw PM10 concentration (explanations).

ذیل میں جنوبی چین کے لیے 6 انفرادی آلودگیوں کی مثال دی گئی ہے۔

ویب سروس کے استعمال کی شرائط

میپ ویب سروس مفت میں فراہم کی جاتی ہے، مناسب استعمال کی حدود اور قابل قبول استعمال کی پالیسی کی شرط کے تحت۔ ٹائلیں فی الحال ہر 15 منٹ میں تازہ کی جاتی ہیں (اور زیادہ ٹریفک کی صورت میں 1 گھنٹے تک)۔

نوٹ کریں کہ ہمارے سرور کی صلاحیت محدود ہے، اس لیے ہم کسی بھی وقت سروس کو روکنے کا حق محفوظ رکھتے ہیں، مثال کے طور پر کارکردگی سرور کی دیکھ بھال کے لیے۔ اگر آپ کو زیادہ مستحکم انضمام کی ضرورت ہے، تو مناسب حل تلاش کرنے کے لیے ہم سے رابطہ کریں، جیسے کہ ایک سرشار سرور ترتیب دینا۔

آخر میں آپ کو ٹائل سروس اینڈ پوائنٹ پر ایک اضافی دلیل کے طور پر اپنا ٹوکن ID بھی بتانا ہوگا، جیسے `token=_TOKEN_ID_` درج ذیل url میں: `https://tiles.aqicn.org/tiles/{aqi}/{z }/{x}/{y}.png؟ token=_TOKEN_ID_

آپ اس صفحہ سے اپنی ٹوکن ID کی درخواست کر سکتے ہیں۔ آپ کو صرف ایک درست ای میل فراہم کرنے کی ضرورت ہے، اور آپ ایک منٹ کے اندر اپنا ٹوکن حاصل کر سکتے ہیں۔

ویب سروس کے استعمال کی پابندیاں

سروس کا استعمال کرتے وقت، براہ کرم ورلڈ ایئر کوالٹی انڈیکس پروجیکٹ کے ساتھ ساتھ ڈیٹا فراہم کرنے والے EPA کو انتساب فراہم کرنا نہ بھولیں (اگر آپ کسی مخصوص مقام یا ذریعہ سے ڈیٹا دکھانے کے لیے میپ سروس استعمال کرتے ہیں)۔ آپ تمام EPA کی مکمل فہرست اس لنک سے حاصل کر سکتے ہیں۔

درحقیقت، ورلڈ ریسورس انسٹی ٹیوٹ (WRI) کی طرح کام نہ کریں: وہ ہمارے پورے ڈیٹا فیڈ کو ختم کر رہے تھے، اور ہمارے کام کے لیے کوئی ایک انتساب دیے بغیر ڈیٹا کو اپنی پراجیکٹ ویب سائٹ پر دوبارہ شائع کر رہے تھے... یہ بالکل ٹھیک نہیں ہے۔ جب آپ جانتے ہیں کہ انہیں ہر سال 80 ملین USD تک کی فنڈنگ ملتی ہے۔ ہم پر یقین نہیں ہے؟ اس سنیپ شاٹ کو چیک کریں۔

مستقبل کی توسیعات

مزید کنفیگریشن فراہم کرنے کے لیے ہم پہلے ہی اس ویب سروس کو بڑھانے پر کام کر رہے ہیں۔ مثال کے طور پر:

  • To support for more standards other than the US EPA, such as `eucaqi-xxx` for the European Common Air Quality Index, `innaqi-xxx` for the Indian National Air Quality Index , `raw-xxx` for the unconverted raw data, etc.
  • مزید اشارے جیسے wind (دونوں ہوا کی رفتار اور ہوا کی سمت کے لیے)، نیز پیشن گوئی شدہ ventilation انڈیکس [1] جو پیشین گوئی کے لیے انتہائی مفید ہو سکتا ہے۔
  • kriging اعدادوشمار کی سطح کے تخمینے کے لیے معاونت - یعنی ہیٹ میپ جیسے انٹرپولیشن (دائیں طرف کی تصویر) جو کم کثافت کی نگرانی کے نیٹ ورک کے لیے مفید ہو سکتی ہے۔
  • اوسطاً 24 hours اور 8 hours ڈیٹا کے لیے سپورٹ۔ ہمارا نقشہ فی الحال 1 گھنٹے کی اوسط پر مبنی ہے، لیکن طویل اوسط مدت وبائی امراض کے مطالعہ کے لیے مفید ہے۔
  • GeoJSON پر مبنی ٹائل رینڈرنگ کے لیے سپورٹ، مارکر اور کلر اسکیل کو حسب ضرورت بنانے کے ساتھ ساتھ tuftjs.org جیسے ٹولز کے ساتھ بہتر انضمام کی اجازت دیتا ہے۔


نوٹ کریں کہ مزید AQI معیارات اور ٹائل کنفیگریشنز کو سپورٹ کرنے کے لیے، ہمیں اپنے سرور کی صلاحیت (پروسیسنگ پاور اور اسٹوریج دونوں) کو بڑھانے کی ضرورت ہے، جس کے لیے ہمیں اسپانسرشپ کی ضرورت ہوگی۔ اگر آپ کسی بڑی کلاؤڈ کمپنی، یا مثال کے طور پر گوگل یا مائیکروسافٹ کے لیے کام کر رہے ہیں اور اس پیغام کو پڑھ رہے ہیں، تو پھر کیوں نہ اپنی کمپنی کو ماحول دوست بنانے پر غور کریں ( شہریوں کی آگاہی کو فروغ دے کر فضائی آلودگی سے لڑیں )، اور مطلوبہ سرور کا حصہ سپانسر کریں۔ اضافی صلاحیت؟ یہ نہ صرف ہماری مدد کرے گا بلکہ ماحولیاتی ڈیٹا اور سائنسز کے ساتھ کام کرنے والے محققین، سائنسدانوں، شماریات دانوں اور وبائی امراض کے ماہرین کی پوری کمیونٹی کی بھی مدد کرے گا۔


--


نمونہ کوڈ: لیفلیٹ کے ساتھ انضمام

لیفلیٹ موبائل فرینڈلی انٹرایکٹو نقشوں کے لیے ایک انتہائی ٹھنڈی ہلکے وزن کی اوپن سورس جاوا اسکرپٹ لائبریری ہے، جسے MapBox کے ولادیمیر اگافونکن نے تخلیق کیا ہے۔

Sample code:
  
<div  id='map'  style='height:380px;'  />  
<link  rel="stylesheet"  href="http://cdn.leafletjs.com/leaflet-0.7.5/leaflet.css"  />  
<script  src="http://cdn.leafletjs.com/leaflet-0.7.5/leaflet.js"></script>  
  
<script>  
      var  OSM_URL  =  'http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png';  
      var  OSM_ATTRIB  =  '&copy;  <a  href="http://openstreetmap.org/copyright">OpenStreetMap</a>  contributors';  
      var  osmLayer  =  L.tileLayer(OSM_URL,  {  attribution:  OSM_ATTRIB  });  
  
      var  WAQI_URL  =  "https://tiles.waqi.info/tiles/usepa-aqi/{z}/{x}/{y}.png?token=_TOKEN_ID_";  
      var  WAQI_ATTR  =  'Air  Quality  Tiles  &copy;  <a  href="http://waqi.info">waqi.info</a>';  
      var  waqiLayer  =  L.tileLayer(WAQI_URL,  {  attribution:  WAQI_ATTR  });  
  
      var  map  =  L.map('map').setView([51.505,  -0.09],  11);  
      map.addLayer(osmLayer).addLayer(waqiLayer);  
</script>

نمونہ کوڈ: گوگل کے ساتھ انضمام

گوگل میپس کافی آسان ہیں اور ایک دن میں 25,000 API کالز تک مفت ہیں۔ نوٹ کریں کہ گوگل میپس چین میں دستیاب ہے، لیکن نقشہ جات API اسکرپٹ کو باقاعدہ https://maps کے بجائے google.cn (`http://maps.google.cn/maps/api/js`) سے لوڈ کرنے کی ضرورت ہے۔ .googleapis.com/maps/api/js url۔

  
  
<div  id='map'  style='height:380px;'  />  
<script  src="https://maps.googleapis.com/maps/api/js"></script>  
  
<script>  
      var  map  =  new  google.maps.Map(document.getElementById('map'),  {  
            center:  new  google.maps.LatLng(51.505,  -0.09),  
            mapTypeId:  google.maps.MapTypeId.ROADMAP,  
            zoom:  11  
      });  
  
      var  t  =  new  Date().getTime();  
      var  waqiMapOverlay  =  new  google.maps.ImageMapType({  
            getTileUrl:  function  (coord,  zoom)  {  
                  return  'https://tiles.aqicn.org/tiles/usepa-aqi/'  +  zoom  +  "/"  +  coord.x  +  "/"  +  coord.y  +  ".png?token=_TOKEN_ID_";  
            },  
            name:  "Air  Quality",  
      });  
  
      map.overlayMapTypes.insertAt(0,  waqiMapOverlay);  
</script>

نمونہ کوڈ: Microsoft Bing Maps کے ساتھ انضمام

بنگ کے نقشے درحقیقت کافی اچھے ہیں، اور کچھ ممالک کے لیے یہاں بیس میپ بھی استعمال کرتے ہیں۔ مائیکروسافٹ میپس (اور خاص طور پر ایئر کوالٹی اور موسم کے ڈومین میں) پر مبنی بہت ساری ویب سائٹیں اب بھی موجود ہیں۔

  
  
<div  id='map'  style='height:380px;'    style='position:relative;'/>  
<script  type='text/javascript'  src='https://www.bing.com/api/maps/mapcontrol?callback=initBingMap'  async  defer></script>  
  
<script>  
      function  initBingMap()  {  
  
            var  map  =  new  Microsoft.Maps.Map(document.getElementById('map'),  {  
                  center:  new  Microsoft.Maps.Location(51.505,  -0.09),  
                  zoom:  11,  
            });  
  
            var  options  =  {  
                  uriConstructor:  "https://tiles.aqicn.org/tiles/usepa-aqi//{zoom}/{x}/{y}.png?token=_TOKEN_ID_",  
                  minZoom:  1,  
                  maxZoom:  15  
            };  
            var  waqiTileSource  =  new  Microsoft.Maps.TileSource(options);  
            var  waqiTilelayer  =  new  Microsoft.Maps.TileLayer({  mercator:  waqiTileSource  });  
            map.layers.insert(waqiTilelayer);  
      }  
</script>


[1] Also refered as venting index or cumulated wind power
FAQ کے تمام اندراجات دیکھنے کے لیے یہاں کلک کریں۔
  • AQI Scale: What do the colors and numbers mean?
  • Using Statistical Distances for Real-time Sensor Networks Validation
  • Nitrogen Dioxyde (NO2) in our atmosphere
  • ہوا کے معیار اور آلودگی کی پیمائش کے بارے میں:

    ہوا کے معیار کی سطح کے بارے میں

    -ایئر کوالٹی انڈیکس (AQI) اقدارصحت کی تشویش کی سطح
    0 - 50اچھیہوا کے معیار کو تسلی بخش سمجھا جاتا ہے، اور ہوا آلودگی سے کم یا کوئی خطرہ ہوتا ہے
    51 -100معتدلفضائی معیار قابل قبول ہے؛ تاہم، بعض آلودگیوں کے لئے وہاں بہت کم تعداد میں لوگوں کے لئے اعتدال پسند صحت کی تشویش ہو سکتی ہے جو فضائی آلودگی سے غیر معمولی حساس ہیں.
    101-150حساس افراد کیلئے غیر صحتمندحساس گروپوں کے ارکان صحت کے اثرات کا تجربہ کرسکتے ہیں. عام عوام کو متاثر نہیں ہونے کا امکان ہے.
    151-200مضر صحتہر کوئی صحت کے اثرات کا سامنا کرنا شروع کر سکتا ہے؛ حساس گروہوں کے ارکان زیادہ سنجیدہ صحت کے اثرات کا تجربہ کرسکتے ہیں
    201-300انتہائی مضر صحتانتباہ صحت برائے ہنگامی حالات. پوری آبادی متاثر ہونے کا امکان ہے
    300+خطرناکصحت کی انتباہ: ہر ایک کی صحت کو زیادہ سنگین اثرات کا سامنا کر نا پڑ سکتا ہے

    ہوا کے معیار اور آلودگی کے بارے میں مزید جاننے کے لیے، ویکیپیڈیا ایئر کوالٹی کا موضوع یا ایئر کوالٹی اور آپ کی صحت کے لیے ایئرنو گائیڈ دیکھیں۔

    بیجنگ کے ڈاکٹر رچرڈ سینٹ سائر ایم ڈی کے صحت سے متعلق بہت مفید مشوروں کے لیے، www.myhealthbeijing.com بلاگ دیکھیں۔


    استعمال کی اطلاع: اشاعت کے وقت تمام ایئر کوالٹی کے اعداد وشمار غیرتصدیق شدہ ھیں ، اور معیار کی یقین دہانی کے باعث ان اعداد و شمار کو بغیراطلاع ترمیم کیا جا سکتا ہے، کسی نوٹس کے بغیر. ورلڈ ایئر کوالٹی انڈیکس نے اس معلومات کے مضامین کو مرتب کرنے میں تمام معقول مہارت اور دیکھ بھال کا استعمال کیا ہے اور کسی بھی حالت میں نہیں ورلڈ ایئر کوالٹی انڈیکس پروجیکٹ ٹیم یا اس کے ایجنٹوں کو اس ڈیٹا کی فراہمی سے براہ راست یا غیر مستقیم طور پر پیدا کسی بھی نقصان، چوٹ یا نقصان کے لئے معاہدے، تشدد یا دوسری صورت میں ذمہ دار ہوسکتا ہے.



    Settings


    Language Settings:


    Temperature unit:
    Celcius