Description

ให้ข้อมูลเกี่ยวกับสภาพจราจรในแต่ละส่วนของถนน (เรียกแต่ละส่วนของถนนว่า Link) เช่น เวลาที่ใช้ในการเดินทาง (Travel Time), ความเร็วเฉลี่ย (Average Travel Speed) เป็นต้น

หมายเหตุ:

  1. ข้อมูล Travel Time นี้ คำนวณโดยใช้พิกัด GPS จากรถขนส่งสินค้าประมาณ 1000 คันที่วิ่งในเขตกรุงเทพมหานคร
  2. API นี้ใช้ร่วมกับ getLinkInfo API สำหรับการเรียกดูข้อมูลของ Link
  3. API นี้อยู่ในขั้น Beta ผู้พัฒนาขอสงวนสิทธิ์ในการเปลี่ยนแปลงรูปแบบการใช้งาน API รวมถึงวิธีการประมวลผลข้อมูลในทุกกรณี

Output Formats

XML, TABLE, PNG

HTTP Method

GET

API Status:

กำลังปรับปรุง

Source :

mastertech, onelink, oriscom

URL

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid&time=time
[&format=format&linkid=linkid[,linkid,…]&min_ss=mss&min_cov=mcov]

Parameters

key – รหัสที่ได้รับจากการลงทะเบียน (ลงทะเบียน)

appid – หมายเลข id ที่ได้รับจากการลงทะเบียน (ลงทะเบียน)

format (default: xml) – รูปแบบการแสดงผลของข้อมูลจราจร

  • xml
  • table
  • png – แสดงข้อมูลจราจรในรูปแบบกราฟ (Powered by Google Chart API)

linkid – หมายเลข id ของ Link ที่ต้องการเรียกดูข้อมูล

  • การเรียกดูข้อมูล 1 Link: linkid=834
  • การเรียกดูข้อมูลมากกว่า 1 Link: linkid=200,834,8973

time – ช่วงเวลาที่ต้องการเรียกดูข้อมูลสภาพจราจร มี 2 รูปแบบคือ

1. time=start_time, end_time

  • อยู่ในรูปแบบ yyy-mm-dd|hh:mm โดยใช้ปี ค.ศ. เช่น 2010-11-20|09:00, 2010-11-20|12:00

2. time=ref_time, offset

  • ref_time อยู่ในรูปแบบ yyyy-mm-dd|hh:mm
  • offset – เวลาในหน่วยนาที นับจาก ref_time เช่น offset=60 หมายความว่า ช่วงเวลาตั้งแต่ ref_time จนถึงref_time +60 นาที ในทำนองเดียวกัน offset=-60 หมายความว่า ช่วงเวลาตั้งแต่ ref_time -60 นาที จนถึง ref_time

หมายเหตุ: สามารถเรียกข้อมูลในช่วงเวลา 06.00 ถึง 21.00 น. โดยเรีกข้อมูลย้อนหลังได้ประมาณ 8 ชั่วโมงนับจากเวลาปัจจุบัน

mss (default: 1) – ระบุจำนวนรถที่น้อยที่สุด

  • เช่น mss=2 หมายความว่า แสดงผลข้อมูลสภาจราจรเฉพาะในช่วงเวลาที่มีข้อมูลมาจากรถไม่ต่ำกว่า 2 คัน

mcov (default: 0.05) – ระบุอัตราส่วนความครอบคลุมความยาวของ Link เฉลี่ยที่น้อยที่สุด

  • mcov=0.5 หมายความว่า แสดงผลข้อมูลสภาพจราจรเฉพาะในช่วงเวลาที่ค่าอัตราส่วนดังกล่าวมีค่ามากกว่า 0.5, mcov = [0,1]

format (default: xml) – รูปแบบการแสดงผลของข้อมูลจราจร

  • xml
  • table – แสดงผลในรูปแบบตาราง (html)
  • png – แสดงผลในรูปแบบกราฟ

XML Response Format

<info>
<traveltime link_id=”” ttime=”” speed=”” ssize=”” link_cov=”” time=””/>
<traveltime link_id=”” ttime=”” speed=”” ssize=”” link_cov=”” time=””/>
…
</info>

ความหมายของตัวแปร

  • ttime = เวลาที่ใช้ในการเดินทางเฉลี่ยในหน่วยวินาที
  • speed = ความเร็วเฉลี่ยในหน่วย km/h
  • link_cov = อัตราส่วนความครอบคลุมความยาวของ Link ของข้อมูล มีค่าตั้งแต่ 0 – 1

Examples

1. เรียกดูข้อมูลสภาพจราจรบน linkid=834 ในช่วงเวลา 10.00 น.  ถึง 10:30 ของวันที่ 20 พฤศจิกายน พ.ศ.2553 และแสดงผลในรูปแบบ xml สามารถทำได้โดยเรียก API ดังต่อไปนี้

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid&linkid=834&time=2010-11-20|10:00,2010-11-20|10:30&format=xml

หรือ

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid&linkid=834&time=2010-11-20|10:00,2010-11-20|10:30

  • note: หากไม่ระบุค่า format จะมีค่าเป็น xml โดย default

หรือ

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid&linkid=834&time=2010-11-20|10:00,30

  • note: ใช้การระบุเวลาแบบสัมพัทธ์ โดยใช้เวลาอ้างอิงคือ 10.00 น. และระบุช่วงเวลาต่อไปอีก 30 นาที

หรือ

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid&linkid=834&time=2010-11-20|10:30,-30

  • note: ใช้การระบุเวลาแบบสัมพัทธ์ โดยใช้เวลาอ้างอิงคือ 10.30 น. และระบุช่วงเวลา ย้อนหลัง กลับมา 30 นาที

Response

<info>
<traveltime link_id=”834″ ttime=”452.104″ speed=”100.519″ ssize=”1″ link_cov=”0.456281″ time=”2010-11-20 10:30:00″/>
<traveltime link_id=”834″ ttime=”470.775″ speed=”96.5328″ ssize=”2″ link_cov=”0.31402″ time=”2010-11-20 10:25:00″/>
<traveltime link_id=”834″ ttime=”501.618″ speed=”90.5972″ ssize=”2″ link_cov=”0.441078″ time=”2010-11-20 10:20:00″/>
<traveltime link_id=”834″ ttime=”527.143″ speed=”86.2105″ ssize=”1″ link_cov=”0.456004″ time=”2010-11-20 10:15:00″/>
<traveltime link_id=”834″ ttime=”527.143″ speed=”86.2105″ ssize=”1″ link_cov=”0.456004″ time=”2010-11-20 10:10:00″/>
<traveltime link_id=”834″ ttime=”531.232″ speed=”85.5469″ ssize=”1″ link_cov=”0.56849″ time=”2010-11-20 10:05:00″/>
</info>

2. เรียกดูข้อมูลสภาพจราจรบน linkid=834 และ 8973 ในช่วงเวลา 10.00 น. ถึง 10:30 ของวันที่ 20 พฤศจิกายน พ.ศ.2553 และแสดงผลในรูปแบบ table (html) สามารถทำได้โดยเรียก API ดังต่อไปนี้

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid
&linkid=834,8973&time=2010-11-20|10:00,30&format=table

Response

link_id name(en) time travel time(s) travel speed(km/h) link coverage sample(s)
834 SOUTHERN OUTER RING RD. 2010-11-20 10:30:00 452.104 100.519 0.456281 1
834 SOUTHERN OUTER RING RD. 2010-11-20 10:25:00 470.775 96.5328 0.31402 2
834 SOUTHERN OUTER RING RD. 2010-11-20 10:20:00 501.618 90.5972 0.441078 2
834 SOUTHERN OUTER RING RD. 2010-11-20 10:15:00 527.143 86.2105 0.456004 1
834 SOUTHERN OUTER RING RD. 2010-11-20 10:10:00 527.143 86.2105 0.456004 1
834 SOUTHERN OUTER RING RD. 2010-11-20 10:05:00 531.232 85.5469 0.56849 1
8973 SOUTHERN OUTER RING RD. 2010-11-20 10:30:00 617.461 72.3087 0.876168 1
8973 SOUTHERN OUTER RING RD. 2010-11-20 10:25:00 617.461 72.3087 0.876168 1
8973 SOUTHERN OUTER RING RD. 2010-11-20 10:20:00 620.397 71.9666 0.678598 1
8973 SOUTHERN OUTER RING RD. 2010-11-20 10:15:00 648.642 68.8328 0.185002 1

3. เรียกดูข้อมูลสภาพจราจรบน linkid=8973 ในช่วงเวลา 07.00 – 12.00 น. ของวันที่ 20 พฤศจิกายน พ.ศ.2553 แสดงผลในรูปแบบกราฟ (png)

http://api.traffy.in.th/apis/apitraffy.php?api=getTravelTime&key=key&appid=appid&format=png&linkid=8973&time=2010-11-20|07:00,2010-11-20|12:00