getTravelTime (Beta)

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

URL

http://athena.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://athena.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://athena.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://athena.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://athena.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://athena.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://athena.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