diff options
| author |   Matt Ranostay <matt.ranostay@konsulko.com> | 2018-01-09 14:07:31 -0800 |
|---|---|---|
| committer |   Jan-Simon Moeller <jsmoeller@linuxfoundation.org> | 2018-01-11 14:30:36 +0000 |
| commit | 6463db0f9646e97e697f16e9efb52c4c3948b72d (patch) | |
| tree | 2148bce9d70fa7ac438c10d57110d76408ded1b6 | |
| parent | fdd5e976b2bec66e49884acbca2f034a8198dd52 (diff) | |
binding: geofence: add binding documentationeel_5.1.0eel_5.0.3eel_5.0.2eel_5.0.1eel/5.1.0eel/5.0.3eel/5.0.2eel/5.0.15.1.05.0.35.0.25.0.1eel
Add initial documentation for agl-service-geofence service
Bug-AGL: SPEC-1245
Change-Id: If9630c2cbeec440033b01df84d39bd94246c4ffd
Signed-off-by: Matt Ranostay <matt.ranostay@konsulko.com>
| -rw-r--r-- | README.md | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..4b3fb23 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +# GeoFence Service + +## Overview + +GeoFence service allows events to be triggered when vehicle enters, leaves, or dwells within +a defined bounding box + +## Verbs + +| Name | Description | JSON Parameters | +| ------------------ |:----------------------------------------|:-------------------------------------------------------------------------------------------| +| subscribe | subscribe to geofence events | *Request:* {"value": "fence"} | +| unsubscribe | unsubscribe to geofence events | *Request:* {"value": "fence"} | +| add_fence | add geofence bounding box | *Request:* {"name": "fence_name", "bbox": [...]} | +| remove_fence | remove named geofence | *Request:* {"name": "fence_name" } | +| list_fences | list current bounding boxes and state | *Response:* array of {"name": "fence_name, "bbox": [...], "within": false, "dwell": false} | +| dwell_transition | get/set dwell transition time interval | *Request:* {"value": 10} *Response:* {"seconds": 10} | + +## Bounding Box + +Fence boundaries are defined with a bounding box parameter (i.e. bbox) in the following format + +<pre> + ... + "bbox": { + "min_latitude": 45.600136, + "max_latitude": 45.600384, + "min_longitude": -122.499217, + "max_longitude": -122.498732, + } + ... +</pre> + +## Events + +| Name | Description | JSON Response | +| ------------------ |:-------------------------------------|:-------------------------------------------| +| fence | event that reports geofence status | {"name": "fence_name", "state": "entered"} | + +### fence Event Notes + +*state* parameter in event response can have one of the following values *entered*, *exited*, or *dwell* |