1 files changed, 15 insertions, 0 deletions
diff --git a/main/src/cgeo/geocaching/connector/trackable/TrackableConnector.java b/main/src/cgeo/geocaching/connector/trackable/TrackableConnector.java
index 1281683..aea60e6 100644
--- a/main/src/cgeo/geocaching/connector/trackable/TrackableConnector.java
+++ b/main/src/cgeo/geocaching/connector/trackable/TrackableConnector.java
@@ -16,6 +16,21 @@ public interface TrackableConnector {
 
     public boolean canHandleTrackable(final String geocode);
 
+    /**
+     * Check whether the connector has URLs corresponding the the trackable.
+     *
+     * @return <tt>true</tt> if the connector handles URLs, <tt>false</tt> otherwise
+     */
+    public boolean hasTrackableUrls();
+
+    /**
+     * Return the URL for a trackable. Might throw {@link IllegalStateException} if called
+     * on a connector which does not have URLs for trackables. This might be checked using
+     * {@link #hasTrackableUrls()}.
+     *
+     * @param trackable the trackable
+     * @return the URL corresponding to this trackable
+     */
     @NonNull
     public String getUrl(@NonNull final Trackable trackable);