Managing Sites, Buildings, Levels¶

Welcome to our tutorial on using Pointr Cloud Dashboard to create and manage maps. We’ll walk you through the process of efficiently handling your Pointr Maps.

Key Components:

• Client: Represents your organization or entity. Top-level container for your map data.
• Site: Specific location or area within your organization (e.g., workplace, campus). Manage multiple sites within a client.
• Building: Physical structure within a site (e.g., office building, hospital). Create and manage different buildings within a site.
• Level: Refers to a specific area or floor within a building. You can sort and arrange maps according to different levels of buildings.

Throughout this tutorial, we’ll provide step-by-step instructions to create, edit, and manage these components using Pointr Cloud Dashboard, including:

• Managing Client

• Creating and Managing Sites

• Creating and Managing Buildings

• Creating and Managing Levels and Maps

Managing Client¶

Client refers to the owner or manager of sites and buildings and is the top-level container of your map data in Pointr Cloud.

With Advanced Configuration, you can easily customize your map’s SDK settings. This includes changing the maximum and minimum zoom levels, choosing a map style, adjusting the color of paths, and more.

To do this, go to Advanced Configuration, navigate to the SDK section, and make the desired adjustments. For more information on customizing maps with Pointr Cloud Dashboard, please consult your Project Manager.

Creating and Managing Sites¶

1. Navigate to the Sites page by following the hierarchy: Client > Sites > Buildings > Levels > Content. Note: Upon logging in to Pointr Cloud Dashboard, you’ll be directed to the Sites page.

   

2. Click on the Add new button to create a new site. Provide the following details:

   • Site Name (required)
   • External Identifier (required): must be unique within your selected sites (Note: We suggest utilizing the ‘External Identifier’ field. Internal identifiers may undergo changes during transitions between environments, but External Identifiers will remain consistent.)
   • Coordinates (required): specify the geographic boundary of the site using WGS 84 coordinates, which are the same as GPS coordinates.

   

   Note

   We use WGS 84 Web Mercator coordinates (e.g., -22.90556, -47.06083), commonly used by map websites. They help with dashboard scrolling and won’t impact your indoor map experience. They don’t require precise coordinates and can have slightly larger/smaller boundaries than your actual site or buildings. These coordinates merely act as approximate virtual boundaries to cover your sites and buildings. Rest assured, our Mapping service ensures meticulous georeferencing accuracy. Learn more here.

3. Locating a real-world location:

   • Use the Search bar at the top of the map.
   • E.g., enter a keyword like JFK for John F. Kennedy International Airport to quickly find and create a site for that location.

4. Drawing shapes and boundaries:

   • Use the Geometry tools to draw shapes and boundaries for your sites.
   • Choose from options like the polygon , circle , or cut-out tools to create a desired layout.

   

   Note

   To remove the entire geometry input and create a new one, click on the Clear icon . Then follow the steps above to draw a new boundary for your site.

5. Click Save to apply your changes.

6. Publish your new site before it can be used on the Pointr SDKs or REST API.

   

   Note

   The time required for Pointr Cloud to process and publish your content may vary based on factors such as map size, number of points of interest (POIs), and map complexity.

💡Tips: You can quickly navigate to any site on the world map using the Quick Locate icon.

Removing a Site:¶

1. To delete the entire site, including its metadata, access the Advanced Configurations on the left.

   

2. Under the Danger Zone, click on Delete

   

3. An alert will appear. Click Confirm in the top-right corner to remove the item, or click Cancel Deletion to cancel the request.

   

Creating and Managing Buildings¶

1. Navigate to the Buildings page by following this hierarchy: Client > Sites > Buildings > Levels > Content.

   

2. To create a new building, click on the Add new button and provide the following details:

   • Building Name (required)
   • External Identifier (required): must be unique within your selected sites (Note: We suggest utilizing the ‘External Identifier’ field. Internal identifiers may undergo changes during transitions between environments, but External Identifiers will remain consistent.)
   • Coordinates (required): specify the geographic boundary of the building using WGS 84 coordinates, which are the same as GPS coordinates.

   

3. Drawing shapes and boundaries:

   • Use the Geometry tools to draw shapes and boundaries for your buildings.
   • Choose from options like the polygon , circle , or cut-out tools to create a desired layout.
   • Once you define the area, the system automatically identifies the coordinates of your buildings’ boundaries.

   

   Note

   To remove the entire geometry input and create a new one, click on the Clear icon . Then follow the steps above to draw a new boundary for your building.

4. Click Save to apply your changes.

5. Publish your new building before it can be used on the Pointr SDKs or REST API.

   

💡Tips: You can quickly navigate to any building within a site using the Quick Locate icon.

Removing a Building¶

1. To delete the entire building, including its metadata, access the Advanced Configurations on the left.

   

2. Under the Danger Zone, click on Delete

   

3. An alert will appear. Click Confirm in the top-right corner to remove the item, or click Cancel Deletion to cancel the request.

   

Creating and Managing Levels and Maps¶

A building is composed of one or more levels (floors). Whilst level index is not important, it is crucial that:

Levels are in the correct order (reflecting their physical state - eg. if a level is higher than another level, its index must be higher) Level indices are numbered sequentially (eg. 1-2-3, 4-5-6) except for levels that have high ceilings. For example, if there is a level that has double the height, index should increment double to reflect it (eg. 1-2-4-5).

1. After creating a building, choose the building where you want to place your level (digital map).

1. Navigate to Levels: Follow this path: Client > Sites > Buildings > Levels > Content.

   

2. Click on the Add new button and provide level details:

   • Choose a map Type (required): e.g., workplace, retail, aviation.
   • Enter Level Index (required): level’s order.
   • Enter Long Name (required): displayed when hovering over the level shortcut.
   • Enter Short Name (required): displayed on the level shortcut on maps.

   Manage Level Details on Pointr Cloud Dashboard	Display Map Widget Results: Short Name: 3F/Long Name: Third Floor

3. Upload your map file:

   a. Option 1: Upload a GeoJSON map format. Check our Maps Specification for further details.

   

   b. Option 2: MapScale® (upcoming):

   • Upload or drag & drop your CAD floorplans (DWG/DXF/Vector PDF).

     

   • Adjust the orientation, size & location of your floorplan.

   • Save your floorplan and navigate to the Content section.
   • A pop-up will appear. Click Let’s Go to use MapScale® for digital conversion.

   

   • Confirm & save your map result

   

   • See the original floorplan for a map review

   

   • Make adjustments directly on your maps if needed (POIs, Map Objects, etc.)
   • Click Save to apply your changes.

   

   Note

   MapScale® is great for workplace floorplans. It also has experimental support for places like universities, hospitals, and hotels. These spots have common features like hallways, rooms, and even offices. For more specifics, check out the table below.

   	Full Support	Experimental Support	Not Supported
   Types	Workplace	Hotel, Hospital, University	Everything else
   Sort Map Object type (e.g., walls)	✅	✅	❌
   Decipher room function (e.g., meeting rooms)	✅	❌	❌
   Fetch CAD metadata (e.g., unit names)	✅	✅	❌

4. Publish your new level (map) before it can be used on the Pointr SDKs or REST API.

5. That’s it! Your map will appear within your building on your map widget in a few minutes!

   

   Watch MapScale®’s demo video - CAD files ready to use in 15 mins!

   Note

   The time required for Pointr Cloud to process and publish your content may vary based on factors such as map size, number of points of interest (POIs), and map complexity.

💡Tips: You can quickly navigate to any level within your building using the Quick Locate tool.

Removing a Level & Map¶

1. To delete the entire level, including its map content, access the Danger Zone and click Delete.

   

2. A pop-up notification will appear. Click Yes, continue to delete the item, or click No, go back to cancel the request.