FlySpark logo
FlySpark logoFlySparkINAV setup guidesUpdated

INAV geozones on the map

INAV geozones are areas the flight controller enforces in the air. An exclusive zone is a no-fly area. An inclusive zone is an allowed area, a fence the craft is meant to stay inside. FlySpark draws both on a map in the INAV configurator, as a circle or a polygon, with an altitude band and a choice of what happens at the border.

The board stores up to 63 zones and 126 vertices. A circle counts as two of those vertices. Geozones need INAV 8 or newer, and a firmware build that includes them. Boards with little flash are often built without the feature. You can still draw the zones in FlySpark and save them after you update the firmware.

Saving is not a quiet write. INAV applies geozones only at boot, so FlySpark asks you to save and reboot. Until that reboot, the zones on the map are the ones on this device, not yet the ones the craft will fly.

Free. Hardware connections need Chrome or Edge on a computer; phones use the FlySpark app.

  • Free
  • Nothing to install
  • Demo without hardware

In short

INAV geozones are no-fly areas and allowed areas the flight controller enforces. FlySpark draws them as circles or polygons and sets the altitude band and the border action. Saving stores the zones and reboots, because INAV applies them at boot.

Key facts

  • Geozones need INAV 8 or newer, and a build that includes them.
  • A board holds up to 63 zones and 126 vertices. A circle uses two vertex slots.
  • A new circle is an allowed area with a 200 m radius, from 0 to 100 m.
  • Radius is 1 to 1000000 m in steps of 10. Bottom is -1000 to 100000 m. Top of 0 means no limit.
  • At the border the craft can warn, avoid, hold position, or return home.
  • Return home here is INAV RTH. It is not Betaflight GPS Rescue.
  • Save stores the zones and reboots. INAV applies geozones at boot.
  • Chrome or Edge uses USB or Bluetooth. iPhone has no USB host.
  • Betaflight logoBetaflight
  • INAV logoINAV
  • ArduPilot logoArduPilot
  • PX4 logoPX4
  • BLHeli_S
  • Bluejay logoBluejay
  • AM32 logoAM32
  • ExpressLRS logoExpressLRS
  • EdgeTX logoEdgeTX
  • DroneCAN logoDroneCAN
  • MAVLink logoMAVLink

Try it

Cross the line

Tap the map. A no-fly circle pushes the craft out. An allowed circle keeps it in.

FlySpark

Features

  • 01

    No-fly or allowed

    Exclusive is a no-fly zone. Inclusive is an allowed area. A new circle starts as an allowed area.

  • 02

    Circle or polygon

    A circle has a centre and a radius. A polygon is a set of corners, at least three, drawn counter-clockwise.

  • 03

    Altitude band

    Bottom and top are in metres. A top of 0 means no upper limit. Altitudes can be above sea level or above the arming point.

  • 04

    Border action

    None only warns on the OSD. Avoid flies around or over the zone. Position hold stops at the border. RTH returns home.

  • 05

    63 zones, 126 vertices

    Those are the flight controller limits. A circle uses two vertex slots. The editor refuses an add that would pass either limit.

  • 06

    Save and reboot

    INAV applies geozones at boot. Save writes the zones and restarts the board. Load replaces the zones on this device with the ones stored on the board.

  • 07

    Enforce switch

    Enforce geozones is the Geozones feature. The switch is applied when you save, on a build that includes the feature.

No-fly zones and allowed areas

The type control has two names. No-fly zone is the exclusive type, INAV's own name for a volume the craft should not enter. Allowed area is the inclusive type, a volume the craft should stay inside. The map draws a no-fly zone in red and an allowed area in green, and each zone is numbered.

A new circle is an allowed area. That is the shape INAV creates: inclusive, a radius of 200 m, and an altitude band from 0 to 100 m. Change the type to no-fly if the circle is a place to stay out of, such as a field you do not want to cross. An allowed area with no border action still describes a fence. The action is what the craft does when it meets that fence.

You can mix the two types. A common plan is one large allowed area around the field and a smaller no-fly circle over a road or a building. Each zone has its own altitude band, so a no-fly circle can block only the low altitudes and leave a path over the top if the top is set and the action is allowed to climb.

Circles, polygons and the vertex limit

A circle stores its centre as the only point you edit, and it takes two of the flight controller's vertex slots. The radius is in metres, from 1 to 1000000, in steps of 10. The default is 200 m. Drag the centre on the map, or edit the radius in the zone card. A radius of zero is refused.

A polygon is a list of corners. INAV wants them counter-clockwise. FlySpark starts a new polygon as a square about 550 m across, already in that order. You need at least three corners. The remove button stays off while the polygon has only three. If you drag a corner and the order is no longer counter-clockwise, the card offers Fix corner order.

The flight controller holds 63 zones and 126 vertices in total. A plan of many circles runs out of vertices before it runs out of zone slots, because each circle costs two. If an add is refused, the snackbar names the problem. Delete a zone you do not need, or turn a circle into a tighter plan, before you add another.

Altitude band and sea level

Bottom and top are metres. Bottom runs from -1000 to 100000, in steps of 5. Top runs from 0 to 100000, in the same step. A top of 0 means there is no upper limit. The top must sit above the bottom. If it does not, the zone is marked invalid and the card says the top is not above the bottom.

Altitudes above sea level switches the band from the arming point to mean sea level. Off, the numbers are heights above the place you armed. On, they are AMSL, and the map label says so. A band that was right as height above the field becomes a different band when you flip the switch, because the field itself is already some height above the sea. Set the switch first, then the numbers.

The map label shows the band next to the zone, for example the bottom, the top or the words no limit, and AMSL when that reference is on. Use it to check that a no-fly zone actually covers the height you fly, not only the ground.

What happens at the border

At the border has four actions, and each one has a hint on the card. None only warns on the OSD. The craft can still fly through the zone. Avoid flies around the zone or over it. Position hold stops and holds position at the border. RTH means return home.

Return home on this card is INAV's return to home. It is not Betaflight GPS Rescue. The return altitudes and the climb live on the INAV navigation screens, not on the geozone card. Choosing RTH here only says that meeting the border starts that return. It does not set the return height.

Pick the action for the place, not from a habit. A no-fly zone over a road is a poor match for None, because a warning does not turn the craft. An allowed-area fence at a small field is a poor match for a hard position hold if you still need to land outside the line. Avoid is the action that tries to go around or over. It still needs a band that leaves a way out.

Load, save and the enforce switch

Load reads the zones stored on the flight controller and replaces the zones on this device. If you have unsaved edits, FlySpark asks before it replaces them. A board with nothing stored reports that no geozones are saved. Save writes the zones and reboots. The confirm text says the flight controller stores the zones and restarts, because INAV only applies geozones at boot.

Enforce geozones is the Geozones feature switch. It is applied when you save, and it appears when the connected build reports the feature. Turning the switch off and saving is how you keep the zones stored but stop the craft enforcing them. A build without the feature shows a notice instead of the switch. You can still plan.

Undo puts back the last edit on this device. It does not read the board again. After a save and reboot, load is the way to confirm the board has the plan you drew. The mission planner is a different map. A mission is a route. A geozone is a volume the craft must respect.

Firmware, connection and a bench check

Geozones need INAV 8 or newer. Older firmware gets a notice that you can plan now and save after you update. A build made without geozones, which is common on boards with little flash, gets a different notice. Planning still works. Saving to that board cannot turn the feature on.

Chrome or Edge on a computer connects over USB or Bluetooth. The Android app adds a Wi-Fi MSP bridge. iPhone uses Bluetooth or Wi-Fi and has no USB host, so it never sees the flight controller over a USB cable. A browser page cannot join the craft's own Wi-Fi.

Before you trust a fence, read it back. Draw the zone, set the type, the band and the action, save, let the board reboot, and load. The map should show the same circle or the same corners. Then fly a test where crossing the line is harmless. The servos page and the compass page are separate setup. A geozone does not replace either of them.

FlySpark

Draw an INAV geozone and save it

  1. Connect an INAV 8 board

    Open the Geozones tab. If the notice says the firmware is older than 8, or built without geozones, update before you expect the craft to enforce the plan.

  2. Add a circle or a polygon

    A new circle is an allowed area, 200 m radius, from 0 to 100 m. Switch it to a no-fly zone if that is what you need. A polygon starts as a counter-clockwise square.

  3. Set the band and the border

    Choose sea level or height above arming before you type the metres. Set the bottom and the top. Top 0 means no upper limit. Pick None, Avoid, position hold or return home.

  4. Save, reboot, and load

    Turn on Enforce geozones if the switch is there. Save and let the board reboot. Load and confirm the map matches what you drew.

Troubleshooting

Common problems and fixes

  • Problem

    The tab says geozones need INAV 8

    Fix

    The connected firmware is older than 8. You can draw zones and save them after you update. They are not enforced on the older firmware.

  • Problem

    The build has no geozones

    Fix

    The firmware was built without the feature, often to save flash. Planning still works. Enforcement needs a build that includes geozones.

  • Problem

    Add zone does nothing or shows an error

    Fix

    The map has no centre yet, or the add would pass 63 zones or 126 vertices. A circle costs two vertices. Pan the map or delete a zone, then add again.

  • Problem

    The zone is marked invalid

    Fix

    The top is not above the bottom, the radius is zero, or a polygon has fewer than three corners. Fix that field. A clockwise polygon can be repaired with Fix corner order.

FAQ

Frequently asked questions

What are INAV geozones?

Volumes the flight controller enforces. A no-fly zone is exclusive. An allowed area is inclusive. Each one is a circle or a polygon with an altitude band and a border action.

Which INAV version has geozones?

INAV 8 or newer, and a firmware build that includes the feature. Older firmware, and builds without the feature, can still be used to draw a plan.

How many geozones can INAV store?

Up to 63 zones and 126 vertices. A circle uses two vertex slots. A polygon uses one slot per corner, and it needs at least three corners.

What is the default circle?

An allowed area with a radius of 200 m and an altitude band from 0 to 100 m. Radius can then be set from 1 to 1000000 m in steps of 10.

What does INAV do at a geozone border?

None only warns on the OSD. Avoid flies around or over the zone. Position hold stops at the border. RTH starts INAV return to home.

Is INAV geozone RTH the same as GPS Rescue?

No. Return home here is INAV's return to home. GPS Rescue is a Betaflight failsafe. The return heights are on the INAV navigation screens.

Why does saving geozones reboot the board?

INAV applies geozones at boot. FlySpark writes the zones and restarts the flight controller so the saved plan is the one that will be enforced.

Are geozone altitudes above the field or the sea?

Either. Off, the band is height above the arming point. On, the band is above sea level and the label says AMSL. A top of 0 means no upper limit.

Can I draw geozones in Chrome?

Yes. Chrome or Edge connects over USB or Bluetooth. The Android app also uses Wi-Fi. iPhone uses Bluetooth or Wi-Fi and has no USB host.

Do geozones replace a mission?

No. A mission is a route of waypoints. A geozone is a volume. Both can be on the craft. The mission planner is the route tool.

References

Sources

The official documentation behind the background facts on this page.

  1. INAV GeozonesINAV on GitHub · github.com
  2. INAV NavigationINAV on GitHub · github.com
  3. INAV WikiINAV on GitHub · github.com

Tools

See every FlySpark tool

Ready to try it?

Free. Hardware connections need Chrome or Edge on a computer; phones use the FlySpark app.