Routing & Directions

Mapiry supports two routing experiences:

• Get Directions for a single location
• Layer routes for an ordered set of locations inside one layer

This page covers what is currently available in the product.

Single-Location Directions

Any viewer can open directions for a single pin.

Where it appears:

• Public map pages
• Embedded maps

How it works:

1. Open a location popup
2. Click Get Directions
3. Mapiry opens Google Maps with that location as the destination

This is a handoff to Google Maps, not turn-by-turn navigation inside Mapiry.

Layer Routes

Layer routes let you draw one route through all pins in a layer.

Mapiry uses the current pin order in that layer:

• First pin = first stop
• Second pin = second stop
• And so on

This is useful for:

• Day-by-day itineraries
• Food crawls
• Event schedules
• Delivery or field visit sequences

Turn On a Layer Route

Layer routes are configured per layer.

1. Open your map in the editor
2. Open the layer manager
3. Create a new layer or edit an existing one
4. Enable Layer route
5. Save

The editor label is:

• Layer route: Draw route through this layer using pin order.

Show Route by Default

There is also an optional setting:

• Show route by default

What it does:

• Automatically shows the route when visitors open that layer
• Uses the cached route that was previously generated

Important:

• This setting is Pro-gated in the editor
• Owners need to generate the route at least once before visitors can see it by default
• If no cached route exists yet, Mapiry will not auto-build one for visitors

Generate and View a Layer Route

On a map with an active layer route:

1. Switch to a layer that has routing enabled
2. Use Show route
3. Mapiry draws the route on the map
4. The sidebar shows:
   • stop count
   • total distance
   • total duration
   • per-leg breakdown between stops

If available, the panel also shows a Google Maps button to open that route externally.

Credits

Routing uses credits.

Current credit behavior:

• Point-to-point directions request: about 2 credits
• Layer route generation request: about 2 credits

Cached layer routes help avoid repeated re-generation when the stop list has not changed.

Limits and Rules

• A layer route needs at least 2 pins
• Layer routes support up to 25 stops
• Routes follow pin order, not automatic shortest-path optimization
• Routes are currently built with Mapbox driving directions
• If pins change order or membership, the route may need to be regenerated

Embedded Maps

Embedded maps support single-location Get Directions links in popups.

Embeds do not currently provide the full layer-route planning UI that the main map experience has.

Troubleshooting

I don't see "Show route"

Check:

• the current layer has Layer route enabled
• the layer has at least 2 pins

The route is wrong

Layer routes follow the order of pins in the layer. Reorder the locations if the stop sequence should change.

Visitors don't see the route by default

Check:

• Show route by default is enabled
• the owner generated the route at least once
• the map owner has access to that Pro-gated default behavior

Google Maps button is missing

The Google Maps handoff appears when there is an available route summary for the active layer route.

Related

• Layers - Organize pins into routeable groups
• Map Actions - Viewer and owner actions on maps
• Embedding Maps - What directions support looks like in embeds
• Limits & Quotas - Credit system and plan limits