====== TrafficMap ======
V1.3 [[https://marketplace.secondlife.com/p/TrafficMap/25469833|Marketplace]]

**Typical use case**, you own a big public place and want to put up new things but don't know what to remove - what is few used.

TrafficMap monitors a sim or 1/4sim between two given altitudes and stores the data in a web database. You visualize the traffic on a map on the web. It uses a [[web Database]] to store data and draw the maps.

  * Traffic is obtained for each 4m x 4m land square 2m x 2m for 1/4sim
  * A background image of the sim can be provided
  * scripted agents (BOTs) are not counted
  * you can click or drag on map to get trafic details

**Demo** There is a demo version that works exactly the same but scrambles the dots on map

==== Setting up ====
Rez your TrafficMap anywhere on the sim and click on the colored side it for menu
  * Use **<<** and **>>** to see and change all the settings
    * **zone** part of sim to monitor. full, NE, NW, SE or SW
    * **zmin** the lower limit altitude to monitor
    * **zmax** the upper limit altitude to monitor
    * **timer** how often the sim is checked. 30sec or 60 or more
    * **info** a text that will appear on the map title
    * **image** a http link to an image you want as map background (optional)
      * this method rarely works for servers security reasons. Better just send me your image.
      * if you have prim media on the choosen background appears on top face
  * **turn on** to start monitoring.
  * **turn off** to stop. 
  * **map** to get your link to the map. 
  * **refresh** to update the beacons without stropping the monitoring. This will also update info and image.
  * **Clear Data** to delete all the recorded traffic. won't stop monitoring

If you changed a setting while monitoring is started you must turn off then on for new settings to be active. 
====Map==== 
**[[trafficmap map|Detailed help for web page]]**

The map is a webpage. It shows a dot for every 4x4 meters square. 2x2 for 1/4sim maps{{ :traficmap.jpg|}}\\ 
map script was designed and tested on Firefox, Edge, Chrome for Windows 11 and Mac and even on Android Browsers
  * dots are of 6 different colors for 6 traffic levels
  * you can show or hide beacons if you sat some
  * you can show or hide background if you sat one
  * click on the map will display sl coordinates and traffic in upper frame
  * drag an area on map displays sum of traffic inside that area. the area will be drown on the map

**Old maps** - where no traffic was recorded for a month - will be **deleted** from our database. Snapshot or save page if you want to keep traces

**Security** The TrafficMap object gives map URLs only to owner. There are two: **Map** URL to just this map, **SuperMap** URL to all your maps. If you give those URLs to someone they can see the map. Webmaster (me) can see all the maps but won't disclose any
====Beacons====
A beacon object is provided. rez some of them at special places and set a tag name in object's description. that tag will appear on the map.\\ 
When you refresh or turn on, beacons may take about 5 minutes to all appear on map\\ 
two beacons on same region can't have same name \\ 
the name of the beacon object has no importance, only the description. Keeping same name for all makes finding them easier\\ 
an alternative to using beacons is to write/draw directly on your background image

====Exceptions====
You can put UUIDs of avatars you don't want to count in traffic (you? your bots?) in the notecard Exceptions inside

====TrafficMap List====
This object gives you infos about all the TrafficMaps you own and links to map pages. \\ 
On the menu you also get a Superlink to all your maps\\ 
You can wear it or rez it. Only you can use it.

====TrafficMap Photo tool====
This tool helps you make an image of your sim.
  * Be yourself at the **zmin altitude** for your map and add the tool
  * **Click** on one of the 5 zone buttons 
    * 4 corner markers will be rezzed to help you locate edges of image to get
    * your camera will be placed correctly
    * take the photo to disk
  * **Click** on the tool's frame
    * your camera is released
    * the markers are deleted. they delete self after 10 minutes anyway
 
You then need to precisely crop you image and name it like your map title (region+info) and send it to me. I'll add it to my server. You don't have to put anything in the image parameter. Leave it to "no". In some cases I will tell you what to put in image after I uploaded it\\ 

Or you can place your image somewhere it can be viewed on the web. Then enter a full http link to it in the image setting. (https://mydomain.com/myimage.jpg) Depending of your hosting this might work or not.

**Trick:** Use [[https://gyazo.com|Gyazo]] to make the image. then on gyazo image, right-click on image to "open image in a new tab" You get only image.\\ copy the url (looks like https://i.gyazo.com/32a7951c47231643920587a3a82d0381.jpg) and set it in image setting. 

**Tech note** the image setting can contain:
  * a link to an image file, must start with https:
  * name of an image that exists in my server, like myimage.jpg
  * anything else, if an image "region info.jpg" (like the title of your map) exists in my server it will be used
  * if nothing works a "no background" image will show
  * The map has a B/W option that will only be available when using image in my server.