Adding Polylines or Importing Routes

Created by Glen Barnes, Modified on Mon, 16 Sep at 11:19 PM by Natalie Nguyen

Polylines are used to provide routes in the map. Adding these polylines enhances the navigational experience for users, providing a clear visual representation of tour paths. There are two methods to incorporate polylines: adding new routes on the STQRY builder and importing routes with KML or GeoJSON files.

Method 1: Adding New Routes to Terrain or Satellite Maps

Note: If you have “Geofencing” on your app, you must turn it off before drawing your polyline. You can enable it again after you have added polylines and saved your work. To enable/disable Geofencing, click on the symbol  as shown in the screenshot below.

Here is how to add polylines to a map:

1. Choose Content >> Open the tour you wish to add the polylines >> Choose the Map section.
2. Click the Line String tool

3. With the Line String tool, you can now make polylines for routes and paths. Click the point where you want to start and drag it to any location to create segments, then double-click once you are done to turn the polyline from dashed to solid. You can also add as many polylines as you want.

Here is a GIF demonstrating how to add a polyline:

4. To edit a polyline, double-click any segment point to change the line from solid to dashed >> then move it to your desired new location >> double-click once you are done and hit “Save” to apply the changes you made.

Here is a GIF demonstrating how to edit a polyline:

5. To change the polyline color, click on the on the line to turn it into a dash line >> Select the desired color from the list. Optionally, use a hex code for a preferred color >> hit “Save” to apply the changes you made.

Here is a GIF demonstrating how to change a polyline color:

6. Clicking the “trash bin” symbol will remove the polylines entirely. But you may choose to remove per route by clicking a segment point to turn it from solid to dashed >> then click the “trash bin” symbol>> On the pop-up window, you should choose Cancel to discard any changes or Continue to commit the changes.

Here is a GIF demonstrating how to remove a polyline:

7. Once you are done adding polylines, click “Save” or “Save & Close”. Don’t forget to enable the “Geofencing” button for your Geofencing to work on the app again.

You can also follow the same steps to add polylines directly to the multiple location map section on every screen.

Method 2: Importing Routes with KML or GeoJSON Files

Here is how to import routes with KML or GeoJSON files

1. Choose Content >> Open the tour you wish to add the polylines >> Choose the Map section.

2. Click on the Import Routes button and upload the prepared KML or GeoJSON files containing your route data.

KML and GeoJSON files can be generated from various platforms, such as Ride with GPS.

Collection-FnB-Ballarat-Map (1).png

STQRY also supports elevation maps to enhance the user experience by providing comprehensive terrain details, including elevation changes along a route. This feature is particularly valuable for activities such as hiking, cycling, or driving tours, where understanding the terrain's difficulty is crucial.

To incorporate elevation data into your maps, simply upload GPX files containing elevation information, or upload a GeoJSON file with elevation data. For GeoJSON files, ensure that each point includes a third coordinate representing elevation.

Example: 
 "coordinates": [
      175.55890560150146,
      -39.28834275351452,
      2797
    ]

3. Click “Save” or “Save & Close” to commit the changes.

Please note that when importing routes, pin markers from the external file will not be carried over. However, the route lines will be overlaid onto the selected map.

This change does not require a new app build. Users will see the updates upon their first download. For existing app users, they will need to update the app to view the changes.

Should you require any assistance or have further questions, don't hesitate to reach out to our support team at [email protected]. Happy app building!

Attachments (10)