summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..01e2373
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# GeoClue Service
+
+## Overview
+
+GeoClue service uses the respective package to determine the vehicles location based on geolocation services
+using WiFi SSIDs, and IP addresses.
+
+## Verbs
+
+| Name | Description | JSON Parameters |
+|--------------------|:----------------------------------------|:-------------------------------------------------------------------------------------------|
+| subscribe | subscribe to geofence events | *Request:* {"value": "location"} |
+| unsubscribe | unsubscribe to geofence events | *Request:* {"value": "location"} |
+| location | get current GeoClue coordinates | *Response:* {"latitude": 45.50, "longitude": -122.25, "accuracy": 20000, "altitude": 4000} |
+
+*accuracy* is the calculated radius in meters that the geolocation reading is likely within.
+
+## Events
+
+| Name | Description | JSON Response |
+|--------------------|:-------------------------------------|:--------------------------------------------------------------------------------------------|
+| location | event that reports GeoClue status | *Response:* {"latitude": 45.50, "longitude": -122.25, "accuracy": 20000, "altitude": 4000} |
+
+### location Event Notes
+
+Additonal fields that added to the JSON response when available are *speed* in meters per second, and *heading* in degrees.