- Introduction
- Instructions
- Example: 4 point geofence - Central Park, New York, NY
- Example: 21 point geofence - Coronado, San Diego, CA
- Geofence Generator: Draw Your Own Geofence
Geofencing will restrict PokeAlarm alerts to a defined geographical area. The area is defined by a list of at least 2 sets of latitude and longitude coordinates. You may provide as many coordinates as you'd like to define your area of interest, provided that these sets are in the order that defines your polygon.
Note: PokeAlarm will first check pokemon alert distance, then will check to see if the pokemon is located within your geofence. See Pokemon configuration on how to limit alerts based on distance.
Create a text file with with a series of at least 2 latitude,longitude sets and place this in the same folder as runwebhook.py.
To define a rectangular geofence: Use 2 lat/lon sets, with the first set defining the top left of the rectangle, and the second defining the bottom right of the rectangle.
To define a polygonal geofence: Provide as many lat/lon sets as it takes to define your polygon. Make sure that you provide the points in order to describe the polygon.
Execute runwebhook.py with the -gf or --geofencing flag, along with the path of your file, or add geofence:YOUR_GEOFENCE_FILE to config.ini.
This text file defines the northwest, southwest, southeast and northeast corners of central park.
file central-park-geofence.txt
40.801206,-73.958520
40.767827,-73.982835
40.763798,-73.972808
40.797343,-73.948385
In the image above, each numbered marker 1-4 represents the lat,lon coordinates found in central-park-geofence.txt, respectively.
To run PokeAlarm with geofencing enabled, execute:
python runwebhook -gf central-park-geofence.txt
or
python runwebhook --geofence central-park-geofence.txt
or you can include geofence:central-park-geofence.txt in your config.ini file.
If successful, you should receive a confirmation in your log:
2016-08-20 10:32:09,571 [ geofence] [ INFO] Creating geofence...
2016-08-20 10:32:09,710 [ geofence] [ INFO] Geofence established!
Once running, visually confirm your geofenced area by visiting http://<POKEALARM_HOST>:<POKEALARM_PORT>/geofence in your web browser. With the default settings, this would be http://127.0.0.1:4000/geofence.
For our Central Park example, all 4 points encompass the entire park. The visual of the geofenced area is below. The red marker in the image denotes a selected location, here, "The Pond, Central Park, NY".
PokeAlarm will then notify you of pokemon within the shaded area.
You may add as many lat,lon points to define you polygon, provided that the points in your geofence file are in order of defining said polygon. Below is an example of a 21 point polygon encompasing an area.
file: geofence_coronado.txt
32.7134997863394,-117.18893051147461
32.71508853568461,-117.19330787658691
32.715305181130056,-117.20541000366211
32.71046664083005,-117.2189712524414
32.69977759183938,-117.22764015197754
32.6864144801245,-117.22832679748535
32.679985027301136,-117.22412109375
32.6859810484179,-117.21107482910156
32.685619853722,-117.19390869140625
32.67239912263756,-117.1721076965332
32.675794797699766,-117.1677303314209
32.68020175796835,-117.17494010925293
32.68164661564297,-117.17279434204102
32.677600955252075,-117.16695785522461
32.68540313620318,-117.16155052185059
32.692626770053714,-117.16197967529297
32.698549713686894,-117.16541290283203
32.70346112493775,-117.17897415161133
32.704400040429604,-117.18008995056152
32.70700006253934,-117.18978881835938
32.711983226476136,-117.18704223632812
Below is the resulting geofence:
Our @brettgus has developed Geofence Generator, a handy web tool to easily create and visualize your desired geofence. To use it:
- Type your desired location.
- Click for each geofence point that you would like to add to the coordinate list.
- Complete your geofence area by clicking the original point.