Custom Sources are a way to bring in additional layers and overlays to CalTopo from outside sources. The ability to display additional geographic information in CalTopo is dependent on two initial factors:
Custom Source Layers require a Pro or higher subscription.
Topics on this Page:
Let's start by taking a look at the edit box for adding a layer from a custom source.
To get familiar with this edit box, first go to the dropdown menu that says “Prefill with” at the bottom of the box.
Here you can choose from a list of layers that we have prepared already. Select any of them to see how they load into the inputs for Type, Name, URL Template, Max Zoom, and Overlay.
Try out each prefill layer to see the formatting of the URL Templates.
Custom sources often have limitations in the ways they can display. For example, they do not zoom very well and work best at only a few zoom levels. Some will only display as an overlay and not as a layer, or they will work better as a layer rather than an overlay.
You can rename any of these prefills if you want. Also, to access them easily in the future, you can save them to your account and they will always appear in the Your Layers section in the layers or overlays list.
To save the layer to your account, click Save to Account at the bottom left of the edit box, as described in the custom layers introduction lesson. Editing is also covered there.
If you are familiar with the necessary formatting now, you can move on to bringing in a fresh source. Here are two examples, including links to the data if you want to try it for yourself.
First, you need to find a link that either works as the direct URL template matching one of the formats listed, or you need to find a link that you can enter into the auto-configure box to have CalTopo create the correct link format for you.
In the US, we have access to live radar services from the National Weather Service, as well as a number of graphical forecasts and other data, available at their web services page.
To find the appropriate pages, you can often search for your search term plus “web services” “map server,” or “REST services.”
From the above page, I chose the Base Reflectivity Radar link and got this page:
This is a map server, so I can use the URL for the this page. This will work in this case, though it does not always work. Another option to try is to click the WMS link at the top of the page to get direct access to a text file.
Either way, you’ll put the link into the auto-configure box and hit “GO.”
What you want to have happen is a box to open looking something like this, where you can choose while layers from that link will be included in your display.
Choosing this method gives a potential error, which you can tap OK and see what happens.
After choosing layers from this I get an error message that says “Server does not appear to support a compatible projection. Will try anyway, but this probably will not work.
With either link (map server page or wms file), we get a new link that appears in the URL template box. You should add a title for your layer, then press SAVE to display the layer on your map.
If it works, you should get a new layer, which will work just like other layers in CalTopo in that you can stack them, change the opacity, and more.
With this particular source for data, the layer updates every few minutes as new data is available.
Also, this particular data source can display in CalTopo well as either a layer or an overlay. Most of the time, data will really only work as one or the other. If your custom source isn’t displaying as you expected, consider editing it to be an overlay instead of a base layer.
While you are in the edit box, you could also change the name of the layer, and if you are happy with it and expect to use it again, Save it to your account with the blue link at the bottom-left of the box.
Once it saves, you will need to refresh the page to get it in your layers list. To edit it again (ie to change the name after you have saved it, add a new custom source, and use the “load from” feature, also in the lower left corner of the custom map source edit box, to select one of your saved layers to edit.
If you need to edit a layer after saving it to your account, you can do so via the same custom source edit box. Open a new custom source layer, then look for the dropdown menu labeled "Load From" in the bottom left corner.
Here you will find a list of all the layers that you have saved to your account. Choose one, then adjust the settings as necessary.
Note - when you save this newly adjusted layer to your account, it will save as a NEW COPY of that layer. It will not replace the orignal. If your intent was to replace the originally saved layer, you should go to the "Your Layers" section of your account info and remove the original layer there so that you only have the new one left.
Now let us practice with a source that is not set up as cleanly as the US radar data.
...which does not look like much. But we take the link listed as the URL here, and go back to CalTopo and pop it into the Auto-configure URL input.
Then press GO.
Next we get a long list of potential layers to pull into our new custom source layer. Depending on the map server, sometimes you will want all of the offerings, and sometimes only one. In this case, if we select all of them it’s very messy as these layers are not built to be tiled all into one. Let’s just pick one image - such as for Whistler.
Then I hit save and it goes back to the edit box.
The auto configure figured out that this was a WMS source and changed the Type field from Tile to WMS. It also created a URL template for me. I added a title called “Whistler Imagery.” Then select the save button to display the layer.
Now here is the imagery layer, and for compassion, the same location with the MapBuilder Topo layer.
So this image looks great when we are zoomed in quite a lot, but there is a problem as we zoom further out. Setting the custom source layer view at 100% opacity, and zooming out, we can see that this custom source is both geographically limited and the remaining background is all gray in places that the image does not cover. We could try going back and editing the layer to set it as a transparent overlay. However, in this case it remains the same. The gray background persists when set as an overlay, and furthermore we lose the ability to change the layer opacity. (If you are not familiar with layer opacity yet, check out the Using Base Layers lesson).
Here the custom source layer is displayed at 45% opacity.
As you can see, custom sources can be fickle. Map servers are not necessarily serving up data that fits into CalTopo’s model of use. They require some digging, creativity, and trial-and-error.