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

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

9 thoughts on “getTravelTime (Beta)

  1. ผมขอสอบถามข้อมูลนิดนึงครับ ผมส่ง 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” ตลอดเลยครับ
    ไม่ทราบว่าผมทำอะไรผิดไปหรือเปล่าครับ ขอบคุณครับ

    1. ผมต้องขออภัยอย่างสูงที่ตอบช้าครับ ขอเรียนว่าเนื่องจากทางเจ้าของข้อมูล GPS กำลังปรับปรุง server และให้หยุดส่งข้อมูลมายัง Traffy ทำให้เราไม่มีข้อมูล travel time ในขณะนี้ครับ

      ขออภัยในความไม่สะดวกครับ

  2. ไม่ทราบว่าถ้าใช้ร่วมกับ google api ได้ไหมครับ โดยใช้ path จาก google api แล้วหาเวลา จาก traffy api

    1. ไม่สามารถใช้ร่วมกันได้ครับ เพราะทีมงานใช้ Path ของกระทรวงคมนาคม ซึ่งทีมงานไม่ได้รับอนุญาติให้เผยแพร่ Path ของกระทรวงคมนาคมตรงๆ
      จึงไม่สามารถทำ Path Mapping ระหว่าง Path ของ Google กับ Paht ของกระทรวงคมนาคมได้ครับ

      1. เเล้วจะ implement ร่วมกับ map อะไรได้ครับผม คืออยากได้ map เเสดงเส้นทางเเล้วก็ระยะทาง จากจุดหนึงไปอีกจุดหนึงหนะครับ

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s