{"_id":"5b427c65cc1a9a000323c650","project":"568bdc1483d2061900d86cdc","version":{"_id":"59a72290d61777001b6c42c3","project":"568bdc1483d2061900d86cdc","__v":31,"createdAt":"2017-08-30T20:39:44.453Z","releaseDate":"2017-08-30T20:39:44.453Z","categories":["59a7236e3fe4d90025117c10","59a72eb6cb0db3001b84cfe2","59a734eb757d030019b85af8","59c0243b1b2d07001a9d2b76","59c035e42126e10028effb12","59c06c40df5b3c0010584a13","59c1a5852cabe5002641a3e7","59c2fb00b2b45c0010b7a3d7","59c32ceb9aea850010ac4130","59c32e6e190c90003cb0d12f","59c33affb2b45c0010b7aa23","59c7dfa457bd8200105444dc","59c7e975c50cf30010d712a0","59cffdef0cd4dd0010294d54","59d0622ca91a810032c8f60c","59d06733c1aec60026253065","59d174d44ac471001a07b123","59d5a5e323e6e800103defb2","59ecf1d8ed507c001c52b255","59f76fef8581dc0010593e6f","5a0c003680a35b0012c35db0","5a8358722e78660075e45f42","5a846645b5ec3a001203517e","5b258091bc7a6700033b9cb5","5b26e48e024807000315a740","5b44edff3306680003663f5c","5b468abd3d4a9e0003789111","5b468d8f3dcb6a0003c6e374","5b47b0b93d4a9e000378a33a","5b538d114ea24f00033c726f","5b6a0efe402b32000336c33f"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"","version_clean":"0.0.0","version":"0"},"category":{"_id":"5b47b0b93d4a9e000378a33a","project":"568bdc1483d2061900d86cdc","version":"59a72290d61777001b6c42c3","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2018-07-12T19:49:13.569Z","from_sync":false,"order":12,"slug":"features","title":"Features"},"user":"5a6a26281895510045b2cd40","githubsync":"","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-07-08T21:04:37.331Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"The presence API grants zones the ability to report whether or not a human is present within their geographic boundaries.\n\n# Factors\n\nFactors are metrics by which presence can be determined. They are created at the ecosystem level and are available for use by the ecosystem's zones. The ability of an ecosystem's zones to detect presence may be enabled and disabled at will, and factors may be edited at any time.\n\n# Values\n\nEach factor has one value: whether it has detected presence (true) or not (false). It is these values with which zones interact, rather than the factors themselves. Although an ecosystem may have several different factor values available, zones may pick and choose which ones to incorporate into their detection.\n\n## Types of Detection\n\nZones have three modes of presence detection:\n\n* `local`: only the direct factors of the zone are considered\n* `descendants`: only the factors of the child zones are considered\n* `combined`: both the zone's own factors and the factors of its children are considered\n\nIf presence detection is not desired for a particular zone, it's mode may be set to `disabled`.","excerpt":"Determine human presence within zones.","slug":"presence","type":"basic","title":"Presence"}

Presence

Determine human presence within zones.

The presence API grants zones the ability to report whether or not a human is present within their geographic boundaries. # Factors Factors are metrics by which presence can be determined. They are created at the ecosystem level and are available for use by the ecosystem's zones. The ability of an ecosystem's zones to detect presence may be enabled and disabled at will, and factors may be edited at any time. # Values Each factor has one value: whether it has detected presence (true) or not (false). It is these values with which zones interact, rather than the factors themselves. Although an ecosystem may have several different factor values available, zones may pick and choose which ones to incorporate into their detection. ## Types of Detection Zones have three modes of presence detection: * `local`: only the direct factors of the zone are considered * `descendants`: only the factors of the child zones are considered * `combined`: both the zone's own factors and the factors of its children are considered If presence detection is not desired for a particular zone, it's mode may be set to `disabled`.