## tools ### 3D Model Mapper # 3D Model Mapper The 3D Model Mapper allows a user to place 3D models on a map and customize their appearance. Models that are placed on the map can be exported to a JSON file and used in other projects. The 3D Model Mapper uses models from the Mappedin 3D Assets Library. !3D Model Mapper ## How to use the 3D Model Mapper When initially opened, the 3D Model Mapper will use a demo key and secret to load Mappedin's demo venues. ### Loading Your Own Map To load your own map, you will need to provide your own API key and secret. These require a Mappedin Pro or Solutions subscription. Refer to Create a Key & Secret for instructions to create your own key and secret. !Switch Keys Once you have your own key and secret, click on the `Switch Keys` button in the Mappedin menu, enter your key and secret, and click `Submit`. A list of your maps will appear within the `Select Venue` dropdown menu. Choose the map you wish to use. Note that switching maps will clear all models currently on the map. ### Placing & Editing Models Expand the `Mappedin` menu to view a selection of 3D models that can be placed on the map. Select the desired model and customize its color and rotation from within this menu. !Select Model Models are placed on the map by left clicking. Once a model is placed, it can be edited or deleted by right clicking on it. To remove all models from the map, expand the `Mappedin` menu and click the `Remove All Models` button. ### Exporting & Importing Models To export the models currently on the map, expand the `Mappedin` menu and click the `Export Models` button. This will download a JSON file containing the models currently on the map. These models can be imported into the 3D Model Mapper by clicking the `Import Models` button. > The model export file positions models using latitude and longitude coordinates. This means the export file must be imported into the same map (or a map at the same location) for the models to be visible. ### Using the 3D Model Export In Other Projects The 3D Model Export can be used in other projects. The following examples demonstrate how this could be done. These are minimal examples that read the exported JSON file and display the models. - React 3D Model Mapper Import Example - Vanilla TypeScript 3D Model Mapper Import Example The React 3D Model Mapper Import Example is embedded below: #### Using the Import Examples With Other Maps The import examples can be used with other maps by loading the exported JSON file into the import example and updating the key, secret and mapID used in the example. To load your own map, you will need to provide your own API key and secret. These require a Mappedin Pro or Solutions subscription. Refer to Create a Key & Secret for instructions to create your own key and secret. Follow the steps below to use the import examples with your own map: 1. Open the React or TypeScript CodeSandbox example. 2. Click on the `Fork` button at the top right of the page to create your own copy of the example. 3. Upload an exported JSON file to the project. 4. Update the key, secret and mapID in the example to match your own map. 5. Update the filename of the JSON file from `mappedin-models.json` to the filename of the JSON file you uploaded. 6. Run the project to see the models in your map. For more information on using 3D models with Mappedin JS refer to the 3D Models Guide. ### Blue Dot Location Generator # Blue Dot Location Generator The Mappedin Blue Dot Location Generator app can be used to generate location data for testing. To create test data, load a map in the generator app and choose a Start and End space. Click Generate to generate the data and observe the Blue Dot on the map using the generated data for its position. Press the Download button to download the location data in JSON format. The data can be customized by specifying the parameters below: - **Venue Settings**: Add in a key, secret and map ID to load a different map. - **Environment**: Whether to load the map from Mappedin's North American or European environment. By default, maps exist in the North American environment. - **Jitter**: The amount of random variation in the position data from the navigation path. - **Accuracy**: The accuracy used in the data. In a real world scenario this value represents how accurate the indoor positioning system believes the result to be and is used to draw the light blue shading around the Blue Dot. - **Distance Between Updates**: The physical distance between each position update. Lower values will result in smoother movement of the Blue Dot. - **Start Space**: The space to start the Blue Dot's movement. - **End Space**: The space to end the Blue Dot's movement. - **Time between updates**: The time between each position update can be used to control the speed of the Blue Dot's movements. - **Path Near Radius**: Controls the size of the path shown on the map. ### Blue Dot Location Generator Use the embedded Blue Dot Location Generator below or open the Blue Dot Location Generator in a new tab for a larger view. ### Flyover Generator # Flyover Generator The Flyover Generator can be used to generate a flyover animation over a series of locations on a map. !Flyover Generator ## How to use the Flyover Generator To use the Flyover Generator, load a map in the generator app and select a series of locations. Press the `Run Flyover` button to begin the animation. TypeScript code to recreate the flyover animation using Mappedin JS can be generated by clicking the `Export Code` button. The video below is an example of a recording of the flyover animation. - Try it out ### Mappedin GIS Exporter # Mappedin GIS Exporter Mappedin GIS Exporter can be used to create building footprint datasets from a workspace. Enter API credentials, choose how multi-level maps should be handled, then generate and download ready-to-use files for Geographic Information System (GIS) and data integration all from a web browser. !Mappedin GIS Exporter Demo ## Get an API Key A Mappedin API key and secret are required to use the Mappedin GIS Exporter. - To try the exporter with demo maps, use the keys on the Demo Keys & Maps page. - To use your own maps, create your own unique key and secret. Using maps with your own key and secret requires a Pro subscription. ## How To Use 1. Open Mappedin GIS Exporter. 2. Enter an API Key and Secret. 3. Choose Elevation handling for each map's floors: - Only ground level `default`: includes only floors with elevation === 0; exports one feature per qualifying floor with `properties.elevation = 0`. - All levels combined `union`: includes all floors (no filter); unions into a single MultiPolygon feature; `properties.elevation = null`. - Aerial levels combined `union`: includes floors with elevation ≥ 0 (ground and aerial); unions into a single MultiPolygon feature; `properties.elevation = null`. - All levels separate: includes all floors; exports one MultiPolygon feature per floor with `properties.elevation` set to that floor's elevation. 4. Click "Export Footprints". The exporter fetches all maps in the workspace, extracts footprints per selection, and prepares a FeatureCollection. 5. When the status indicates it's ready, choose a download format: - GeoPackage `.gpkg` — recommended for best interoperability and fidelity - Shapefile `.zip` - FlatGeobuf `.fgb` - GeoJSON `.geojson` Mappedin GIS Exporter exports a single dataset containing one or more features per map, depending on the elevation mode. This dataset represents all maps accessible to your API key in the workspace. ## Feature attributes Each exported feature (MultiPolygon) includes the following properties: - `name` `string`: Map name. - `address` `string`: Map/site address, when available. - `updated_at` `string`: Last update timestamp for the map data. - `map_id` `string`: The map's identifier used in API requests. - `viewer` `string`: Viewer URL for the map. - `editor` `string`: Editor URL for the map. - `elevation` `number | null`: - `0` for ground-only features. - Floor elevation for "All levels separate". - `null` for combined modes ("All levels combined (union)" and "Aerial levels combined (union)"). Notes: - All processing occurs in your browser - API keys are sent only to Mappedin APIs and are not stored by this tool - Processing time is dependant on the number and size of maps in the workspace - Geometry is always exported as a MultiPolygon - In Shapefile exports, long property names may be truncated to DBF field limits - Maps with invalid geometry or missing data are logged and skipped; the export will continue for remaining maps - Coordinate reference: WGS84 (EPSG:4326); no reprojection is performed ### Mappedin Studio # Mappedin Studio Mappedin Studio allows customization of a map's color scheme. Adjust colors for both indoor and outdoor features, such as floors, walls, doors, parks, water, roads and more. !Mappedin Studio ## How to use Mappedin Studio 1. Open the Mappedin Studio at: https://tools.mappedin.com/tools/mappedin-studio/ 2. Use the menu to customize the map's color scheme. 3. Edit the map using the tools provided. 4. Click the **Download** dropdown and choose the format you want to download: - `Indoor Style` A TypeScript file containing JSON that can be uploaded to be used again in Mappedin Studio or referenced in a custom app that uses Mappedin JS to style the indoor map. - `Outdoor Style` A JSON file that can uploaded to be used again in Mappedin Studio or referenced in a custom app that uses Mappedin JS to style the outdoor map. Mappedin Studio is pre-populated with Mappedin Demo Maps. It is also possible to use your own map. To do so click on the Map dropdown at the top right of the page and click the `Switch Keys` button. To load your own map, you will need to provide your own API key and secret. These require a Mappedin Pro or Solutions subscription. Refer to Create a Key & Secret for instructions to create your own key and secret. ## Using a Custom Outdoor Style An outdoor style created in Mappedin Studio can be used in an app that uses Mappedin JS. For more information and example code refer to the Outdoor Style Guide. ## Using a Custom Indoor Style An indoor style created in Mappedin Studio can be used in an app that uses Mappedin JS. For more information and example code refer to the Using a Mappedin Studio Indoor Style Guide. ### MVF Visualizer # MVF Visualizer The MVF Visualizer renders a Mappedin Venue Format (MVF) bundle on a 2D map for inspection and debugging. Upload a zip file containing an MVF v2 or v3 bundle to browse its file structure, visualize GeoJSON layers on an outdoor base map, and inspect individual feature properties. !MVF Visualizer ## How To Use 1. Open the MVF Visualizer. 2. Drag and drop an MVF `.zip` file onto the upload area, or click **Choose file** to select one from the file system. 3. Once parsed, the map renders all GeoJSON layers and the interface displays the file tree, map view, and file contents panel. ## Features ### File Tree The left panel displays the folder and file structure of the MVF bundle. Selecting a file highlights it and displays its JSON contents in the right panel. GeoJSON files include a visibility toggle (eye icon) to show or hide their layer on the map. ### Map View The center panel renders all visible GeoJSON layers on a 2D base map. The map automatically fits to the bounds of the loaded data. Click the re-center button in the bottom-right corner to reset the view at any time. Clicking a feature on the map opens a popup displaying the feature's properties, including its source file and any cross-referenced IDs. Cross-reference links navigate directly to the related feature. ### Floor Filter For multi-floor venues, use the floor filter control to show or hide layers by floor. ### Edge Weights Node layers support an edge weight visualization toggle that overlays connection weights on the map for debugging navigation graphs. ### File Contents The right panel displays the raw JSON contents of the selected file with syntax highlighting and search functionality. ## Notes - All processing occurs in the browser. No data is uploaded to a server. - The visualizer supports both MVF v2 and MVF v3 bundles. - The bundle is cached locally so it persists across page refreshes. Click **Load new MVF** in the header to clear the current bundle and upload a new one. - Try it out ### Print Map Styler # Print Map Styler Print Map Styler can be used to customize the appearance of SVG files exported from Mappedin Maker before they are imported into publication applications. !Print Map Styler ## How to get an SVG file from Mappedin Maker 1. Log into Mappedin Maker at: https://app.mappedin.com/ 2. Select the map to export. 3. Click the **Download** button. 4. Select **Download as SVG** from the dropdown menu. 5. Download the SVG file. This process downloads a zip file containing a SVG file for each floor of the map. Extract each SVG file from the zip file and use it with the Print Map Styler. ## How to use the Print Map Styler An example SVG file that can be used with the Print Map Styler is available to download here. 1. Open the Print Map Styler at: https://tools.mappedin.com/tools/print-map-styler/ 2. Click the **Upload SVG** button and select the SVG file you want to edit. 3. Edit the map using the tools provided. 4. Click the **Download** button to download the edited SVG file. ### Tools # Tools Mappedin provides tools that enable customers and partners to customize and enhance their indoor maps and the applications that use them. These range from map customization to visualization and testing utilities, allowing for complete control over the appearance and functionality of indoor mapping solutions. Build a map and then use the tools below to customize and enhance it. ## Mappedin Studio Mappedin Studio allows creation and customization of a map's color scheme. Adjust colors for both indoor and outdoor features, such as floors, walls, doors, parks, water, roads and more. !Mappedin Studio - Learn More - Try it out ## 3D Model Mapper The 3D Model Mapper allows a user to place 3D models on a map and customize their appearance. !3D Model Mapper - Learn More - Try it out ## Map Flyover Generator The Map Flyover Generator allows a user to select a series of locations on a map and generate an animated flyover path over each location. - Learn More - Try it out ## Print Map Styler !Print Map Styler Mappedin Maker allows indoor maps to be exported as a Scalable Vector Graphics (SVG) file. The Print Map Styler allows the SVG file to be edited to customize the map's appearance before it is used in publication applications. - Learn More - Try it out ## Blue Dot Location Generator !Blue Dot Location Generator The Mappedin Blue Dot Location Generator can be used to generate location data for testing. To create test data, load a map in the generator app and choose a Start and End space. Click Generate to generate the data and observe the Blue Dot on the map using the generated data for its position. Press the Download button to download the location data in JSON format. The data can be customized by specifying the parameters below: - Learn More - Try it out ## Mappedin GIS Exporter !Mappedin GIS Exporter Mappedin GIS Exporter can be used to create building footprint datasets from a workspace. Enter API credentials, choose how multi-level maps should be handled, then generate and download ready-to-use files for GIS and data integration all from a web browser. - Learn More - Try it out ## MVF Visualizer !MVF Visualizer The MVF Visualizer renders a Mappedin Venue Format (MVF) zip file on a 2D map for inspection and debugging. Upload an MVF v2 or v3 bundle to browse its file structure, visualize GeoJSON layers, and inspect feature properties. - Learn More - Try it out