How do I visualize my scan positions in a map?

When you activate the GPS tracking function of your QR Codes, people who scan your QR Codes are asked, if they want to submit their GPS position. If they allow their location being sent, we store a lng/lat value that you can use to render a scan location on a map. The following tutorial explains how you can use our QR Map widget to embed it in your website and show the scan locations of your users.

To embed a map on your website you require an active account, a valid API key and a Google Maps API key. Please set your Google Maps API key in user settings or in the branding section of your account that the map can be rendered.

Insert the following script with your subdomain and API key in your webpage. Caution: Use the API key of your account and NOT the Google Maps API key.

Place the <div> on your page, where the map should be displayed:

• lng / lat parameter will center the map on the given position
  
• zoom - Center the map at a given zoom level (min=1 | max=12)
• showlabels - If you set to 0, no label will be displayed on a pin when hovering.
• displayinfoonclick - If set to 0, no information is displayed when you click on the icon.

If you want to display where a single trackable QR Code with the activated GPS function has been scanned, just add the optional parameter id in the script URL and set the value to an id of one of your created QR Codes. The id of a QR Code is the shorted URL (e.g. 7W). Instead of showing your geo tagged QR Codes that are assigned to a fixed location, the scan locations of a single QR Code are shown on the map.

If you want to display more than one QR Code with GPS positions on the map just add multiple ids separated by a +

You can fine tune the statistics by adding a time range parameter:

• set a specific interval from - to date: e.g. &from=2024-02-24&to=2024-02-24
• or set a predefined range: today, yesterday, last7, last31 e.g. &range=today

You can limit the number of GPS scan positions displayed on the map by setting the limit parameter for each QR Code separated by a +.

If the limit is set to 1, the last scan of the QR Code will be displayed.

Instead of using the default QR Code Icons you may use a customized symbol/icon. Always set the absolute URL as the optional parameter icon

If you are displaying multiple QR Codes (=passing more than on id to the id Parameter) you can set a different icon for each QR Code by adding multiple icon URLs separated by a +

With the optional Parameter drawpath set to true, a path between the scanned positions of the QR Code will be drawn.

Open the error console from your browser. The console shows more information about the error.

If the map is not displayed on your website this might occurs because Goolge wants an API Key. Please make sure first that you have implemented the widget like described above.

GPS position is only shown on the map when the user has approved being geolocated or the position is retrieved through IP and the IP Anonymization is anything else than “Do not store unique visitors at all”.

See the TagMap Widget in action showing scan positions of QR Code submitted via GPS.