Embed API documentation

In addition of using the search page, you may also want to generate the embeddable Show the Way tap-to-navigate widget code programmatically.

Important! Include Show the Way JavaScript file

The following script tag should be placed at the end of each page that is going to display Show the Way widgets.

<script src="https://showtheway.io/w.js" async="async" type="text/javascript"></script>

It's perfectly okay to include the script at the end of every page, because it will be cached.

Show the Way widgets

If you would like to display Show the Way widget on a page, you will need to add a div with an anchor that correctly points to /to page.

<div class="showtheway">
    <a href="https://showtheway.io/to/{ll}?name={name}">Show the Way</a>
</div>
ll (required) GPS coordinates of the location, in WGS84 decimal degrees format.
Example: 48.85837,2.294481
name (optional) URL-encoded custom name for the location.
If empty, the default value is the formatted address of the location.
Example: Tour%20Eiffel
It is also recommended to set target="_blank" and title="Show the Way to {name} with your favorite navigation application" on the anchor/hyperlink.
You can see it action in the examples below.

Examples:

  1. Embed widget with only ll parameter
    <div class="showtheway">
        <a href="https://showtheway.io/to/48.85837,2.294481"
            target="_blank"
            title="Show the Way to 48.85837,2.294481 with your favorite navigation application">Show the Way</a>
    </div>
    Preview:

  2. Embed widget with ll and name parameters
    <div class="showtheway">
        <a href="https://showtheway.io/to/48.85837,2.294481?name=Tour%20Eiffel"
            target="_blank"
            title="Show the Way to Tour Eiffel with your favorite navigation application">Show the Way</a>
    </div>
    Preview:

Show the Way popup using existing link

If you would like to combine the power of Show the Way popup with your own link text, you just need to add showtheway-popup class and change the href attribute to point to /to page.

<a class="showtheway-popup"
    href="https://showtheway.io/to/{ll}?name={name}"
    target="_blank"
    title="Show the Way to {name} with your favorite navigation application">
    {your hyperlink content}
</a>

Other parts of Show the Way ecosystem


Share

Send location info URL on messaging platforms like SMS, instant messages, and emails.

Learn more API


Print

Print QR code out on printed media, from name cards, brochures, mails, banners, even billboards.

Learn more API