To ensure a smooth and organized process, it's essential to create Location Groups, Types, Beacons (if using), and Map images before proceeding to create individual locations on the map. Here's the step-by-step guide to create a new location in PassEdge:

1. Location Groups and Types: Before creating a new location, make sure you have defined relevant Location Groups and Types. These categorizations will help organize your locations effectively.

2. Beacons (Optional): If you plan to use Bluetooth beacons for location-based experiences, set up the beacons and assign them to the appropriate locations.

3. Map Images: Upload map images and accurately assign locations on the map. This step is crucial to ensure a visually informative map for your app users.

Once you've completed the above preparatory steps, follow these instructions to create a new location:

1. Navigate to Locations Node: In the Umbraco tree, locate and click on the "Locations" node. This will take you to the section where you can manage and create new locations.

2. Use "Create Location" Button: At the top of the screen, you'll find a "Create Location" button. Click on this button to initiate the process of adding a new location.

By following these steps, you can efficiently create individual locations on the map, with each location cascading into the previously defined Location Groups, Types, Beacons (if applicable), and Map images. This comprehensive approach ensures that your PassEdge App's map offers a seamless and user-friendly navigation experience.

Beacons

Assigning a beacon to a location is a crucial step to enable location-based tours within the PassEdge App. By linking a beacon with a specific location, the app can recognize when users are in proximity to that location and trigger relevant content or interactive experiences.

See the Beacon setup section for more details

Location ID

To ensure smooth integration and accurate recognition of locations within the PassEdge App, follow these guidelines for assigning Location IDs and associating them with beacon MINOR IDs:

1. Location ID and Beacon MINOR ID Match: The Location ID assigned to a location in the PassEdge CMS should match the associated beacon's MINOR ID. This correspondence enables the app to link the physical location with the beacon's unique identifier, facilitating seamless interactions during location-based tours.

2. Tour Stops and Unique Identifiers: For locations that are part of a tour and serve as stops along the route, it is essential to provide them with unique identifiers. For instance, you can use a combination of floor numbers and stop numbers to create identifiers like "1-001" for the first floor, first stop on the tour. This unique identifier ensures clarity and efficient navigation during tours.

3. Shared IDs for Non-Navigating and Non-Beacon Locations: Locations that do not serve as stops within an experience or are not associated with beacons can share the same Location ID across multiple instances. For example, all text labels can be assigned a location type of 1, and all bathrooms can be assigned a location type of 2. This simplifies management and organization for these types of locations.

By following these guidelines, you can optimize the organization and functionality of locations within the PassEdge App. Consistency in Location IDs and thoughtful associations with beacon MINOR IDs enhance the user experience during tours and ensure accurate interactions throughout the app.

Remember, the effective usage of Location IDs and beacon associations is vital in creating an engaging and user-friendly app experience. Should you need further clarification or assistance, please refer to our documentation or reach out to our support team for prompt and helpful guidance. Let's make your PassEdge App tour a memorable and seamless journey for all visitors.

Location Title

Location Title on the Map

The Location Title serves as the visible label for each location on the map within the PassEdge App. Its appearance and functionality vary based on the location type.

Text-Only Label Locations: For locations that have the location type set as a text-only label, the Location Title will be directly displayed on the map. These text labels are non-clickable and do not open a description panel. They provide concise and informative text information without the need for additional interactions.

Interactive Locations: For interactive locations that are part of a tour or associated with beacons, the Location Title will also be visible on the map. However, these titles are clickable, allowing users to interact with the location and access more detailed information through a description panel.

By customizing the Location Title based on the location type, you can enhance the map's clarity and functionality for your app users. Text-only labels provide straightforward information, while interactive locations offer engaging and informative experiences as users explore your institution.

Remember to align your Location Titles with the location types to ensure a seamless and user-friendly map representation within the PassEdge App. Should you need further assistance or have any questions, our documentation and support team are readily available to assist you. Let's create a visually appealing and informative map that enriches the tour experience for all app users.

All other location titles will display when the location icon is opened from within the map: 

Location Description

The Location Description is a crucial element that appears in the location description panel on the map within the PassEdge App. This panel provides users with detailed information about a specific location when they interact with it on the map.

Location Type

The Location Type field in the PassEdge CMS will auto-populate based on the "type" values that have been entered into the Location Types section. This automated feature streamlines the process of assigning appropriate location types to each location within the app.

Map Picker

The Map Picker dropdown in the PassEdge CMS is automatically populated based on the images entered within the Maps section of Umbraco. This convenient feature simplifies the process of assigning locations to specific map images for display within the app.

To assign a location to a map image, follow these steps:

1. Select Map Image: Choose the desired map image from the Map Picker dropdown. This selection will determine which map the location will be associated with.

2. Drag to Assign Location: Once the map image location has been selected, click and drag your mouse on the image to create a blue square. This square indicates the precise position where the location should exist on the map. By placing the square accurately, you ensure that the location appears correctly within the PassEdge App.

Note on Icon Placement: The PassEdge App incorporates built-in functionality to automatically "nudge" icons that are too close to each other. This helps to prevent overcrowding and maintain visual clarity on the map. If necessary, you may need to revisit this screen to adjust the location of the square based on how and where it displays within the app.