Traffy @ ITS Lab

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"}
 }
 ]
}