Adding a TMS Map Source

7. Copy and paste this URL into a text editor like Notepad or TextEdit.

8. Replace the numbers at the end of the URL with {x}, {y}, and {z}, keeping the slashes ("/") in place.

In our example, the variables will need to be in this order: {z}/{x}/{y}

http://a.tile.stamen.com/terrain/{z}/{x}/{y}.png

Note: you may need to re-arrange these variables for the URL to work 

 

2. Check the URL

1. Go to http://trailbehind.github.io/TilejsonTester/

2. Copy and paste your adjusted URL along with the name and attribution for the map source

 

 

3. Click "Update Map"

4. Zoom to the area of the map that you expect to see your map source

If you have created the URL correctly, you will see your source appear in the correct area of the map. Proceed to step 3 below.

 

If your map source doesn't appear: 

• Adjust the zoom levels and update the map.
• Try adjusting the bounds to whole numbers.
• Try changing the order of your variables. Sometimes the {x} and {y} need to be reversed: /{z}/{y}/{x} 

 

3. Import URL to gaiagps.com 

1. Go to www.gaiagps.com and open the Map Layers Menu

2. Click "Add Map Layers" at the bottom of the sidebar.

3. Click "Add Custom Source"

4. In the Add Custom Source Menu:

1. Name the source
2. Paste in the URL you created above. 
3. Adjust the zoom range. Maps have a minimum and maximum zoom level, usually between 1-19.
4. Toggle on "Preview on Map" to see what the map will look like once imported.
5. Save your map.

It will automatically be made active on the main map. You can manage this source just like any other map source: Add and Manage Map Sources on gaiagps.com

 

Once the map has been imported to the website, sync your phone with your web account, and the source will appear in the map sources menu in the app:

• Add and Manage Map Sources in Android
• Add and Manage Map Sources in iOS

 

If you are unable to import a source on the web, you can import the source directly into the app with the steps below.

 

Import a TMS map source directly to Gaia GPS app 

To import a TMS source into the app you will need to create a TileJSON file. You will need a text editing program to do this. 

 

1. Follow the steps above to check the TMS URL. When your map successfully appears, you can create a JSON File.  

2. Copy the text in the 'JSON, editable' section

 

 

3. Open a text editor like TextWrangler or Sublime Text

4. Paste the text from the 'JSON, editable' section

5. Us the "Save As" option in your text editor to save the file with a '.json' extention

 

 

6. Import the JSON into the app:

Note: Please make sure you read the map provider's Terms of Service before using the map source in Gaia GPS.