Add hyperlinks for API query examples (but without API key)

[nvkelso]

Currently the Mobility docs don't link out, and the are confusing with the API key (copy pasting them into the URL bar will generate a 429 error).

For example, this URL is written in text, but not hyper linked:

• http://valhalla.mapzen.com/route?json={%22locations%22:[{%22lat%22:42.358528,%22lon%22:-83.271400,%22street%22:%22Appleton%22},{%22lat%22:42.996613,%22lon%22:-78.749855,%22street%22:%22Ranch%20Trail%22}],%22costing%22:%22auto%22,%22costing_options%22:{%22auto%22:{%22country_crossing_penalty%22:2000.0}},%22directions_options%22:{%22units%22:%22miles%22},%22id%22:%22my_work_route%22}&api_key=mapzen-xxxxxx

because if you type it in to the address bar, it’ll 429

while Search would keep the link text with the API key, but change the hyperlink URL to:

• http://valhalla.mapzen.com/route?json={%22locations%22:[{%22lat%22:42.358528,%22lon%22:-83.271400,%22street%22:%22Appleton%22},{%22lat%22:42.996613,%22lon%22:-78.749855,%22street%22:%22Ranch%20Trail%22}],%22costing%22:%22auto%22,%22costing_options%22:{%22auto%22:{%22country_crossing_penalty%22:2000.0}},%22directions_options%22:{%22units%22:%22miles%22},%22id%22:%22my_work_route%22}

Example:

• https://mapzen.com/documentation/mobility/turn-by-turn/api-reference/#inputs-of-a-route
• https://mapzen.com/documentation/search/search/#search-the-world

[rmglennon]

From some testing with markdown and HTML tags, it works best with a format like this:

> [/route?json={"locations":[{"lat":40.749706,"lon":-73.991562,"type":"break","street":"Penn Plaza"},{"lat":40.73093,"lon":-73.991379,"type":"break","street":"Wanamaker Place"}],"costing":"multimodal","costing_options":{"transit":{"use_bus":"1.0","use_rail":"0.0","use_transfers":"0.3"},"pedestrian":{"walking_speed":"4.1"}}}&api_key=mapzen-xxxxxxx](https://valhalla.mapzen.com/route?json={"locations":[{"lat":40.749706,"lon":-73.991562,"type":"break","street":"Penn Plaza"},{"lat":40.73093,"lon":-73.991379,"type":"break","street":"Wanamaker Place"}],"costing":"multimodal","costing_options":{"transit":{"use_bus":"1.0","use_rail":"0.0","use_transfers":"0.3"},"pedestrian":{"walking_speed":"4.1"}}})

The base URL is stated earlier in the topic, so removing it from the link text that displays on the page. This matches the Search examples.

To do:

• [ ] https://github.com/valhalla/valhalla-docs/blob/master/elevation/elevation-service.md
• [ ] https://github.com/valhalla/valhalla-docs/blob/master/isochrone/api-reference.md
• [ ] https://github.com/valhalla/valhalla-docs/blob/master/matrix/api-reference.md
• [ ] https://github.com/valhalla/valhalla-docs/blob/master/optimized_route/api-reference.md
• [ ] https://github.com/valhalla/valhalla-docs/blob/master/api-reference.md (see #135)

[rmglennon]

As part of the requirement to use an API key with all requests, I have had to remove the URL to make these links just be code blocks (for now).

In the near-future, they will be updated to use the fancy API key switching we do for all documentation.