URL structure and short URLs on RouteYou

Table of contents

• URL of a route
  • The basic structure
  • Shortening the URL
  • URL for dowload
  • URL parameter to view people sharing their position on a route
• URL of a location
  • General structure
• URL to plan a route
• Search Settings
  • Examples
• URL of a theme or characteristic
  • The basic structure
  • Some great combinations to link to:
• URL to get an overview of routes or places linked to a keyword
  • URL to follow an account
• URL to RoutePlanner with specific routing option and maplayer
• URL for links to the app

URL of a route

The basic structure

This is an example of a URL of a route

https://www.routeyou.com/en-be/route/view/44/walking-route/walking-in-ghent

It contains the following main parts

• www.routeyou.com: the domain
• /en-be : the language/country indication
  • you can drop this, so your URL becomes language independent
    • e.g. https://www.routeyou.com/route/view/44
    • In that case the website will switch to an existing language (if possible selecting the language the user selected as interface)
  • you can shorten it to just the language
    • e.g. https://www.routeyou.com/en/route/view/44
    • e.g. https://www.routeyou.com/nl/route/view/44
    • If you don't have the route in that language, the website will switch to an existing language. E.g. https://www.routeyou.com/es/route/view/44/
• /route : the type of object
• /view : the action
• /44 : the route ID
• /walking-route: the type of route
• /walking-in-ghent: the title of the route

Shortening the URL

As you can notice from the description above, you can make the url much shorter:

e.g. https://www.routeyou.com/route/view/44

We also allow you to use a very short URL which is handy if you want to mention a link in a document people have to copy in their browser.

e.g. www.routeyou.com/r/44

URL for dowload

The structure of the URL to get to the download of a route is

https://www.routeyou.com/route/view/[route_ID]#download

Example

https://www.routeyou.com/route/view/44#download

URL parameter to view people sharing their position on a route

Read more about the funciton Position Sharing here

The variable

#users=1

at the end of a route URL allows you to switch on the layer of active users. 

You have to be logged in to see the active user(s). So sending the URL below will trigger a login request.

Example: 

https://www.routeyou.com/en-be/route/view/6198551/recreational-cycle-route/discover-the-pajottenland-from-erasmus#users=1

 

If you want to see everybody who is active, use a group. See this example:
https://www.routeyou.com/nl/group/view/57725/wie-is-actief#users=1

If you want to show a few routes in combination who is active, you can combine routes and people sharing their position. See this example:

https://www.routeyou.com/nl/group/view/57727/wie-is-actief-op-de-hagelandse#min-lat=50.81795&min-lon=4.45982&max-lat=51.09305&max-lon=5.25015&users=1

URL of a location

General structure

This is an example of a URL of a location

https://www.routeyou.com/en-be/location/view/48534842/cozy-house-j-e?toptext=2164329

The short version is

https://www.routeyou.com/location/view/48534842

You can add just the language indication to the url:

• https://www.routeyou.com/en/location/view/48534842
• https://www.routeyou.com/nl/location/view/48534842

In case you have several items linked to a location, you can indicate which item you want to have at the top:

• https://www.routeyou.com/en-be/location/view/48534842/cozy-house-j-e?toptext=2164329
• https://www.routeyou.com/en-be/location/view/48534842/cozy-huis-j-e?toptext=2164328

URL to plan a route

You can make a URL with a specific location (e.g. a hotel) and get to our RoutePlanner to see the result and adapt it if you like.

Here is an example

• https://www.routeyou.com/en-be/route/planner/0/#zoom=16&begin-lat=51.054&begin-lon=4.727&&length=10000
  • The planner/0/ indicates this is about the outdoor
  • begin-lat=51.054&begin-lon=4.727 indicates the start and end coordinate for the loop
  • lenth=10000 indicates the route is about 10 km
  • /en-be/ indicates the interface is English and the country is Belgium

• https://www.routeyou.com/nl/route/planner/1/#zoom=16&begin-lat=51.054&begin-lon=3.727&end-lat=52.054&end-lon=4.727
  • When two coordinates are given, you get a from-to route
  • planner/1/ indicates it's a bicyle route 
  • The default routing for this type is used

You can also do it with a specific planner of an account:

• https://www.routeyou.com/user/planner/217592#zoom=16&begin-lat=51.054&begin-lon=3.727&end-lat=52.054&end-lon=4.727

Search Settings

Available on all search pages except where they conflict with the page's purpose (e.g. no theme parameter on theme page).

For routes and places of interest:

• language: lower case ISO language code, e.g. nl, en, fr
• owner: owner ID; special case: use a hyphen (-) to use the currently logged in user's ID (only if there is a logged in user)
• group: group ID
• characteristic: characteristic ID
  • child friendly = 3
  •  
• theme: theme ID
• min-score: minimum score (between 0 and 5)
• max-score: maximum score (between 0 and 5)
• favorite: 1 if the currently logged in user's favorites should be shown (only if there is a logged in user)
• clustered: 1 if cluster squares should be shown
• sorting: valid sorting key, e.g. relevance, name, mostViewed, mostViewedThisMonth, mostRecent, score, length
  • Examples - Accounts
    • Most popular routes of this account, this month: https://www.routeyou.com/user/routes/10641/pascal-brackman-routeyou#language=en&sorting=mostViewedThisMonth
    • Most popular routes of this account, ever: https://www.routeyou.com/user/routes/10641#language=nl&sorting=mostViewed
    • Routes with highest score of this account, ever:
  • Examples - Region:
    • Routes with highsest score in this region:
      • Limburgse Kempen: https://www.routeyou.com/nl-be/location/routes/47418548#llanguage=nl&sorting=score
      • Westhoek: https://www.routeyou.com/nl-be/location/routes/47418549#llanguage=nl&sorting=score
      • De Vlaamse Ardennen:
        • Fietsen - https://www.routeyou.com/nl-be/location/bike/47418543#llanguage=nl&sorting=score
        • Wandelen - https://www.routeyou.com/nl-be/location/walk/47418543#llanguage=nl&sorting=score
  • Examples - POIs
    • Topbossen: https://www.routeyou.com/nl-be/poi/search#lat=52.30453697201722&lon=5.2934061007048285&zoom=8.000000000108926&poi-type=69&sorting=score
      • BOS: &poi-type=69
      • HELLING: &poi-type=239
      • MUSEA: &poi-type=106
      • MONUMENT: &poi-type=165
      • ABDIJ: &poi-type=127
      • AQUADUCT: &poi-type=127
  • Examples - Theme
    • Routes with highest score of this theme, ever:

• keywords can be set with the query (?) parameter q, not as a hash parameter
  • example of showing routes having the word "difficult" in the title or description: https://www.routeyou.com/en/route/search?q=difficult
  • example of showing places having the word "chocolate" in the title or description: https://www.routeyou.com/nl-be/poi/search?q=chocolade
  • example of showing places having the word "great" in the title or description: https://www.routeyou.com/nl-be/poi/search?q=great
• location:
  • example of detecting any type of route near your current location: https://www.routeyou.com/en/route/search/0/outdoorroutes-search#location=-
  • example of detecting walking routes near your current location: https://www.routeyou.com/en/route/search/2/outdoorroutes-search#location=-

For routes only:

• route-type: route type ID
• min-difficulty: minimum difficulty (between 0 and 1)
• max-difficulty: maximum difficulty (between 0 and 1) - the interface only supports difficulty classes, so values should be 0, 0.2, 0.4, 0.6, 0.8 or 1 and max should be min + 0.2; other values are possible but will break the difficulty drop-down
• min-length: minimum length in kilometers or miles
• max-length: minimum length in kilometers or miles
• event-type: event type ID
• event-min-date: event "after" date, in yyyy-mm-dd format
• event-max-date: event "before" date, in yyyy-mm-dd format

For places of interest only:

• poi-type: place of interest type ID

Examples

• https://www.routeyou.com/nl-be/route/search/0/outdoorroutes-zoeken#theme=3&min-score=4&max-length=50&clustered=1
• https://www.routeyou.com/nl/theme/view/3/natuur#language=nl&route-type=2&poi-type=513
• https://www.routeyou.com/nl-be/route/search/0/outdoorroutes-zoeken?q=ronde+van+vlaanderen#theme=22

URL of a theme or characteristic

The basic structure

The basic URL to link to a theme is

https://www.routeyou.com/theme/view/8

The basic structure to link to a characteristics is

https://www.routeyou.com/characteristic/view/3

If you want to enforce to get to a specific language, you add the language parameter:

https://www.routeyou.com/nl/theme/view/8

https://www.routeyou.com/en/theme/view/8

But you can combine the two. An example where you get to see POIs in Dutch in a specific bounding box, and POIs linked to the characteristic Funny and belonging to the theme History.

https://www.routeyou.com/nl/theme/view/8/#min-lat=50.21368&min-lon=4.39259&max-lat=52.22849&max-lon=5.42049&pois=1&characteristic=25

Some great combinations to link to:

• Peculiar / geography in Europe:
  • Routes: https://www.routeyou.com/en/theme/view/12/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=19
  • Places: https://www.routeyou.com/en/theme/view/12/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=19
• Peculiar h/ istory in Europe:
  • Routes: https://www.routeyou.com/en/theme/view/8/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=19
  • Places: https://www.routeyou.com/en/theme/view/8/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=19
• Spectacular / World Heritage in Europe
  • Routes: https://www.routeyou.com/en/theme/view/26/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22
  • Places: https://www.routeyou.com/en/theme/view/26/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=22
• Spectacular / Architecture in Europe
  • Routes: https://www.routeyou.com/en/theme/view/18/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22
  • Places: https://www.routeyou.com/en/theme/view/18/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=22
• Peculiar / Architecture in Europe
  • Routes: https://www.routeyou.com/en/theme/view/18/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=19
  • Places: https://www.routeyou.com/en/theme/view/18/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=19
• Did you know-stories / cycling classics in Europe
  • Routes: https://www.routeyou.com/en/theme/view/22/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=23
  • Places: https://www.routeyou.com/en/theme/view/22/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=23
• Spectacular / geology in Europe
  • Routes: https://www.routeyou.com/en/theme/view/10/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22
  • Places: https://www.routeyou.com/en/theme/view/10/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=22
• Top things to do with a great story
  • Routes: https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=23
  • Places: https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=23
• Top things to do with a spectacular aspect
  • Routes: https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22
    • Top Motorbikeroutes which are spetacular:
      • https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22&route-type=45
    • Top Walks which are spetacular:https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22&route-type=2
    • Top Cycling routes which are spetacular:https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=22&route-type=1
  • Places: https://www.routeyou.com/en/theme/view/30/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=22
• Funny / history:
  • Routes: https://www.routeyou.com/en/theme/view/8/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=25
  • Places: https://www.routeyou.com/en/theme/view/8/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=25
• Funny places linked to geography:
  • Routes: https://www.routeyou.com/en/theme/view/12/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&routes=1&characteristic=25
  • Places: https://www.routeyou.com/en/theme/view/12/#min-lat=40&min-lon=1&max-lat=60&max-lon=9&pois=1&characteristic=25

URL to get an overview of routes or places linked to a keyword

The basic URL to search for routes including the keyword chocolate is

https://www.routeyou.com/route/search?q=chocolate

The basic URL to search for POIs including the keyword chocolate is

https://www.routeyou.com/poi/search?q=chocolate

So you can try any keyword you like. Popular keywords are

• https://www.routeyou.com/route/search?q=bloesem
• https://www.routeyou.com/route/search?q=hellingen
• https://www.routeyou.com/route/search?q=mooiste
• https://www.routeyou.com/route/search?q=vlonder

URL to follow an account

https://www.routeyou.com/user/login?utm_source=Notification&utm_medium=E-mail&utm_campaign=followSuggestedUsers_2023-06-12&r=%2Fnl-be%2Fuser%2Fview%2F173624%2Fwtc-flandria%23follow%3D1

URL to RoutePlanner with specific routing option and maplayer

Example:

• https://www.routeyou.com/nl-be/route/planner/0/wandelrouteplanner#routing=63&map-overlays=hikingNodes

map-overlays indicates the map overlay such as hikingNodes,... The options are:

• Walking
  • hikingNodes
  • grNetwork
• Cycling
  • cyclingNodes
  • cyclingNetwork
  • svMtbNetwork
• Heatmap
  • offroadGlobalHeatmap
  • walkGlobalHeatmap
  • raceGlobalHeatmap
  • bikeGlobalHeatmap
• Other
  • roadProperties
  • motorNetwork
  • equestrianNodes

URL for links to the app

• Deep links URL params documentation
  • Base URL
    • The base URL for searches is:
      • https://app.routeyou.com/search
    • Adding Parameters
      • ?parameter1=value1&parameter2=value2
    • Add parameters to the URL using the following format:
• Example:
• Map Bounds (b)
• Defines the initial map view.
• Format: b=neLat,neLng,swLat,swLng
• Example: b=51.0970,3.7860,51.0270,3.6770 (Shows Ghent, Belgium)
• Activity Type (t)
• Filters routes by activity type.
• Format: t=typeId
• Example: t=5 (5 represents recreational cycling)
• Distance Range (dmin, dmax)
• Sets the minimum and maximum route distances in meters. Can be used separately.
• Format: dmin=minDistance&dmax=maxDistance
• Example: dmin=5000&dmax=20000 (routes between 5km and 20km)
• Minimum Score (s)
• Filters routes by minimum rating score.
• Format: s=minScore
• Example: s=0.8 (routes with a score of 0.8 or higher)
• Characteristics (c)
• Filters routes by specific characteristics by passing the id.
• Format: c=id1,id2,id3
• Example: c=3,9,43 (routes with characteristic id’s 3, 9, and 43)
• 1 https://app.routeyou.com/search
• 1 ?parameter1=value1&parameter2=value2
• 1 https://app.routeyou.com/search?parameter1=value1&parameter2=value
• Keywords (k)
• Searches for routes containing specific keywords.
• Format: k=keyword1,keyword2
• Example: k=scenic,forest (routes tagged with "scenic" and "forest")
• Important: Keywords containing special characters or spaces must be URL encoded to ensure proper handling.
• Example with special characters:
• Original keywords: mountain biking, hills & valleys
• URL encoded: k=mountain%20biking,hills%20%26%20valleys
• To easily encode your keywords, you can use the URL Encoder tool. Simply type or paste your keywords, and it will generate the properly
• encoded version for you to use in the URL.
• My Routes (mr)
• Shows only routes created by the logged-in user.
• Format: mr=true
• Example: mr=true
• Bookmarked Routes (bm)
• Shows only routes bookmarked by the logged-in user.
• Format: bm=true
• Example: bm=true
• Creator (cr)
• Filters routes by a specific creator's ID.
• Format: cr=creatorId
• Example: cr=12345 (routes created by user with ID 12345
• Group (g)
• Filters routes associated with a specific group ID.
• Format: g=groupId
• Example: g= 456 (routes associated with group ID 456)
• Example URL
• 1 https://app.routeyou.com/search?
• b=51.0970,3.7860,51.0270,3.6770&t=5&dmin=5000&dmax=20000&s=0.8&c=3,9,43&k=scenic,forest&g=456

Back to RouteYou