Contact | Affiliates | FAQ | Developers | About

News and Events

StreetFight - Hyperlocal industry news


PayPal-Standard-Logo

Rvolve for Developers

Rvolve is a hyper-local ads platform that lets advertisers pinpoint target their adverts to a local audience, and publishers of local content earn from locally relevant deals and services.

The service offers pay-for-performance, pay-per-click and pay per week/month options to advertisers directly, and publishers can choose to use the standard editable HTML ad blocks, or the XML/JSON feeds below.


The Rvolve XML Feed

The XML feed for Rvolve consists of a REST request which returns an XML set of advert results.

Example
http://rvolve.com/search.php?type=xml&lat=51.0034&lon=0.23443&units=mi&site=1&num_results=5&images=any

Where
type: should always be 'xml', or 'json' for JSON calls (see below)
lat: latitude in decimal degrees
lon: longitude in decimal degrees
units: can be 'km' or 'mi'. Usually you would test which country the request was coming from using an IP to coordinate database.
site: your Rvolve user id [Log in and go to 'Earn' to find this]
num_results: number of results. Default 2, minimum 1 and maximum 100.
images: can be 'any', 'landscape', 'portait', 'square' or 'none' to restrict the advert image layout.

Note: it is in your interest to attribute the results somewhere with a link mentioning Rvolve. Point it to the live 'infoLink', which is returned in the XML. This allows you to start earning as an affiliate of Rvolve, and earn an additional 7.5% for every advertiser and publisher signed up via your link (in addition to the publisher's 66%).

Rvolve inside the Layar Augmented Reality browser, see LightRod.org


The Rvolve JSON Feed

The JSON feed is useful for integration with online maps e.g. Google Maps from within Javascript: see this example.

It has the same parameters as the XML feed above and the same earning potential, but the type field should be set to 'json'.

Example: The following stand-alone HTML/Javascript code will display 5 adverts on an HTML page with coordinates alongside. To view the images (advert.image in this example), which are variable size, you might want to consider Zoompics below.

<html>
<head>
    <script type="text/javascript" 
        src="http://code.jquery.com/jquery-1.5.min.js"></script>
</head>
<body>
    <script>
         var getUrl = "http://rvolve.com/search.php?" + 
               "type=json&lat=51.0034&lon=0.23443&site=1&units=mi&num_results=5";
         
           jQuery.getJSON(getUrl+"&callback=?"function(data) {
              //Show the info link
              $('#result').html('<a href="' + data.returnLink + '">Rvolve Ads</a><br/><br/>');
             
             //Loop through each result and put an advert into 'result' tag        
              $.each(data.advert, function(i,advert){
                   $("<a href='" + advert.url + "' title='" +
                    advert.fullText + "'>" +
                    advert.text + "</a> " + advert.dist +
                    "&nbsp; Coords:" + advert.lat + "," + advert.lon +
                     "<br/>").appendTo("#result");
                  
            });
           });

    
    </script>

    <div id="result"></div>

</body>
</html>

Rvolve Zoompics

Search the Web for an image to try



Demos

Auto-zoom [Source Code]
Multiple images [Source Code]
Auto-pan [Source Code]
Auto-pan and auto-zoom [Source Code]

Static images scaled [Source Code]
Static image filling browser window [Source Code]
Clickable zoompic [Source Code]
Fancy borders [Source Code]



About

This picture zoomer can be added to your own site for free, and is open source, with the proviso that the 'Rvolve zoompic' logo remains in view. White-label Zoompics without a logo are available to license per image.

You can use the pics to display any .jpg, .gif or .png on your site at any scale. With the animations off (no logo is then required) it is an easy way to scale images dynamically when you're embedding them in your webpage.

Pure Javascript. Compatible with iPad, iPhone, Android, Firefox, IE 7+, Chrome, Safari





Using Zoompics in your project

Include the following script in the header:

<script src="http://rvolve.com/js/zoom-pic-intro-3.0.js" type="text/javascript"></script>

and then include a zoompic, or several zoompics anywhere on your page with e.g.

Copy the following HTML code into your page and adjust as necessary:

<!-- Put this script line in header if you can --><script src="http://rvolve.com/js/zoom-pic-intro-3.0.js" type="text/javascript"></script>

<!-- Include one div for each zoompic -->                        
<div id="my_zoom1" class="zoompic" data-src="http://rvolve.com/images/zoomdemo0.jpg" data-animate="true" data-width="400" data-height="250" data-zoomicon="true"></div>

Click for

Where:
id: required to be unique per image, but can be anything
class: required and must be 'zoompic'
data-src: the source of the .png, .jpg or .gif, just like an img src tag. This can be relative or absolute.
data-animate: switch this to false for a resized image only (white-label, as no logo shows)
data-width: the new width of the image, irrespective of the size of the source image
data-height: the new height of the image, irrespective of the size of the source image
data-border: css border tag e.g. 'solid 1px #DDDDDD'
data-autopan: automatically pan to show the complete image, true or false
data-autozoom: automatically zoom, true or false
data-maxzoom: maximum zoom factor (defaults to 3)
data-zoomicon: displays the +/- icon in the top left hand corner when set to true

Note: You can wrap the <div> with an <a href=""> </a> to provide a link.



Free Support

Want integration with your shopping cart? We offer free support to get the Zoompics integrated for commercial license holders.



Carousel

More details can be found here.



Spinner 360

More details can be found here.