Deep Linking
Mappedin Web offers a way to link directly to many pages. The following represents all of the deep linking routes that are possible, with a description of what it will do and any parameters you will need. These routes can be used to create URLs that can be used to open the map at a specific location, display a category page, search for a location, display directions, and more.
Mappedin Web deep linking URLs can be generated visually using the URL Configurator, by manually constructing the URL, or by copying the URL from the map while using the app.
Location Page
/profile?location=<locationId | locationName | externalId>&my-section=true
locationId: Mappedin ID of the location to displaylocationName: Name of the location to displayexternalId: External ID of the location to displaymy-section: Optional parameter that sets this location as the user's section. Only applicable to stadiums.
Using any of the above will deep link to a specific location.
Categories Page
/categories
List all available categories
Specific Category Page
/categories?category=<categoryName | categoryId | externalId>
categoryName: Name of the category to displaycategoryId: Mappedin internal id of the category to displayexternalId: External ID of the category
Display a category page using one of the above identifiers. Defaults to show the name of the category in the URL.
Search Page
/search
Display the search page
The search form can be populated with text by adding the query parameter to the URL.
/search?query=<search text>
query: Search query text to populate the search form with
Directions Page
/directions
Directions page
Directions - From Page
/directions?from=<fromId | fromName | fromExternalId | fromPolygonId | fromNodeId>
fromId,fromName,fromExternalId,fromPolygonId,fromNodeId: Preset departure point to display directions page with a preset from field
Directions - To Page
/directions?to=<toId | toName | toExternalId | toPolygonId | toNodeId>
toId,toName,toExternalId,toPolygonId,toNodeId: Preset arrival point to display directions page with a preset to field
Directions - From/To Page
/directions?to=<to>&from=<from>&accessible=true&textDirectionsVisible=true
from: (Location ID, Name, External ID Polygon ID or Node ID) Preset departure pointto: (Location ID, Name, External ID, Polygon ID or Node ID) Preset destination point
Optional:
accessible: Default:false, can set this param to true to enable directions that will prioritize elevators and rampstextDirectionsVisible: Default:false, can set this param to true to show text directions alongside the wayfinding path upon initial load
Directions - Multi Destination
/directions?from=<Location-A>&to=<Location-B>&to=<Location-C>
from: (Location ID, Name, External ID Polygon ID or Node ID) Preset departure pointto: (Location ID, Name, External ID, Polygon ID or Node ID) Preset destination points. Can be repeated to add multiple destination points.
Language
?lang=<languageCode>
languageCodeA language code of a supported language.
This can be used to change the language of the map before or after it has been displayed.
Start From Here
Mappedin Web provides a way to open the map with a "You Are Here" style experience. This is useful for cases where the map should start from a specific location and provide location and directional context, such as when scanning a QR code printed on a sign or displayed on a digital screen.
The Start From Here experience can be delivered in two ways: on a Display screen or via a QR Code that opens on a visitor's phone. Both can be created manually using the URL parameters documented below, or visually using the URL Configurator.
Start From Here URLs can be generated visually using the URL Configurator Display tab, which provides an interactive interface for configuring all display settings.
Display
/display?lat=<LATITUDE>&lon=<LONGITUDE>&floor=<FLOOR_ID>&zoom=<ZOOM>&heading=<HEADING>&tilt=<TILT>&showQR=<BOOLEAN>&showBlueDot=<BOOLEAN>&showFloorInfo=<BOOLEAN>&qrId=<UNIQUE_ID>
The Display route loads a fixed, non-interactive map view designed for passive viewing on a TV, kiosk, or digital signage display. The display can include a "You Are Here" Blue Dot and an optional QR code overlay that visitors can scan to open the map on their phone.
Display URLs can be generated visually using the URL Configurator Display tab, which provides an interactive interface for configuring all display settings.
Camera Parameters
These parameters control the map's viewport — what the viewer sees on screen.
| Parameter | Type | Required | Description | Format |
|---|---|---|---|---|
| lat | string | Yes | North-south position of the map center | Decimal degrees (-90 to 90) |
| lon | string | Yes | East-west position of the map center | Decimal degrees (-180 to 180) |
| floor | string | No | Floor/Map identifier | Alphanumeric string (map ID) |
| zoom | string | No | How close the map is zoomed in | 0 (world view) to 24 (extreme close-up) |
| tilt | string | No | The 3D tilt angle of the map | Degrees, 0 (top-down) to 90 (edge-on) |
| heading | string | No | Compass heading / rotation of the map | Degrees (0-360) |
Display Options
These parameters control the additional features shown on the display.
| Parameter | Type | Required | Description |
|---|---|---|---|
| showBlueDot | boolean | No | When true, a Blue Dot (simulated user position) appears in front of the screen facing toward it, giving viewers a "You Are Here" reference point. |
| showQR | boolean | No | When true, a QR code is overlaid on the display so passersby can scan it to open the map on their phone. If showBlueDot is false, the QR code opens the general map homepage without a Blue Dot. |
| showFloorInfo | boolean | No | When true, a banner at the top of the display shows the current floor name, subtitle, and building or map group name. |
| qrId | string | No | An optional tracking identifier for the QR code (e.g., lobby-tv-1). Used for analytics to track which QR codes are being scanned. |
| lang | string | No | Sets the language for the display. Use a supported language code. |
Example Display URL
https://<venue-domain>/#/display?lat=43.4567&lon=-80.5234&floor=abc123&zoom=19&heading=180&tilt=45&showQR=true&showBlueDot=true&showFloorInfo=true&qrId=main-lobby-tv
QR Code
/current-location?lat=<LATITUDE>&lon=<LONGITUDE>&floor=<FLOOR_ID>&qrId=<UNIQUE_ID>&origCtx=<CONTEXT>&zoom=<OPTIONAL_ZOOM>&heading=<OPTIONAL_HEADING>
The QR Code route opens the map on a visitor's phone at a specific location with a "You Are Here" Blue Dot. This is designed for printed signs, parking lot posts, wayfinding totems, or any physical sign where visitors can scan a QR code to get directions from their current location.
QR Code URLs and downloadable QR code images can be generated visually using the URL Configurator Print QR tab.
Location Parameters
/current-location?lat=33.94545&lon=-118.40413&floor=6475f7fea6e4f69c75e5b52d
These parameters are required to position the map showing a specific origin.
| Parameter | Type | Required | Description | Format |
|---|---|---|---|---|
| lat | string | Yes | Latitude coordinate | Decimal degrees (minimum 5 decimals) |
| lon | string | Yes | Longitude coordinate | Decimal degrees (minimum 5 decimals) |
| floor | string | No | Floor/Map identifier | Alphanumeric string (map ID) |
Camera Parameters
/current-location?lat=33.94545&lon=-118.40413&floor=6475f7fea6e4f69c75e5b52d&zoom=18&heading=90
These optional parameters control the initial view presentation:
| Parameter | Type | Required | Description | Format |
|---|---|---|---|---|
| zoom | string | No | Zoom level | Numeric value (1-24) |
| heading | string | No | Camera rotation | Degrees (0-360) |
Heading Reference Values:
- 0 = North
- 90 = East
- 180 = South
- 270 = West
Tracking Parameters
/current-location?lat=33.94545&lon=-118.40413&floor=6475f7fea6e4f69c75e5b52d&qrId=gate-a12&origCtx=physical
These parameters enable tracking and context identification and should be set when using the current-location route.
The qrId parameter can be used for any arbitrary tracking identifier like campaign-45 or parking-lot-pillar-3.
The origCtx parameter is used to identify the context of the location where the QR code is placed. This value is logged to Mappedin analytics to track the source of the QR code scan. This should be set to physical, digital or ad depending on the where the QR code is being displayed.
| Parameter | Type | Required | Description | Format |
|---|---|---|---|---|
| qrId | string | No | Unique QR identifier | Custom tracking string |
| origCtx | string | No | Placement context | Context value |
URL Configurator
The URL Configurator is an admin tool that provides a visual interface for building deep link URLs. Rather than manually constructing URLs, the configurator allows the map to be set up exactly as it should appear — camera angle, zoom, location, visible categories, and tracking options — and then generates a ready-to-use link or downloadable QR code image.
The URL Configurator currently supports generating Start From Here URLs in two modes:
| Tab | Description | Use Case |
|---|---|---|
| Display | Configure a fixed map view for non-interactive screens | Digital signage, kiosks, lobby TVs |
| Print QR | Generate a QR code for scan-and-go wayfinding | Printed signs, parking lot posts, wayfinding totems |
Accessing the URL Configurator
The URL Configurator is available at the following path on any deployed Mappedin Web instance:
https://<your-venue-domain>/<your-path-to-mappedin-web>/#/display-admin
At the top of the page, two tabs control which mode is active. The sidebar panel and available options change depending on which mode is selected.
Display Tab
Use this tab to configure a Display URL for showing the indoor map on a TV, kiosk, or digital signage display. The generated URL loads a locked, non-interactive map view designed for passive viewing.
Camera Position
This section controls the map's viewport — what the viewer sees on screen. These values can be set by typing numbers into the fields or by directly interacting with the map (panning, zooming, tilting, and rotating). The fields update automatically as the map is moved.
| Field | Description | Range |
|---|---|---|
| Latitude | North-south position of the map center | -90 to 90 |
| Longitude | East-west position of the map center | -180 to 180 |
| Zoom | How close the map is zoomed in | 0 (world view) to 24 (extreme close-up) |
| Tilt | The 3D tilt angle of the map | 0° (top-down) to 90° (edge-on) |
| Rotation | Compass heading / rotation of the map | 0° to 360° |
Screen Position
This section controls where the physical screen or TV is located on the map and which direction it faces.
| Field | Description |
|---|---|
| Facing Direction | A slider (0–360°) that sets which compass direction the TV screen faces. The tool also displays the "user-facing" direction — the opposite side of the TV, representing what the person standing in front of it sees. |
| Drag & Drop Marker | A TV icon appears on the map that can be dragged to the exact physical location of the screen. Right-clicking the map and selecting "Move Screen Here" repositions it instantly. |
Additional Settings
This collapsible section (collapsed by default) contains extra display options.
| Setting | Type | Description |
|---|---|---|
| Show Blue Dot Facing Screen | Checkbox | When enabled, a Blue Dot (simulated user position) appears in front of the TV, facing toward the screen. This gives viewers a "You Are Here" reference point. |
| Show QR Code | Checkbox | When enabled, a QR code is overlaid on the display so passersby can scan it to open the map on their phone. If Blue Dot is not shown, this QR code opens the general map homepage without a Blue Dot. |
| Tracking ID | Text field | An optional identifier for the QR code (e.g., lobby-tv-1, parking-lot-east). Used for analytics to track which QR codes are being scanned. |
| Show Floor Header | Checkbox | When enabled, a banner at the top of the display shows the current floor name, subtitle, and building or map group name. |
| Language | Dropdown | Sets the language for the display. Only appears if the venue supports multiple languages. |
| Priority Categories | Tag input | Categories whose labels are given visual priority on the map and shown more prominently. Type to search and select from available categories. |
| Hidden Categories | Tag input | Categories whose labels are hidden from the map display entirely. Type to search and select from available categories. |
Generating the Display URL
At the bottom of the panel, two action buttons are available:
| Button | Action |
|---|---|
| Copy URL | Copies the fully configured display URL to the clipboard. |
| Preview | Opens the configured display view in a new browser tab to verify the screen output. |
Print QR Tab
Use this tab to generate a QR Code URL and downloadable QR code image. Visitors scan the QR code to open the map on their phone, pre-set to their current location with a "You Are Here" Blue Dot.
Location & Camera Settings
The following fields control where the Blue Dot appears and how the map is presented when a visitor scans the QR code. These values can be set by typing directly into the fields or by interacting with the map (panning, zooming, and rotating). The fields update automatically as the map is moved.
| Field | Description | Range |
|---|---|---|
| Latitude | The latitude where the QR code sign is physically located | -90 to 90 |
| Longitude | The longitude where the QR code sign is physically located | -180 to 180 |
| Zoom | How zoomed-in the map appears when scanned | 0 to 24 |
| Rotation | The initial compass heading when the map opens | 0° to 360° |
QR Code Options
| Field | Description |
|---|---|
| Show Bearing Cone | When enabled, the map shows a directional cone indicating which way the visitor is facing when they scan the code. |
| Tracking ID | An optional identifier for analytics (e.g., entrance-A, gate-12). Helps track which physical signs generate the most scans. |
| Language | Sets the language for the experience after scanning. Only appears if the venue supports multiple languages. |
Generating & Downloading the QR Code
The following actions are available at the bottom of the configuration panel:
| Button | Action |
|---|---|
| Generate QR Code | Creates a QR code image in the panel based on the current configuration. |
| Preview as User | Opens the Start From Here URL in a new tab, simulating what a visitor would see after scanning. |
| Copy URL | Copies the generated URL to the clipboard. |
| Save Image | Downloads the generated QR code as a PNG image file, ready for printing. |
A phone frame preview also appears on the map showing approximately what the visitor will see on their mobile device after scanning the QR code.
Lock / Unlock Fields
Each numeric camera field (Latitude, Longitude, Zoom, Tilt, Rotation) has a lock button (padlock icon) next to it.
| State | Behavior |
|---|---|
| Unlocked (default) | The field updates automatically when interacting with the map. |
| Locked | The field value is frozen. Map interactions will not change it. This is useful for setting one value (e.g., zoom) and then adjusting others without losing it. |
For example, to keep zoom at 20 while panning to a different area, lock the zoom field at 20 and then pan the map freely — the zoom will remain at 20.
Category Filtering
Both Priority Categories and Hidden Categories (available in the Display tab) use a tag-style input:
- Click the input field and start typing a category name.
- An autocomplete dropdown appears with matching categories from the venue.
- Click a suggestion (or press Enter) to add it as a tag.
- Click the × on a tag to remove it.
These settings affect which location labels are visible on the display:
- Priority Categories — labels for these categories are shown more prominently.
- Hidden Categories — labels for these categories are completely removed from the map.
Tracking ID
The Tracking ID field (available in both tabs) allows a human-readable identifier to be assigned to each URL or QR code. This ID is embedded in the URL as a qrId parameter.
Best practices for Tracking IDs:
- Use descriptive, location-based names:
lobby-entrance,parking-lot-A,gate-12-arrivals - Keep them lowercase with hyphens (no spaces)
- Make each ID unique per deployment so analytics can distinguish between scan sources
Common Use Cases
Lobby TV Display
A mall wants a TV in their main lobby showing the directory map.
- Open the URL Configurator and select the Display tab.
- Pan and zoom the map to show the desired view of the mall.
- Adjust Tilt to add a 3D perspective if desired.
- Drag the TV marker to the lobby's physical location.
- Set the Facing Direction to match which way the TV faces.
- Enable Show Blue Dot Facing Screen so visitors see "You Are Here".
- Enable Show QR Code so visitors can scan to get the map on their phone.
- Set a Tracking ID like
main-lobby-tv. - Enable Show Floor Header to display the floor name.
- Click Preview to verify, then Copy URL and provide it for the display system.
Parking Lot QR Code Sign
An airport wants QR codes on posts in the parking garage so travelers can scan and navigate inside.
- Open the URL Configurator and select the Print QR tab.
- Pan the map to the parking lot entrance location.
- Set the Rotation to match the direction visitors face when approaching the sign.
- Enable Show Bearing Cone so visitors see their orientation after scanning.
- Set the Tracking ID to
parking-garage-level-2. - Click Generate QR Code.
- Click Save Image to download the QR code PNG for printing.
Multi-Language Venue
A stadium supports English and French. Displays in the French section should render in French.
- Open the URL Configurator and select the Display tab.
- Configure the camera and screen position as usual.
- In Additional Settings, select French from the Language dropdown.
- Click Copy URL — the URL will include
lang=frand the display will render in French.
FAQ
Can multiple URLs be generated for the same venue?
Yes. Each URL is independent. Different views, floors, languages, and configurations can each have their own URL. There is no limit to the number of URLs that can be generated.
Does the generated URL expire?
No. The URL is a set of parameters that the web app reads at load time. As long as the venue is deployed and accessible, the URL will work.
What happens if venue data changes (stores added, floors renamed)?
The URL uses camera coordinates and category names, not specific store IDs. If a category is renamed, the URL may need to be regenerated with the updated category name. Camera position and floor settings will remain valid.
What is the difference between the Display QR code and the Print QR code?
The Display QR (in the Display tab) is an on-screen overlay shown on the TV itself — visitors scan it while looking at the display. The Print QR (in the Print QR tab) is a standalone QR code image designed to be printed and placed on a physical sign independent of any screen.
Is any setup required on the customer's side?
No special setup is needed. For displays, the customer loads the generated URL in a web browser on their display device (TV, kiosk, tablet). For QR codes, they print and place the image wherever it is needed.
What does origCtx=physical mean in the QR Code URL?
This parameter tells the app that the visitor arrived via a physical QR code scan (as opposed to a shared link or bookmark). It enables the "You Are Here" experience and can be used for analytics to distinguish physical scan traffic.