Description
ให้ข้อมูลเกี่ยวกับสภาพจราจรในแต่ละส่วนของถนน (เรียกแต่ละส่วนของถนนว่า Link) เช่น เวลาที่ใช้ในการเดินทาง (Travel Time), ความเร็วเฉลี่ย (Average Travel Speed) เป็นต้น
หมายเหตุ:
- ข้อมูล Travel Time นี้ คำนวณโดยใช้พิกัด GPS จากรถขนส่งสินค้าประมาณ 1000 คันที่วิ่งในเขตกรุงเทพมหานคร
- API นี้ใช้ร่วมกับ getLinkInfo API สำหรับการเรียกดูข้อมูลของ Link
- 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=tableResponse
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
ผมขอสอบถามข้อมูลนิดนึงครับ ผมส่ง parameters ดังนี้
send: ‘GET /apis/apitraffy.php?api=getTravelTime&time=2011-03-22%7C22%3A50%2C201-03-22%7C21%3A10&key={KEY}&format=xml&linkid=834&appid={APPID} HTTP/1.1\r\nAccept-Encoding: identiy\r\nHost: athena.traffy.in.th\r\nConnection: close\r\nUser-Agent: Python-urllib/2.6\r\n\r\n’
reply: ‘HTTP/1.1 200 OK\r\n’
header: Date: Tue, 22 Mar 2011 14:17:00 GMT
header: Server: Apache/2.2.12 (Ubuntu)
header: X-Powered-By: PHP/5.2.10-2ubuntu6.5
header: Vary: Accept-Encoding
header: Content-Length: 25
header: Connection: close
header: Content-Type: text/xml
แล้วก็ได้ข้อความตอบกลับเป็น “Information Not Available” ตลอดเลยครับ
ไม่ทราบว่าผมทำอะไรผิดไปหรือเปล่าครับ ขอบคุณครับ
ผมต้องขออภัยอย่างสูงที่ตอบช้าครับ ขอเรียนว่าเนื่องจากทางเจ้าของข้อมูล GPS กำลังปรับปรุง server และให้หยุดส่งข้อมูลมายัง Traffy ทำให้เราไม่มีข้อมูล travel time ในขณะนี้ครับ
ขออภัยในความไม่สะดวกครับ
ไม่ทราบว่า apiนี้สามารถใช้งานได้หรือยังค่ะ
ตอนนี้มี Version ใหม่อยู่ที่นี่ครับ http://info.traffy.in.th/2012/09/29/gettraveltime-beta2/
ไม่ทราบว่าถ้าใช้ร่วมกับ google api ได้ไหมครับ โดยใช้ path จาก google api แล้วหาเวลา จาก traffy api
ไม่สามารถใช้ร่วมกันได้ครับ เพราะทีมงานใช้ Path ของกระทรวงคมนาคม ซึ่งทีมงานไม่ได้รับอนุญาติให้เผยแพร่ Path ของกระทรวงคมนาคมตรงๆ
จึงไม่สามารถทำ Path Mapping ระหว่าง Path ของ Google กับ Paht ของกระทรวงคมนาคมได้ครับ
เเล้วจะ implement ร่วมกับ map อะไรได้ครับผม คืออยากได้ map เเสดงเส้นทางเเล้วก็ระยะทาง จากจุดหนึงไปอีกจุดหนึงหนะครับ
ตอนนี้ API นี้ใช้งานไม่ได้เหรอครับ