Connect
 Login
|
|
YouSpots Map Embedment & API's
Pass it forward! We love action sports and we want to give something back, or rather pass it forward. You might already do so by building or distributing equipment, organizing events, managing a community page or generally supporting your local scene. Now you can give even more: our maps and spots within your own webpage or app, made possible through embedding our maps or using our data API's. Offer a free service, increase your site traffic and engagement from visitors and feel the love coming straight back to you. Lead the way with Youspots Embedded Maps and the YouSpots Api's! There are three different ways to embed our spots into your website.
Embedded Maps
Radius Api
Spot Detail Api
YouSpots Embedded Maps
Embed an interactive map of spots into your site using just a simple code.
What it does With YouSpots Embedded Maps you can display a fully interactive map of our spots in your website. It works just like embedding a YouTube video by simply copy-pasting a couple of lines of code. Your users won't have to leave your website to make use of all basic YouSpots functionality. You choose Choose your favourites from over 70 different sports. Display a map of your local neighbourhood or let your users explore the whole world of action sports. And when they click on a spot they will see all of the spot's available details and information, either on our dedicated spot detail pages or right below the map without leaving your website at all. These information may include a detailed description, video and pictures, difficulty level, elevation, traffic etc. Additional features While we made all the basic Youspots features available for free, for a small monthly fee you can adjust the map's style to fit your website's design and other premium features such as additional categories to display on your map (e.g. shop branches). To see the whole range of offers and our lucrative package deals, please ask us for details. Example LongboardCommunity.org is using YouSpots Embedded Maps Get started To embed a YouSpots map, please contact Enrico at ekoepke[at]youspots.com. YouSpots Embedded Maps documentation
Document updated on 20.04.2013
Embed object Resource URL http://api.youspots.com/ Usage You need to embed a code that in your webpage to embed a YouSpots map. Request variable _ysEmbed This JavaScript variable contains a JSON object that configure your map embedment. required Free api features
<div id='ysFrame'></div> <script>(function(){_ysEmbed={"apitype":"embed","version":"1","auth":"yourAuthKey","data":{"colorSceme":"ff8a00","fontColorSceme":"000000","mapStartLatLng":"51.2,13.4","mapType":"roadmap","detectUserLocation":"true","backgroundColor":"FFF", "showDetails":"true","mapZoomLevel":"3","sport":{"1":"longboard"},"marker":{"longboard":"http://longboardcommunity.org/youspots/lonboardmarker.png"}}};})();</script> <script type='text/javascript' src="http://youspots.com/embed.js"></script> Example "_ysEmbed" JavaScript variable { "apitype": "embed", "version": "1", "rtype": "json", "auth": "yourAutKey", "data": { "colorScheme": "ff8a00", "fontColorScheme": "000000", "mapStartLatLng": "51.2,13.4", "mapType": "terrain", "detectUserLocation": "true", "backgroundColor": "FFF", "showDetails": "true", "mapZoomLevel": "3", "sport": { "1": "longboard" }, "marker": { "longboard": "http://longboardcommunity.org/youspots/lonboardmarker.png" } } } Example Result See a example with all the functions enabled here: LongboardCommunity.org YouSpots Radius Api
Using YouSpots data to create your own app or webpage.
What it does The Radius Api lets you access our data pool in real time so that you can display our spots in your webpage or app. Without leaving your site or app, your users will be able to find all the spots that the YouSpots community has made publicly available. Our very own Apps is using the Radius Api to display all the information needed to find and describe great spots. Check our app here. YOU choose You choose which geographical area and radius you want to make available and what kind of sports to include. In terms of design, you may use the YouSpots style that you can see on our website (we use this Api ourselves) or choose any other format you deem fit. This way you are in total control of the user experience without having to spend years gathering data. Additional features The Radius Api is free under most circumstances but works best in combination with the Spot Detail Api because the former provides only an overview of where the spots are and which sports you can do there while the latter provides all the necessary information and full details on these spots (such as a detailed description, video and pictures, difficulty level, elevation, traffic etc). Example The YouSpots App is one example of using the Radius Api in conjunction with the Spot Detail Api. It is available for free here. Get started In order to recieve data from this api you need to obtain a developer key. To get your developer key, please contact Enrico at ekoepke[at]youspots.com. YouSpots Radius documentation
Document updated on 13.03.2013
Embed object Resource URL http://api.youspots.com/
http://api.youspots.com/?r={"apitype":"radius","version":"1","rtype":"json","auth":"your_auth_code","data":{"lat":"51.033897","lng":"13.77102","r":"4.40"}}
Example Result [ { "163": { "la": "51.065403", "ln": "13.772869", "sp": [ "Skate", "Mountain Bike", "Inline Skate", "Scooter", "Longboard" ], "ca": "Street" }, "228": { "la": "51.053291", "ln": "13.768829", "sp": [ "Skate", "Longboard" ], "ca": "Street" } } ] Result explination Hence the fact that we want to deliver our data as fast as possible, we minimzed the used KB size for every request. There for all the main keys are as short as possible. The main key (in this example it is "163" and "228", these are the spotid) la = latitute ln = longitute sp = sports ca = category YouSpots Spot Detail Api
Using YouSpots data to create your own app or webpageWhat it does The Spot Detail Api lets you access our data pool so that you can display most of our available spot information in your own webpage or app. These may include the specific route, a detailed description, videos and pictures, access information, difficulty level, elevation, traffic etc. Without leaving your website or app, your users will be able to access everything that the YouSpots community has made publicly available. YOU choose As developer you can choose exactly which pieces of information you would like to include. Please see the documentation below to see precisely what is possible. Additional features The Spot Detail Api has been incredibly time-consuming to develop and is pricey to maintain. Therefore we have to charge a small monthly fee for its use. Exceptions may apply when YouSpots may benefit from its use in other ways. Please contact Enrico at ekoepke[at]youspots.com to discuss. Example Our very own app uses the Spot Detail Api to display all information on our spots. It is available for free here. Get started To get your developer key, please contact Enrico at ekoepke[at]youspots.com. YouSpots Spot Detail documentation
Document updated on 13.03.2013
Embed object Resource URL http://api.youspots.com/
Example Api request
http://api.youspots.com/?r={"apitype":"spotdetail","auth":"your_auth_key","rtype":"json","version":"1","spotid":"2610","data":"spottitle,sport,town,country,length,steepness,typeofspot,surfaceCondition, difficulty,traffic,nightlights,desc,picture,video,coordinates,mapMode,user,likes","unitsystem":"metric"} Example Result { "spottitle": "Babisnau downhill bombing", "town": "01623 Ketzerbachtal", "distance": "2.207 (km) 1.371 (miles) Slope: Ø 4.63%", "desc": "this spot dont have a lot of traffic and is ment for medium or advanced riders, the part in the middle can be really fast... this road is in the middle of nowhere but still near dresdenadvanced riders can go up to 55 kmh and fasterplease respect the people that life there and care for their safety, show respect and good behavior.... cheers", "coordinates": "13.761950169311534,50.97442804479901 13.78851476739503,50.98366878051337", "travelMode": "driving", "country": "DE", "sport": "['Longboard','Freebord','Luge']", "ca": "Street", "likes": "4", "pictures": "http://youspots.com/images/uploadedfilesfortrack/248763233e2104577e9ab5e2559f21fe/image_share.jpg, http://youspots.com/images/uploadedfilesfortrack/5c1b175fc917c0e9dbe0e22559bf1290/IMAG0113.jpg, http://youspots.com/images/uploadedfilesfortrack/5c1b175fc917c0e9dbe0e22559bf1290/IMAG0117.jpg, http://youspots.com/images/uploadedfilesfortrack/5c1b175fc917c0e9dbe0e22559bf1290/IMAG0119.jpg, http://youspots.com/images/uploadedfilesfortrack/5c1b175fc917c0e9dbe0e22559bf1290/IMAG0120.jpg", "video": "null", "user": "admin" } |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
in Dresden, London, San Francisco, Vienna and Tösse - works best in google chrome!
