Skip to content

Locations — MapBoot Documentation

Locations let you label real-world places (rooms, services, collections) and tie them into the routing network so users can find and highlight them in the Viewer/Navigator.

Concept

MapBoot location

A Location is made of two parts:

  1. Access Points — a list of entry nodes (shown with a key icon in the viewport). These are the points where a person can enter/exit the location (e.g., doors to a conference room).
  2. Surfaces — one or more polygons that visually highlight the area for that location (e.g., the footprint of a room or multiple shelf regions).

Routing uses access points. Highlighting uses surfaces.

Create a Location

A) Convert an orphan point (quick add)

  1. Choose the Point tool and place a single point on the map where you want the location marker to live.
  2. Press Esc to finish early. You’ll end with a “line” that has only one point.
  3. MapBoot treats that orphan point as a Location point and converts it automatically.
  4. You can move this point later; the location label/icon renders at this point.

Note

Location markers are movable: drag the point to adjust where the label/icon appears.

Access Points (required for routing)

Access points define how the router can reach a location from the walking network.

  • In the location properties, use Pick to select one or more access points directly from the viewport.
  • Typical access points are door center points or connectors that physically touch a corridor/path.
  • When multiple access points are defined, the router automatically chooses the closest one to the user’s start point.

Rules - An access point must be connected to the walking network (lines).
If there’s no literal line connection from the route network to the access point, no path can be returned. - You can remove an access point from the list at any time to stop routing through it.

Surfaces (visual highlight)

Surfaces are polygons that highlight the footprint of your location. Use them when: - The location spans multiple areas (e.g., “History aisle” scattered on a floor). - You want the Viewer to shade/outline the target area when the location is searched.

You can manage a list of polygons for a single location. All assigned surfaces will highlight when the location is queried.

Move or Delete a Location

  • Move: drag the location’s base point to a new place; the label/icon follows.
  • Delete: remove the location from the tree/properties. This also clears its access points list and surfaces list.

Routing Behavior

  • Routing uses access points only (not the polygon surfaces).
  • If multiple access points exist, the closest reachable one from the starting position is used.
  • If no access point connects to the walking network, the router cannot reach the location and returns no path.

Warning

If a location can’t be found by the router, verify that at least one access point is connected to the path network with actual lines. Visual proximity is not enough—there must be a node/segment intersection.

Best Practices

  • Place the location marker where the label should appear (near the center or the main entrance).
  • Define all valid access points (doors). More options give better routes.
  • Keep surfaces accurate but lightweight—avoid overly complex polygons.
  • Ensure network connectivity: access-point nodes must intersect the corridor layer.
  • For departmental/aisle-style locations, add multiple surfaces so all relevant areas highlight.

Troubleshooting

  • No route found
    Ensure at least one access point is connected to the walking network; add or fix the corridor line to that node.

  • Wrong door chosen
    Add all doors as access points—the router will pick the closest/most appropriate. Remove any you don’t want used.

  • Highlight missing
    Verify one or more surfaces are assigned to the location and they’re visible on the current floor/layer.

If you need help modeling locations or diagnosing routing gaps, email contact@mapboot.com.