Map Tokens

Map tokens are a quick and powerful way to share individual maps with non-FireMapper users, 3rd party agencies and external applications. Each map token is a QR code/URL that provides controlled access to an individual map. They are designed for quickly sharing a map during an incident in a user friendly format.

Typical use cases for this functionality include:

• Sharing a map with a FireMapper user from a different agency when deployed to a joint incident

• Plugging into to external GIS tools such as ArcGIS Online, QGIS Desktop, Avenza

• Providing temporary map viewing or editing access to a 3rd party during an incident

Creating Map Tokens

1. Go to the Shared Maps page using the navigation sidebar and select the Shared Maps tab at the top of the screen

   

2. Locate the map you want to share and click its Map Properties button.

   

3. Scroll to the bottom of the dialog and click Create Map Token.

   

4. Enter Token Details.

   • The Token Name should reflect the purpose and intended recipient of the token, to ensure traceability of the token and control of access. It is possible to have multiple tokens for the same shared map, eg. one for IMT (Manly Dam HR IMT) and one for firefighters (Manly Dam HR Ground Crew).

   • Map Tokens automatically expire to prevent long term unauthorized access to your maps. The expiry will default to 5 days, but can be adjusted to 30 days. Contact FireMapper Support to request greater expiry durations if required. After creating a Token, you may edit the expiry.

   • The Landing Page of the map token can be set to either the map itself or a detailed summary landing page

   • Custom permissions may be set for each Token to restrict access to the map. The permissions include:

     • Allow Map Editing - add, modify and delete features on the map. Users can edit the map using the web browser, ArcGIS Online, ArcGIS Pro or any third party application that can connect via a ArcGIS FeatureServer endpoint.

     • Allow Location Sharing - view organisation’s resource locations (eg. TracPlus, ADS-B, FireMapper users).

     • Allow User Metadata - view feature metadata, including author information.

     • Allow Photos - view photos that have been shared on the map.

     • Allow Third Party Apps - open the map data in external GIS applications, such as QGIS, Avenza Maps and Google Earth.

   

5. The generated map token will be displayed. It can be shared in either QR-code or URL format to grant access to the map until the token expires or is revoked.

   

Viewing Map Tokens

If the Token as been set to land on the detailed summary page, it will open as a webpage. This webpage contains options to view, share or print the map.

If the Token also has the ‘Allow Third Party Apps’ permission enabled, the webpage allows the map to be downloaded as a KML, KMZ, GPX, GeoPackage, Esri Shapefile or CSV file, or to be opened in ArcGIS Online, ArcGIS Pro, QGIS Desktop or Google Earth.

Note

If it is opened on a mobile device, the map can also be opened in Avenza Maps, if it is installed.

Revoking Map Tokens

Once a Map Token is no longer required, it can be manually revoked to prevent unauthorised use.

1. Go to the Map Tokens page using the Portal sidebar

   

2. Select the Active Tokens tab at the top of the screen.

   

3. Find the Map Token that you want to revoke in the table. Click the Revoke button on the right side of the table.

Note

If you Archive a map from the Shared Maps page, access via all Map Tokens will be automatically revoked to prevent unauthorised access to the Archived map.

Renewing Map Tokens

Once a Map Token has expired it can no longer be used to access the map.

However, if a user still needs to use an expired token, you can renew the expired token to quickly restore access to the shared map.

1. Go to the Map Tokens page using the navigation sidebar in the FireMapper Portal

   

2. Select the Expired Tokens tab at the top of the screen.

   

3. Click the renew button on the right side of the map token that you want to renew. The orange background is used to highlight the map tokens that are have expired.

4. Click Renew to confirm that you want to Renew the map token.

   This will update the expiry date for the map token so it is one week into the future, so the map token is no longer expired. Users will now be able to access the map token for the next week.

   It is possible to change the expiry date, to a different date after renewing a token, by going to the active tokens tab and editing the map token.

Reactivating Map Tokens

A Map Token can be reactivated if it has been revoked and needs to be used again. This is useful if you revoke an Map Token by accident. Reactivating a token allows you to use the same QR code.

1. Go to the Map Tokens page using the navigation sidebar in the FireMapper Portal

   

2. Select the Revoked Tokens tab at the top of the screen.

   

3. Click the Reactivate button on the right side of the table for the map token that you want to restore. The red background is used to highlight the map tokens that are currently revoked.

   

4. Click Reactivate to confirm that you want to Reactivate the map token, so anyone who has the map token URL/QR code will be able to access the shared map again.

   

5. Users will now be able to use the map token that you have reactivated. The Map Token URL/QR Code will still be the same as it was before. If users had tried to access the map token while it was revoked in the web browser, they may need to refresh the webpage.