QGIS Troubleshooting Guide

Access Issues

 

1. Master Password Authentication

The first time you try to use the TravelTime plugin, you may be asked to enter a Master Password:

rtaImage.jpeg

This is not actually related to the TravelTime plugin, but instead is part of QGIS itself. The first time you are asked for this, you can simply enter a password to set it. 

More details can be found here
 

 

2. API Key Details

If you are receiving an error when using any of the TravelTime tools (even the Quick tools from the top navigation banner) then open up the plugin Settings and confirm that your API key details are correct. Specifically, make sure there is no space before or after your App ID or API Key, such as is the case below:

Screenshot 2022-04-21 at 14.11.02.png

You can expose your API Key by clicking on the eye icon:

Screenshot 2022-04-21 at 14.39.03.png

 

3. SSL Issues

Sometimes requests may fail when the SSL certificate can't be verified (e.g when connecting from an enterprise network with strict firewalls in place). If you are receiving an error when using any of the TravelTime tools, ope up the plugin Settings, and in the Customize endpoint field change the https to http:

Screenshot 2022-04-21 at 14.48.24.png

 

4. API whitelisting

All of the TravelTime tools in ArcGIS Pro involve making an API call to the TravelTime API. If you are unable to get any of the tools to work, it may be that your company does not allow API calls to be made unless the API has been whitelisted first. 

If you do use whitelisting, the URL that needs adding is - https://api.traveltimeapp.com
 


Data Issues

 

1. Blank or corrupted data

Blank rows in an input file, or data that is corrupted (e.g with null geometry) will return an error.

If you see this error:

Screenshot 2022-04-21 at 15.30.01.png

Open the Attribute Table of the input layer you are using, and check for Null rows:

Screenshot 2022-04-21 at 15.33.00.png


An input file may contain blank rows if it has been generated using a Geocoder and not all the addresses were successfully geocoded.

 

2. Unreachable areas

All lat-long coordinates being used for any of the tools must be in a physically reachable area. Locations on water (e.g a river) or in very remote locations will return an error:

Screenshot 2022-04-21 at 15.37.59.png

This may happen when the input layer has been created by converting polygon areas into points, e.g when using the centroid of zip codes / postcodes.

 

Licence Restrictions

 

1. Hitting the Credits/Minute limit

Our standard licences have a cap on the number of credits that can be used per minute, depending on the licence tier. If while a tool is running, you hit your credits per minute limit, the tool will fail.

Not sure what a Credit is? 1 credit is 1 hour of travel time. For example, a 1 hour Time Map request with a layer of 10 points = 10 credits.

To ensure that you don't hit your limits, you can set a throttle on the number of API calls that are made per minute by opening up the plugin Settings:
 

Screenshot 2022-04-21 at 15.43.00.png

Note - the number of API calls is not always the same as Credits. For example, an API call to make a 2 hour isochrone will equal 2 credits. More details on Credits can be found below:

What is a Credit?



Tool Configuration

 

  1. Non-unique IDs

When running any of the Advanced Tools, where the ID fields are configurable, the field selected as the ID must be unique amongst all points.

If you receive an error like below:

Screenshot 2022-04-21 at 15.57.58.png

Open up the Attribute Table of the input layer, and check for any duplicate values amongst the field being used as the ID. For example, in the layer below, we couldn't use the City field as the ID because it is contains duplicate values:

Screenshot 2022-04-21 at 16.00.38.png



2. Arrival/departure date

We typically support public transport data for two weeks back from today's date, and six weeks forwards.

 

For example, on 1st June 2022, we would typically support any searches within a window from 18th May 2022 - 13th July 2022.
 

Running a public transport search with an arrival/departure date outside of this window will return an error like below:
 

Screenshot 2022-04-21 at 16.06.21.png


 

3. Advanced parameter values

None of the Advanced Parameters (except for Search Range Width) can be greater than the Travel time field value. For example, a Walking Time of 30 minutes and a Travel time of 15 minutes will return an error like below:

Screenshot 2022-04-21 at 16.09.05.png