Skip to main content

​
Overview

Each zone can have a polygon boundary defined — a set of GPS coordinates that form a closed shape on the map. The score engine uses this boundary to determine whether a team is the right match for an event.

​
How it works

When an event occurs at a given GPS location, the score engine checks whether that location falls inside each team’s zone boundary using a point-in-polygon ray casting algorithm. This runs identically on the API (online) and on the SDK (offline) — the same result, no server required. Teams outside the event zone are ranked lower by the score engine, but not excluded — cross-zone escalation is always possible.

​
Defining a boundary

Zone boundaries are defined in the dashboard under Zones → Edit Zone. Click on the map to place polygon points. The boundary is saved as a JSONB array of { lat, lng } coordinates.
A valid polygon requires at least 3 points.

​
Offline compatibility

Zone boundaries are stored locally on the SDK. The point-in-polygon check runs without any network connection — the same algorithm, the same result as the API.

​
Teams without a boundary

If a zone has no boundary defined, the geofence check is skipped and no penalty is applied. All teams remain fully eligible.