Description

รูปแบบการให้ข้อมูลพิกัด (GPS) แก่ Traffy เพื่อใช้ในงานวิจัย

Field Required *

*source ชื่อของบริษัทที่ให้ข้อมูล
Example Values: NECTEC Taxi Company
*vehicleID ID ของรถที่รับข้อมูล GPS มา โดยในแต่ละบริษัท ต้องไม่ซ้ำกัน
Example Values: 100001
*GPStimestamp วันเวลาที่รับข้อมูล GPS มา ในลักษณะ YYYY-MM-DD HH:MM:SS
Example Values: 2014-05-06 10:52:00
*latitude ละติจูดของข้อมูล GPS ในลักษณะ Signed degrees format มีค่าตั้งแต่ -90.00 ถึง 90.00
Example Values: 14.0777859
*longitude ลองติจูดของข้อมูล GPS ในลักษณะ Signed degrees format มีค่าตั้งแต่ -180.00 ถึง 180.00
Example Values: 100.6013131
*speed ความเร็วที่ได้รับจากข้อมูล GPS มีหน่วยเป็นกิโลเมตรต่อชั่วโมง (km/hr)
Example Values: 35.76
*heading ทิศทางที่ได้รับจาก GPS โดยคำนวณเป็นมุมที่เทียบกับทิศเหนือ มีหน่วยเป็นองศา มีค่าตั้งแต่ 0.00 ถึง 360.00
Example Values: 90.50

HDOP Horizontal Dilution of Precision ค่าความแมนยําของตําแหนงทางราบที่ได้จาก GPS
-1 = ไม่ระบุ, ระบุไม่ได้, not available, na
Default: -1
Example Values: 2.1
accuracy ค่าความแม่นยำของ GPS (กรณี Smartphone)
-1 = ไม่ระบุ, ระบุไม่ได้, not available, na
Default: -1
Example Values: 2.1
vehicleType ประเภทของรถ
taxi = รถ Taxi
van = รถตู้โดยสาร
truck = รถบรรทุก
bus = รถโดยสาร
car = รถยนต์ส่วนบุคคล
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: van
route เส้นทางของรถ เช่น ต.85, ปอ.29
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: ต.85
vehicleOwner เจ้าของยานรถ เช่น
NECTEC = รถของสำนักงาน NECTEC
individual = รถยนต์ส่วนบุคคล
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: ขสมก.
engineStatus สถานะเครื่องยนต์ของรถ
on = ติดเครื่อง เปิดเครื่อง
off = ดับเครื่อง ปิดเครื่อง
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: on
fuelStatus ระดับของเชื้อเพลิง มีหน่วยเป็นเปอร์เซ็น
-1 = ไม่ระบุ ระบุไม่ได้, not available, na
Default: -1
Example Values: 56.73
altitude ระดับความสูง ที่ได้จากข้อมูล GPS ในลักษณะ มีค่าตั้งแต่ 0 มีหน่วยเป็นเมตร
-1 = ไม่ระบุ, ระบุไม่ได้, not available, na
Default: -1
Example Values: 10.35
gpsValidityFlag ตัวบ่งชี้ว่า GPS ถูกคำนวณมาจากข้อมูลดาวเทียม หรือเป็นค่าประมาณ
valid = ข้อมูลถูกคำนวณแม่นยำ (เทียบได้กับค่า A ใน มาตรฐาน GPRMC)
invalid = ข้อมูลเป็นค่าประมาณ (เทียบได้กับค่า V ใน มาตรฐาน GPRMC)
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: valid
numberOfSattleites จำนวนของดาวเทียมที่นำมาคำนวณ GPS
-1 = ไม่ระบุ, ระบุไม่ได้, not available, na
Default: -1
Example Values: 7
GPSerror ความคลาดเคลื่อนของข้อมูล GPS มีหน่วยเป็นเมตร
-1 = ไม่ระบุ, ระบุไม่ได้, not available, na
Default: -1
Example Values: 3
passenger ตัวบ่งชี้ว่ามีผู้โดยสารหรือไม่ (ในกรณีรถ Taxi)
vacant = ไม่มีผู้โดยสาร
occupied = มีผู้โดยสาร
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: occupied
event เหตุการณ์ที่ทำการวิเคราะห์ได้ ตัวอย่างเช่น
moving = รถกำลังเคลื่อนที่
stop = รถหยุดอยู่กับที่
parking = รถจอดอยู่
leftTurn = รถเลี้ยวซ้าย
rightTurn = รถเลี้ยวขวา
suddenBreak = รถเบรคกระทันหัน
accident = เกิดอุบัติเหตุ
overSpeed = ขับเกินความเร็วที่กำหนด
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na = ไม่ระบุ ระบุไม่ได้ not available
Example Values: moving
note ข้อมูลอื่นๆ ที่ต้องการให้ข้อมูลเพิ่มเติม เช่นอธิบาย event ที่ไม่อยู่ในตัวอย่าง
na = ไม่ระบุ, ระบุไม่ได้, not available
Default: na
Example Values: overheat คือเครื่องยนต์ร้อนเกินไป
Example Values: overspeed คือขับที่ความเร็วเกินกว่า 90 กิโลเมตรต่อชั่วโมง

ควรทดสอบ JSON Syntax ของ Data เช่น ใช้ Function json_decode ใน PHP หรือในเว็บ เช่น http://jsonlint.com/
Example Data

{
 "VehicleGPSData": [
 {
 "source" : "NECTEC Taxi Company",
 "vehicleID": 100001,
 "GPStimestamp": "2014-05-06 10:52:00",
 "latitude": 14.0777859,
 "longitude": 100.6013131,
 "speed": 35.76,
 "heading": 90.50,
 "accuracy": 2.1,
 "vehicleType": "taxi",
 "route": "na",
 "vehicleOwner": "NECTEC",
 "engineStatus": "on",
 "fuelStatus": 56.73,
 "altitude": -1,
 "gpsValidityFlag": "valid",
 "numberOfSattleites": 7,
 "GPSerror": 3,
 "passenger": "occupied",
 "event": "moving",
 "note": {"color":"red","fuelType":"petrol/NGV"}
 },
 {
 "source" : "NECTEC Taxi Company",
 "vehicleID": 100001,
 "GPStimestamp": "2014-05-06 10:52:30",
 "latitude": 14.0777869,
 "longitude": 100.6013141,
 "speed": 40.36,
 "heading": 91.37,
 "accuracy": 2.2,
 "vehicleType": "taxi",
 "route": "na",
 "vehicleOwner": "NECTEC",
 "engineStatus": "on",
 "fuelStatus": 56.73,
 "altitude": -1,
 "gpsValidityFlag": "valid",
 "numberOfSattleites": 7,
 "GPSerror": 3,
 "passenger": "occupied",
 "event": "moving",
 "note": {"color":"red","fuelType":"petrol/NGV"}
 },
 {
 "source" : "NECTEC Taxi Company",
 "vehicleID": 100001,
 "GPStimestamp": "2014-05-06 10:53:00",
 "latitude": 14.0777879,
 "longitude": 100.6013151,
 "speed": 0.00,
 "heading": 91.37,
 "accuracy": 2.0,
 "vehicleType": "taxi",
 "route": "na",
 "vehicleOwner": "NECTEC",
 "engineStatus": "on",
 "fuelStatus": 56.73,
 "altitude": -1,
 "gpsValidityFlag": "valid",
 "numberOfSattleites": 7,
 "GPSerror": 3,
 "passenger": "occupied",
 "event": "stop",
 "note": {"color":"red","fuelType":"petrol/NGV"}
 },
 {
 "source" : "NECTEC Taxi Company",
 "vehicleID": 100001,
 "GPStimestamp": "2014-05-06 10:53:30",
 "latitude": 14.0777879,
 "longitude": 100.6013151,
 "speed": 0.00,
 "heading": 91.37,
 "accuracy": 2.1,
 "vehicleType": "taxi",
 "route": "na",
 "vehicleOwner": "NECTEC",
 "engineStatus": "on",
 "fuelStatus": 56.73,
 "altitude": -1,
 "gpsValidityFlag": "valid",
 "numberOfSattleites": 7,
 "GPSerror": 3,
 "passenger": "vacant",
 "event": "stop",
 "note": {"color":"red","fuelType":"petrol/NGV"}
 },
 {
 "source" : "NECTEC Taxi Company",
 "vehicleID": 100001,
 "GPStimestamp": "2014-05-06 10:54:00",
 "latitude": 14.0777889,
 "longitude": 100.6013161,
 "speed": 12.35,
 "heading": 91.37,
 "accuracy": 1.9,
 "vehicleType": "taxi",
 "route": "na",
 "vehicleOwner": "NECTEC",
 "engineStatus": "on",
 "fuelStatus": 56.73,
 "altitude": -1,
 "gpsValidityFlag": "valid",
 "numberOfSattleites": 7,
 "GPSerror": 3,
 "passenger": "vacant",
 "event": "moving",
 "note": {"color":"red","fuelType":"petrol/NGV"}
 }
 ]
}