CMUCCDC Open API

ศูนย์ข้อมูลการเปลี่ยนแปลงสภาพภูมิอากาศ มหาวิทยาลัยเชียงใหม่

CMUCCDC Open API

ศูนย์รวม API ข้อมูลสิ่งแวดล้อมของศูนย์ CCDC สำหรับนักพัฒนา นักวิจัย หน่วยงาน และระบบภายนอกที่ต้องการนำข้อมูลไปใช้งานต่อ

  1. 1

    สมัครและยืนยันบัญชี

    ลงทะเบียนบัญชีผู้ใช้ รอการยืนยัน/อนุมัติตามประเภทผู้ใช้งาน จากนั้นระบบจะแสดง API key สำหรับเรียกใช้งาน

    บัญชีผู้ใช้
  2. 2

    ส่ง API key

    ทุก request ต้องส่ง key ผ่าน header Authorization: Bearer {your_api_key}

    ดูสิทธิ์การเข้าถึง
  3. 3

    ทดลองเรียก API

    ใช้ปุ่ม Try it ในเอกสาร หรือเข้า API Console หลัง login เพื่อทดลองเรียก endpoint และดู response จริง

    API Console
CMUCCDC environmental data flow DustBoy air quality sensors and FloodBoy water level sensors send readings to CCDC Cloud. The Open API then provides environmental data to developer applications. ENVIRONMENTAL DATA FLOW SENSORS · CLOUD · OPEN API · APPS AIR QUALITY SENSOR DustBoy PM2.5 WATER LEVEL SENSOR FloodBoy LEVEL DATA CCDC CLOUD DATA STORAGE { API } OPEN API DEVELOPER APPS

เงื่อนไขการใช้งาน API ของศูนย์ CCDC

  • ผู้ใช้ประชาชนทั่วไปสามารถเรียกใช้ API เพื่อดึงข้อมูลได้สูงสุด 10 จุดติดตั้งต่อบัญชี หากมีความจำเป็นต้องใช้ API เพิ่มเติมกรุณาติดต่อศูนย์ CCDC เพื่อขออนุญาตเป็นกรณีพิเศษ
  • API นี้ให้บริการข้อมูลจากจุดติดตั้งที่อยู่ภายนอกอาคาร (Outdoor) เท่านั้น หากผู้ใช้ต้องการเข้าถึงข้อมูลจากจุดติดตั้งในอาคาร/ห้อง (Indoor) หรือต้องการ API แบบรวมจุดติดตั้งทั้งสองประเภท จำเป็นต้องแจ้งความประสงค์ต่อศูนย์ CCDC เป็นรายกรณีเพื่อขออนุมัติ
  • ผู้ใช้ที่นำข้อมูลจาก API ไปแสดงบนแพลตฟอร์มอื่น ต้องระบุแหล่งที่มาของข้อมูล โดยใช้ข้อความ เช่น "ข้อมูลนี้ได้รับการสนับสนุนจากศูนย์ข้อมูลการเปลี่ยนแปลงสภาพภูมิอากาศ มหาวิทยาลัยเชียงใหม่ (CCDC CMU)” หรือ “ข้อมูลจากเครื่องตรวจวัดคุณภาพอากาศ DustBoy" หรือข้อความที่คล้ายกัน หรือแสดง โลโก้ DustBoy หรือ CCDC CMU บนแพลตฟอร์มเพื่อระบุที่มาของข้อมูล
  • หากศูนย์ CCDC ตรวจสอบพบว่าไม่มีการอ้างอิงถึงแหล่งที่มาของข้อมูลตามข้อกำหนด ศูนย์ขอสงวนสิทธิ์ในการ ระงับการเข้าถึง API โดยไม่ต้องแจ้งให้ทราบล่วงหน้า
  • ผู้ที่ยื่นขอ API ยินยอมให้ศูนย์ CCDC นำข้อมูลการลงทะเบียนไปใช้ในการพัฒนา/ปรับปรุง/ขยายผลโครงการ DustBoy โดยไม่มีการเผยแพร่ข้อมูลส่วนบุคคล และอนุญาตให้มีการบันทึกข้อมูลการจราจรทางคอมพิวเตอร์ตามพรบ.คอมพิวเตอร์
  • หากต้องการขออนุญาตเข้าถึงข้อมูลเพิ่มเติมนอกเหนือจากที่ระบุสิทธิ์ในระบบ กรุณาติดต่อสอบถามศูนย์ CCDC ผ่านช่องทางต่อไปนี้:

📧 Email: dustboy.3e@gmail.com

📞 โทรศัพท์: 064-069-1698

ดัชนีคุณภาพอากาศ

เป็นการรายงานข้อมูลคุณภาพอากาศในรูปแบบที่ง่ายต่อความเข้าใจของประชาชนทั่วไป เพื่อเผยแพร่ประชาสัมพันธ์ให้ประชาชนได้ทราบถึงสถานการณ์มลพิษทางอากาศในแต่ละพื้นที่ รวมถึงผลกระทบจากมลพิษทางอากาศต่อสุขภาพ ซึ่งดัชนีคุณภาพอากาศ 1 ค่า ใช้เป็นตัวแทนค่าความเข้มข้นของสารมลพิษทางอากาศ 6 ชนิด ได้แก่

  • ฝุ่นละอองขนาดไม่เกิน 2.5 ไมครอน (PM2.5) เป็นฝุ่นที่มีเส้นผ่านศูนย์กลางไม่เกิน 2.5 ไมครอน เกิดจากการเผาไหม้เชื้อเพลิงของยานพาหนะ การเผาวัสดุการเกษตร ไฟป่า และกระบวนการอุตสาหกรรม และเนื่องจากฝุ่นมีขนาดเล็กจึงง่ายต่อการแพร่กระจายสู่ถุงลมปอด ส่งผลให้เกิดโรคระบบทางเดินหายใจ และโรคปอดต่าง ๆ ซึ่งหากได้รับในปริมาณมากหรือเป็นระยะเวลานาน จะทำให้เกิดการสะสมในเนื้อเยื่อปอด ประสิทธิภาพการทำงานของปอดลดลง เกิดหลอดลมอักเสบและมีอาการหอบหืด
  • ฝุ่นละอองขนาดไม่เกิน 10 ไมครอน (PM10) เป็นฝุ่นที่มีขนาดเส้นผ่านศูนย์กลางไม่เกิน 10 ไมครอน เกิดจากการเผาไหม้เชื้อเพลิง การเผาในที่โล่ง กระบวนการอุตสาหกรรม การบด การโม่ หรือฝุ่นผงจากการก่อสร้าง หากหายใจนำฝุ่นเข้าสู่ร่างกายจะเกิดการสะสมในระบบทางเดินหายใจ ส่งผลเสียต่อสุขภาพ
  • ก๊าซโอโซน (O3) เป็นสารมลพิษทางอากาศในชั้นบรรยากาศผิวโลก เกิดจากปฏิกิริยาระหว่างก๊าซออกไซด์ของไนโตรเจน และสารประกอบอินทรีย์ระเหยง่าย โดยมีแสงแดดเป็นตัวเร่งปฏิกิริยา มีผลกระทบต่อสุขภาพ โดยก่อให้เกิดการระคายเคืองตาและระคายเคืองต่อระบบทางเดินหายใจและเยื่อบุต่างๆ ทำให้การทำงานของปอดลดลง เหนื่อยเร็ว โดยเฉพาะในเด็ก คนชรา และคนที่เป็นโรคปอดเรื้อรัง
  • ก๊าซคาร์บอนมอนอกไซด์ (CO) เป็นก๊าซที่เกิดจากการเผาไหม้ไม่สมบูรณ์ของเชื้อเพลิงที่มีคาร์บอนเป็นองค์ประกอบ สามารถสะสมอยู่ในร่างกายโดยการรวมตัวกับฮีโมโกลบินในเม็ดเลือดแดง ซึ่งหากหายใจนำก๊าซชนิดนี้ในร่างกาย ก๊าซคาร์บอนมอนอกไซด์จะทำปฏิกิริยากับฮีโมโกลบินในเลือด เกิดเป็นคาร์บอกซีฮีโมโกลบิน (CoHb) ทำให้การลำเลียงออกซิเจนไปสู่เซลล์ต่างๆ ของร่างกายลดน้อยลง ส่งผลให้ร่างกายเกิดอาการอ่อนเพลีย และหัวใจทำงานหนักขึ้น
  • ก๊าซไนโตรเจนไดออกไซด์ (NO2) เป็นก๊าซที่มีอยู่ทั่วไปในธรรมชาติ หรือเกิดจากการกระทำของมนุษย์ เช่น การเผาไหม้เชื้อเพลิงต่างๆ อุตสาหกรรมบางชนิด เป็นต้น ก๊าซนี้มีผลต่อระบบการมองเห็นและผู้ที่มีอาการหอบหืดหรือ โรคเกี่ยวกับทางเดินหายใจ
  • ก๊าซซัลเฟอร์ไดออกไซด์ (SO2) เป็นก๊าซที่เกิดจากธรรมชาติและการเผาไหม้เชื้อเพลิงที่มีกำมะถัน (ซัลเฟอร์) เป็นส่วนประกอบ สามารถรวมตัวกับสารมลพิษอื่นแล้วก่อตัวเป็นอนุภาคฝุ่นขนาดเล็ก ก๊าซนี้มีผลกระทบโดยตรงต่อสุขภาพ ทำให้เกิดการระคายเคืองต่อเยื่อบุตา ผิวหนัง และระบบทางเดินหายใจ หากได้รับเป็นเวลานาน ๆ จะทำให้เป็นโรคหลอดลมอักเสบเรื้อรังได้

ดัชนีคุณภาพอากาศของประเทศไทย

ดัชนีคุณภาพอากาศของประเทศไทยแบ่งเป็น 5 ระดับ คือ ตั้งแต่ 0 ถึง 201 ขึ้นไป ซึ่งแต่ละระดับจะใช้สีเป็นสัญลักษณ์เปรียบเทียบระดับของผลกระทบต่อสุขภาพอนามัย ดังแสดงในตารางที่ 1

ตารางที่ 1 เกณฑ์ของดัชนีคุณภาพอากาศตามมาตรฐานของประเทศไทย (TH AQI)

สัญลักษณ์ AQI PM2.5 เฉลี่ย
24 ชั่วโมงต่อเนื่อง
(μg/m3)		 PM10 เฉลี่ย
24 ชั่วโมงต่อเนื่อง
(μg/m3)		 ความหมาย แนวทางการป้องกัน
0-25 0-15.0 0-50 คุณภาพอากาศดีมาก คุณภาพอากาศดีมาก เหมาะสำหรับกิจกรรมกลางแจ้งและการท่องเที่ยว
26-50 15.1-25.0 51-80 คุณภาพอากาศดี คุณภาพอากาศดี สามารถทำกิจกรรมกลางแจ้งและท่องเที่ยวได้ตามปกติ
51-100 25.1-37.5 81-120 คุณภาพอากาศปานกลาง [ประชาชนทั่วไป] สามารถทำกิจกรรมกลางแจ้งได้ตามปกติ
[ประชาชนในกลุ่มเสี่ยง] หากมีอาการเบื้องต้น เช่น ไอ หายใจลำบาก ระคายเคือง ตา ควรลดระยะเวลาการทำกิจกรรมกลางแจ้ง
101-200 37.6-75.0 121-180 คุณภาพอากาศมีผลกระทบต่อสุขภาพ [ประชาชนทั่วไป] ควรเฝ้าระวังสุขภาพ ถ้ามีอาการเบื้องต้น เช่น ไอ หายใจลาบาก ระคาย เคืองตา ควรลดระยะเวลาการทำกิจกรรมกลางแจ้ง หรือใช้อุปกรณ์ป้องกันตนเองหากมีความจำเป็น
[ประชาชนในกลุ่มเสี่ยง] ควรลดระยะเวลาการทากิจกรรมกลางแจ้ง หรือใช้อุปกรณ์ ป้องกันตนเองหากมีความจำเป็น ถ้ามีอาการทางสุขภาพ เช่น ไอ หายใจลำบาก ตา อักเสบ แน่นหน้าอก ปวดศีรษะ หัวใจเต้นไม่เป็นปกติ คลื่นไส้ อ่อนเพลีย ควรพบแพทย์
>200 >75.1 >180 คุณภาพอากาศมีผลกระทบต่อสุขภาพมาก ประชาชนทุกคนควรหลีกเลี่ยงกิจกรรมกลางแจ้ง หลีกเลี่ยงพื้นที่ที่มีมลพิษทางอากาศสูง หรือใช้อุปกรณ์ป้องกันตนเองหากมีความจำเป็น หากมีอาการทางสุขภาพควรพบแพทย์

ตารางที่ 2 ค่าความเข้มข้นของสารมลพิษทางอากาศที่เทียบเท่ากับค่าดัชนีคุณภาพอากาศของไทย

ดัชนีคุณภาพอากาศ PM2.5
(μg/m3)		 PM10
(μg/m3)		 O3
(ppb)		 CO
(ppm)		 NO2
(ppb)		 SO2
(ppb)
เฉลี่ย 24 ชั่วโมงต่อเนื่อง เฉลี่ย 8 ชั่วโมงต่อเนื่อง เฉลี่ย 1 ชั่วโมง
0-25 0-15.0 0-50 0-35 0-4.4 0-60 0-100
26-50 15.1-25.0 51-80 36-50 4.5-6.4 61-106 101-200
51-100 25.1-37.5 81-120 51-70 6.5-9.0 107-170 201-300
101-200 37.6-75.0 121-180 71-120 9.1-30.0 171-340 301-400
200 ขึ้นไป 75.1 ขึ้นไป 181 ขึ้นไป 121 ขึ้นไป 30.1 ขึ้นไป 341 ขึ้นไป 401 ขึ้นไป

ช่วงเวลาเฉลี่ย และหน่วยสารมลพิษทางอากาศที่ใช้ในการคำนวน
PM2.5 เฉลี่ย 24 ชั่วโมงต่อเนื่อง: ไมโครกรัมต่อลูกบาศก์เมตร หรือ µg/m3
PM10 เฉลี่ย 24 ชั่วโมงต่อเนื่อง: ไมโครกรัมต่อลูกบาศก์เมตร หรือ µg/m3
O3 เฉลี่ย 8 ชั่วโมงต่อเนื่อง: ส่วนในพันล้านส่วน หรือ ppb หรือ 1/1,000,000,000
CO เฉลี่ย 8 ชั่วโมงต่อเนื่อง: ส่วนในล้านส่วน หรือ ppm หรือ 1/1,000,000
NO2 เฉลี่ย 1 ชั่วโมง: ส่วนในพันล้านส่วน หรือ ppb หรือ 1/1,000,000,000
SO2 เฉลี่ย 1 ชั่วโมง: ส่วนในพันล้านส่วน หรือ ppb หรือ 1/1,000,000,000

ดัชนีคุณภาพอากาศตามมาตรฐานของ US-EPA 2016 standard (US AQI)

ดัชนีคุณภาพอากาศตามมาตรฐานของ US-EPA 2016 แบ่งเป็น 6 ระดับ คือ ตั้งแต่ 0 ถึง 501 ขึ้นไป ซึ่งแต่ละระดับจะใช้สีเป็นสัญลักษณ์เปรียบเทียบระดับของผลกระทบต่อสุขภาพอนามัย ดังแสดงในตารางที่ 3

ตารางที่ 3 เกณฑ์ของดัชนีคุณภาพอากาศของ US-EPA 2016

สัญลักษณ์ AQI PM2.5 เฉลี่ย
24 ชั่วโมงต่อเนื่อง
(μg/m3)		 PM10 เฉลี่ย
24 ชั่วโมงต่อเนื่อง
(μg/m3)		 ความหมาย แนวทางการป้องกัน
0-50 0-12 0-54 คุณภาพอากาศดี ประชาชนสามารถดำเนินกิจกรรมต่างๆ ได้ตามปกติ
51-100 13-35 55-154 คุณภาพอากาศปานกลาง [ประชาชนทั่วไป] สามารถทำกิจกรรมกลางแจ้งได้ตามปกติ
[ประชาชนในกลุ่มเสี่ยง] ควรลดการออกแรงหนักหรือเป็นเวลานาน และสังเกตอาการไอและเหนื่อยของตัวเอง
101-150 36-55 155-254 คุณภาพอากาศไม่ดีต่อกลุ่มเสี่ยง [ประชาชนทั่วไป] สามารถทำกิจกรรมกลางแจ้งได้ตามปกติ
[ประชาชนในกลุ่มเสี่ยง] ควรลดกิจกรรมนอกอาคารที่ใช้แรงหนักหรือเป็นเวลานาน โดยอาจพักเป็นระยะๆ หมั่นสังเกตอาการไอ ล้า ใจสั่น และแน่นหน้าอกของตนเอง หากมีโรคประจำตัวให้ปฏิบัติตามที่แพทย์แนะนำ
151-200 56-150 255-354 คุณภาพอากาศไม่ดี [ประชาชนทั่วไป] ควรลดกิจกรรมนอกอาคารที่ใช้แรงงานหนักหรือเป็นเวลานาน อาจพักเป็นระยะๆ
[ประชาชนในกลุ่มเสี่ยง] ควรลดกิจกรรมนอกอาคารที่ใช้แรงงานหนักหรือเป็นเวลานาน ให้พักหรือทำงานในอาคาร
201-300 151-250 355-424 คุณภาพอากาศไม่ดีอย่างยิ่ง [ประชาชนทั่วไป] ควรหลีกเลี่ยงกิจกรรมนอกอาคารที่ใช้แรงหนักหรือเป็นเวลานาน หรือทำกิจกรรมในอาคารแทน
[ประชาชนในกลุ่มเสี่ยง] ควรงดกิจกรรมนอกอาคารทุกชนิด ทำกิจกรรมในอาคารแทน
301-500 254-500 425-604 คุณภาพอากาศอันตราย [ประชาชนทั่วไป] ควรงดกิจกรรมนอกอาคารทุกชนิด
[ประชาชนในกลุ่มเสี่ยง] ควรพักในอาคารเท่านั้น ทำกิจกรรมที่ไม่ออกแรงมาก

ตารางที่ 4 ค่าความเข้มข้นของสารมลพิษทางอากาศที่เทียบเท่ากับค่าดัชนีคุณภาพอากาศของ US-EPA 2016

AQI PM2.5
(μg/m3)		 PM10
(μg/m3)		 O3
(ppb)		 CO
(ppm)		 NO2
(ppb)		 SO2
(ppb)
เฉลี่ย 24 ชั่วโมงต่อเนื่อง เฉลี่ย 8 ชั่วโมงต่อเนื่อง เฉลี่ย 1 ชั่วโมง
0-50 0-12 0-54 0-34 0-4.4 0-53 0-35
51-100 13-35 55-154 55-70 4.5-9.4 54-100 36-75
101-150 36-55 155-254 71-85 9.5-12.4 101-360 76-185
151-200 56-150 255-354 86-105 12.5-15.4 364-649 186-304
201-300 151-250 355-424 106-200 15.5-30.4 650-1249 305-604
301-500 251-500 425-604 30.5-50.4 1250-2049 605-1004

การคำนวณดัชนีคุณภาพอากาศรายวันของสารมลพิษทางอากาศแต่ละประเภท

การคำนวณดัชนีคุณภาพอากาศรายวันของสารมลพิษทางอากาศแต่ละประเภท สามารถคำนวณได้จากความเข้มข้นของสารมลพิษทางอากาศจากข้อมูลผลการตรวจวัดคุณภาพอากาศ ซึ่งสามารถคำนวณดัชนีคุณภาพภายในช่วงระดับเป็นสมการเส้นตรง ดังนี้

โดยที่ I คือ ดัชนีย่อยคุณภาพอากาศ
X คือ ความเข้มข้นของสารมลพิษทางอากาศจากการตรวจวัด
Xi คือ ค่าต่ำสุดของช่วงความเข้มข้นสารมลพิษที่มีค่า X
Xj คือ ค่าสูงสุดของช่วงความเข้มข้นสารมลพิษที่มีค่า X
Ii คือ ค่าต่ำสุดของช่วงดัชนีคุณภาพอากาศที่ตรงกับช่วงความเข้มข้น X
Ij คือ ค่าสูงสุดของช่วงดัชนีคุณภาพอากาศที่ตรงกับช่วงความเข้มข้น X

แหล่งที่มาของข้อมูล

กองจัดการคุณภาพอากาศและเสียง กรมควบคุมมลพิษ. ข้อมูลดัชนีคุณภาพอากาศ [ออนไลน์]. เข้าถึงได้จาก: http://air4thai.pcd.go.th/webV2/aqi_info.php (วันที่สืบค้น 15 มิถุนายน 2564)

ศูนย์ข้อมูลการเปลี่ยนแปลงสภาพภูมิอากาศ มหาวิทยาลัยเชียงใหม่. คำนวณค่า AQI [ออนไลน์]. เข้าถึงได้จาก: https://www.cmuccdc.org/calculate#USAQI (วันที่สืบค้น 15 มิถุนายน 2564)

Wikipedia. Air quality index [Online]. Available from: https://en.m.wikipedia.org/wiki/Air_quality_index?fbclid=IwAR2LMteREhN8ZzfJRHigU4oGCEOcsZL_gCNiV9yzkgzz0ZjDahkXAcSquM4 (15 June 2021))

การใช้งาน APIs

หลังจากลงทะเบียน และยืนยันตัวตนเรียบร้อยแล้ว สามารถใช้ API key ผ่าน header Authorization: Bearer {your_api_key} ในการดึงข้อมูลจากระบบ CMUCCDC Open API

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/Docs

Response

การเข้าถึงข้อมูลของผู้ใช้งานแต่ละประเภท

อนุญาต ไม่อนุญาต

ฟังก์ชั่นสำหรับดึงข้อมูล หน่วยงานสังกัด
ประชาชนทั่วไป นักศึกษา นักวิจัย หน่วยงานภาคประชาสังคม หน่วยงานเอกชน หน่วยงานภาครัฐ หน่วยงาน เอ็มโอยู
DustBoy API
ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์แต่จุดตรวจวัด
ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์รายจังหวัด
ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์รายเขตสุขภาพ
ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์รายภาค
ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์ทั้งหมด
ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์โดยระบุตำแหน่ง
ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลัง 1 เดือน
ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลัง 1 ปี
ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลัง 5 ปี
ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลังทั้งหมด
FloodBoy API
FloodBoy รายชื่อสถานีและระดับน้ำล่าสุด
FloodBoy ข้อมูลระดับน้ำย้อนหลัง 24 ชั่วโมง

DustBoy

ข้อมูลจุดติดตั้งเครื่องวัดคุณภาพอากาศ DustBoy

ไอดี สถานจุดติดตั้ง ยูอาร์แอล โมเดล

ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์แต่จุดตรวจวัด

เลือกไอดีของจุดตรวจวัดแต่ละจุด จากนั้นสามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้งได้ที่ API นี้ โดยที่สามารถกำหนดจุดที่ต้องการดึงข้อมูลได้ ที่นี่
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ที่ออนไลน์

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/station

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์รายจังหวัด

เลือกจังหวัดที่ต้องการถึงข้อมูล จากนั้นสามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้งได้ที่ API นี้ โดยที่สามารถกำหนดจังหวัดที่ต้องการดึงข้อมูลได้ ที่นี่
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ที่ออนไลน์

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/province

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์รายเขตสุขภาพ

เลือกเขตสุขภาพที่ต้องการถึงข้อมูล จากนั้นสามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้งได้ที่ API นี้ โดยที่สามารถกำหนดเขตสุขภาพที่ต้องการดึงข้อมูลได้ ที่นี่
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ที่ออนไลน์

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/areahealth

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์รายภาค

เลือกเขตสุขภาพที่ต้องการถึงข้อมูล จากนั้นสามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้งได้ที่ API นี้ โดยที่สามารถกำหนดเขตสุขภาพที่ต้องการดึงข้อมูลได้ ที่นี่
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ที่ออนไลน์

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/geography

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์ทั้งหมด

สามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้งได้ที่ API นี้
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ที่ออนไลน์

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/stations

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงแบบเรียลไทม์โดยระบุตำแหน่ง

สามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้ง โดยระบุข้อมูลพารามิเตอร์เพิ่มเติมได้แก่ ละติจูด ลองจิจูด และ ระยะห่างจะพิกัดสูงสุด 20 กิโลเมตร
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ที่ออนไลน์

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/nearme/{latitude}/{longitude}/{distance}

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลัง 30 วัน

สามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้ง โดยระบุข้อมูลพารามิเตอร์เพิ่มเติมได้แก่ ไอดี จุดติดตั้ง
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ย้อนหลังทั้งหมด 30 วัน

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/data30day/{id}

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลัง 1 ปี

สามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้ง โดยระบุข้อมูลพารามิเตอร์เพิ่มเติมได้แก่ ไอดี จุดติดตั้ง
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ย้อนหลังทั้งหมด 1 ปี

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/data1year/{id}

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลัง 5 ปี

สามารถดึงค่าจากเซ็นเซอร์และรายละเอียดแต่ละจุดติดตั้ง โดยระบุข้อมูลพารามิเตอร์เพิ่มเติมได้แก่ ไอดี จุดติดตั้ง
จากนั้นข้อมูลจะแสดงค่าจากเซ็นเซอร์ย้อนหลังทั้งหมด 5 ปี

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/data5year/{id}

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าฝุ่นเฉลี่ยรายชั่วโมงย้อนหลังทั้งหมด

ท่านสามารถถึงค่าฝุ่นจากเซ็นเซอร์ทุกจุดติดตั้ง เฉลี่ยรายชั่วโมงย้อนหลังได้ที่นี่

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/dustboy/database/{yyyy}{mm}

ตัวอย่างข้อมูลย้อนหลังที่สามารถดาวน์โหลดได้

2023
09 / 2023
10 / 2023
11 / 2023
12 / 2023
2024
01 / 2024
02 / 2024
03 / 2024
04 / 2024
05 / 2024
06 / 2024
07 / 2024
08 / 2024
09 / 2024
10 / 2024
11 / 2024
12 / 2024
2025
01 / 2025
02 / 2025
03 / 2025
04 / 2025
05 / 2025
06 / 2025
07 / 2025
08 / 2025
09 / 2025
10 / 2025
11 / 2025
12 / 2025
2026
01 / 2026
02 / 2026
03 / 2026
04 / 2026
05 / 2026
06 / 2026

FloodBoy

ข้อมูลสถานีวัดระดับน้ำและสถานะความเสี่ยง

รายชื่อสถานีวัดระดับน้ำทั้งหมด

ใช้สำหรับดึง metadata ของสถานี FloodBoy เช่น ไอดีสถานี พิกัด ชื่อสถานี ประเภทจุดวัด และความสูงขอบตลิ่ง โดยยังไม่รวมค่าระดับน้ำล่าสุด

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/floodboy/stations

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าระดับน้ำล่าสุดทุกสถานี

ใช้สำหรับดึงค่าระดับน้ำล่าสุดของสถานี FloodBoy พร้อมสถานะที่คำนวณจาก risk_profile และ water_level โดย endpoint นี้มี cache 60 วินาที

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/floodboy/latest

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าระดับน้ำล่าสุดรายสถานี

ใช้สำหรับดึงข้อมูลสถานีเดียวพร้อมค่าระดับน้ำล่าสุด โดยเลือกสถานี FloodBoy จากรายการแล้วระบบจะนำ source_id ไปแทนใน endpoint ให้อัตโนมัติ

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/floodboy/station/{source_id}

เข้าสู่ระบบ เพื่อทดลองเรียก API

ค่าระดับน้ำย้อนหลัง 24 ชั่วโมงรายสถานี

ใช้สำหรับดึงข้อมูลย้อนหลังของสถานีเดียว โดยระบบเฉลี่ยค่าระดับน้ำทุก 10 นาทีและคืนข้อมูลใน readings ผู้ใช้ประเภทประชาชนทั่วไปไม่สามารถเรียก endpoint นี้ได้

ตัวอย่างการดึงข้อมูล

Authorization: Bearer {your_api_key}
GET /api/floodboy/log/{source_id}

เข้าสู่ระบบ เพื่อทดลองเรียก API

Field สำคัญและการคำนวณสถานะ

Field รายละเอียด
risk_profile.type ประเภทจุดวัด เช่น road หรือ waterway
risk_profile.bank_height ความสูงจากพื้นถึงขอบตลิ่ง ใช้คำนวณเปอร์เซ็นต์น้ำถึงขอบตลิ่งสำหรับประเภท waterway
water_level ค่าระดับน้ำ หน่วยเมตร
status.metric สำหรับ road ใช้ water_depth; สำหรับ waterway ใช้ bank_capacity_percent = ceil((water_level * 100) / bank_height)
status.label ข้อความสถานะที่คำนวณแล้ว เช่น น้ำปกติ, น้ำเฝ้าระวัง, น้ำอันตราย หรือ ไม่ทราบสถานะ
readings รายการข้อมูลย้อนหลังของ endpoint /log/{source_id} โดยเฉลี่ยค่าระดับน้ำทุก 10 นาที ภายใน 24 ชั่วโมงล่าสุด

ตัวอย่าง Response จริงแบบย่อ

ตัวอย่างด้านล่างใช้สถานี source_id=1008 จากการทดสอบ production ล่าสุด และตัดข้อมูลให้สั้นเพื่อให้อ่านง่าย

GET /api/floodboy/stations
{
  "status": true,
  "message": "Floodboy stations",
  "count": 17,
  "data": [
    {
      "id": "1008",
      "nickname": "Floodboy001",
      "name": "บ้านดอนจั่นพัฒนา ซ.เทพประทานพร1 ต.ท่าศาลา อ.เมือง จ.เชียงใหม่",
      "name_en": "Ban Don Chan Phatthana, Tha Sala Subdistrict, Mueang District, Chiang Mai Province",
      "latitude": "18.7622915",
      "longitude": "99.0331583",
      "uri": "fb001",
      "risk_profile": {
        "type": "waterway",
        "bank_height": 1.22
      }
    }
  ]
}
GET /api/floodboy/latest
{
  "status": true,
  "message": "Floodboy latest readings",
  "count": 17,
  "data": [
    {
      "id": 1008,
      "water_level": 0.6,
      "observed_at": "2026-05-28 11:50:03",
      "status": {
        "label": "น้ำปกติ",
        "metric": {
          "name": "bank_capacity_percent",
          "value": 50,
          "unit": "percent"
        }
      }
    }
  ]
}
GET /api/floodboy/station/1008
{
  "status": true,
  "message": "Floodboy station",
  "data": {
    "id": 1008,
    "water_level": 0.6,
    "observed_at": "2026-05-28 11:50:03",
    "status": {
      "label": "น้ำปกติ",
      "color": "#16B46D"
    }
  }
}
GET /api/floodboy/log/1008
{
  "status": true,
  "message": "Floodboy station log",
  "data": {
    "id": 1008,
    "readings": [
      {
        "observed_at": "2026-05-27 11:50:00",
        "water_level": 0.29,
        "status": {
          "label": "น้ำปกติ"
        }
      }
    ]
  }
}

Error Response

HTTP Status กรณี ตัวอย่าง Response
400 source_id ไม่ถูกต้อง {"status":false,"message":"Invalid station id"}
403 API key ไม่มีสิทธิ์ หรือผู้ใช้ทั่วไปเรียก /log {"status":false,"message":"Access denied"}
404 ไม่พบสถานี FloodBoy ที่ระบุ {"status":false,"message":"Floodboy station not found"}

คู่มือการใช้งาน

ขั้นตอนการลงทะเบียนดาวน์โหลดย้อนหลัง 30 วัน

คู่มือโหลดข้อมูลย้อนหลัง 1 ปี 5 ปี

ขั้นตอนการลงทะเบียนขอรับ API

บัญชีผู้ใช้

ขั้นตอนที่ 1 - ลงทะเบียน

กรอกข้อมูลตามแบบฟอร์ม โดยต้องระบุหน่วยงานหรือสังกัดให้ถูกต้อง

ขั้นตอนที่ 2 - ยืนยันตัวตน

ยืนยันตัวตนผ่านอีเมล์ที่ระบุอีกครั้ง

หน่วยงานต่อไปนี้ต้องรอแอดมินอนุมัติการใช้งาน ได้แก่
นักศึกษา นักวิจัย
หน่วยงานภาคประชาสังคม
หน่วยงานเอกชน
หน่วยงานภาครัฐ
หน่วยงานที่มีข้อตกลงร่วมมือกับดัสบอย

ขั้นตอนที่ 3 - ลุย!

เข้าสู่ระบบโดย อีเมล์ และ รหัสผ่าน ที่กำหนดตอนลงทะเบียน

ลงทะเบียน
ลืมรหัสผ่าน?