Difference between revisions of "Deeplink"

From RouteXL
Jump to: navigation, search
m
m (URL format)
Line 5: Line 5:
 
To load addresses automatically, add addresses to the URL in this format:
 
To load addresses automatically, add addresses to the URL in this format:
  
   www.routexl.nl/?q=<address1>$<address2>$<address3>$<address4>
+
   www.routexl.com/?q=<address1>$<address2>$<address3>$<address4>
  
 
In other words, using the parameter '''q''' and seperating with a dollar sign. Addresses need to be urlencoded. A minimum of three adresses is required.
 
In other words, using the parameter '''q''' and seperating with a dollar sign. Addresses need to be urlencoded. A minimum of three adresses is required.
Line 13: Line 13:
 
To change the language of the website, add the parameter '''lang''':
 
To change the language of the website, add the parameter '''lang''':
  
   www.routexl.nl/?q=<address1>$<address2>$<address3>$<address4>&lang=en
+
   www.routexl.com/?q=<address1>$<address2>$<address3>$<address4>&lang=en
  
 
By default the deeplink will find a roundtrip. The first address is also the endpoint of the route. To have the route end at the last address, add the parameter '''roundtrip''' and set it to ''false''. When ending at the last address, a minimum of four addresses is required.
 
By default the deeplink will find a roundtrip. The first address is also the endpoint of the route. To have the route end at the last address, add the parameter '''roundtrip''' and set it to ''false''. When ending at the last address, a minimum of four addresses is required.
  
   www.routexl.nl/?q=<address1>$<address2>$<address3>$<address4>&roundtrip=false
+
   www.routexl.com/?q=<address1>$<address2>$<address3>$<address4>&roundtrip=false
  
 
=== Additional fields ===
 
=== Additional fields ===

Revision as of 07:50, 11 February 2020

Deeplinking is opening the website with addresses. This is the most easy way of connecting your system to our route planner. You add addresses to the URL, which are automatically recognized, imported to the map and optimized.

URL format

To load addresses automatically, add addresses to the URL in this format:

 www.routexl.com/?q=<address1>$<address2>$<address3>$<address4>

In other words, using the parameter q and seperating with a dollar sign. Addresses need to be urlencoded. A minimum of three adresses is required.

Optional parameters

To change the language of the website, add the parameter lang:

 www.routexl.com/?q=<address1>$<address2>$<address3>$<address4>&lang=en

By default the deeplink will find a roundtrip. The first address is also the endpoint of the route. To have the route end at the last address, add the parameter roundtrip and set it to false. When ending at the last address, a minimum of four addresses is required.

 www.routexl.com/?q=<address1>$<address2>$<address3>$<address4>&roundtrip=false

Additional fields

This is experimental, but you can add additional fields to each address. E.g. name of the stop, its servicetime, time slot and comments. To add these fields, use the same import formatting. Additional fields must be urlencoded with the address.

Example

https://www.routexl.com/?q=Jan%20Ligthartstraat%201%2C%20Alkmaar%24Markt%2011%2C%20Arnhem%24Martinikerkhof%2012%2C%20Groningen%24Snekertrekweg%201%2C%20Leeuwarden%24Westerbrink%201%2C%20Assen%24Luttenbergstraat%202%2C%20Zwolle%24Visarenddreef%201%2C%20Lelystad%24Pythagoraslaan%20101%2C%20Utrecht%24Houtplein%2033%2C%20Haarlem%24Zuid-Hollandplein%201%2C%20Den%20Haag%24Abdij%206%2C%20Middelburg%24Brabantlaan%201%2C%20Hertogenbosch%24Limburglaan%2010%2C%20Maastricht&lang=en

Coordinates can also be used, but the route optimization does not launch automatically:

https://www.routexl.com/?q=52.596433%2C4.708673%2452.375000%2C4.630823%2452.087104%2C4.317073%2451.500536%2C3.615379%2450.838986%2C5.702122%2451.678092%2C5.330025%2451.977267%2C5.909866%2452.509611%2C6.104196%2452.985670%2C6.538857%2453.219812%2C6.569814%2453.196178%2C5.786209%2452.506646%2C5.471510%2452.092421%2C5.149157%2452.596433%2C4.708673%24&lang=en