Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/buckhx/gofence
Geofence written in go
https://github.com/buckhx/gofence
Last synced: 30 days ago
JSON representation
Geofence written in go
- Host: GitHub
- URL: https://github.com/buckhx/gofence
- Owner: buckhx
- License: mit
- Created: 2016-03-17T00:13:09.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-04-06T14:14:58.000Z (over 8 years ago)
- Last Synced: 2024-08-04T01:22:24.080Z (4 months ago)
- Language: Go
- Size: 276 KB
- Stars: 245
- Watchers: 7
- Forks: 26
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# gofence [](https://travis-ci.org/buckhx/gofence)
Code used from [Unwinding Uber's Most Efficient Service](https://medium.com/@buckhx/unwinding-uber-s-most-efficient-service-406413c5871d) to demonstrate the inefficiencies in Uber's "Highest Query Per Second Service" which uses the "City" fence in this demonstration.
## HTTP geofencing service
## Installation
```
// omitting the dot installs to /usr/local/bin
curl -sSL https://raw.githubusercontent.com/buckhx/gofence/master/scripts/install.py | python - .
```
## Usage
Invoking the fence cli will start an HTTP server and read geojson files from a directory into memory for searching.
The features in the geojson will be searchable at different endpoints for each file.
The endpoints will use a url-safe slug of the file name as their identifiers.
```
NAME:
fence - Fence geojson point features
USAGE:
cli [global options] command [command options] path/to/geojson/dir
VERSION:
0.0.0
COMMANDS:
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--fence "rtree" Type of fence to use rtree|brute|qtree|qrtree|city|city-bbox|bbox
--zoom, -z "18" Some fences require a zoom level
--port, -p "8080" Port to bind to
--profile Mounts profiling endpoints
--help, -h show help
--version, -v print the version
```
The city algorithms are special cases and both require NYC_BOROS_PATH envvar to be set to a geojson file.
Don't use either of them for anything besides benchmarking.
The boros and tracts data can be found on [NYC Open Data Maps](http://www1.nyc.gov/site/planning/data-maps/open-data/districts-download-metadata.page)
## HTTP Methods
GET /fence
A list of the available fence names
POST /fence/:name/add
Adds a geojon feature from the post body to the fence at.
This feature will not be saved to the server and will be gone if the server is restarted.
Features in a fence have no notion of uniqueness, so if you add the same feature twice, the searchs will return both.
POST /fence/:name/search
Search a fence for the query in the post body. This query must be a geojson feature with a point geometry. The properties of the matched features in the fence will be returned as a list.
GET /fence/:name/search?lat=&lon=
Convenience method for search with GET parameters. Both lat and lon and required and must be numbers. Any other parameters in the query string will be treated as properties of the query in the result. Will be more performant since json unmarshalling isn't necessary.
## Micro Benchmarks
| Benchmark | Operations | Time (ns/op) | Bytes (b/op) | Mallocs (allocs/op) |
|-------------|-----------:|-------------:|--------------:|-------------------:|
| Brute | 5000 | 389192 | 8 | 1 |
| City | 30000 | 58756 | 8 | 1 |
| Bbox | 30000 | 51795 | 8 | 1 |
| CityBbox | 100000 | 13747 | 8 | 1 |
| Qfence Z14 | 300000 | 6454 | 181 | 18 |
| Rfence | 300000 | 5145 | 280 | 10 |
| S2fence Z14 | 1000000 | 1403 | 8 | 1 |
| S2fence Z16 | 3000000 | 471 | 8 | 1 |
Benchmarking requires NYC_TRACTS_PATH envvar to be set. Benchmarks are ran by checking which census tract a point is in [code here](lib/fence_test.go)
HTTP profiling is done via https://golang.org/pkg/net/http/pprof/
See https://github.com/buckhx/gofence-profiling for more in depth benmarking.