Panoramio API - Display photos from Panoramio on your own website

Using Panoramio API you can display the photos from Panoramio on your own web site. Geolocated photos from Panoramio are great to enrich your maps or illustrate information where location is a important factor (real estate sites, hotels and vacation sites, routes & trails...).

Example 1: Photos enriching a map

Photos provided by Panoramio. Photos are under the copyright of their owners.

Example 2: Photos illustrating an area

Hotel Acme - Miami Beach

Hotel Acme buildingA landmark building in the historic city centre, sophisticated in design, the hotel is walking distance of major tourist attractions, 192 techno savvy rooms, stylish restaurant & bar, hot spot rooftop bar & terrace and fitness centre.

Photos from the area around the hotel

Photos provided by Panoramio. Photos are under the copyright of their owners.

How does it work?

It's a very simple REST api, you only have to do a GET on:

http://www.panoramio.com/map/get_panoramas.php?order=popularity&set=public&from=0&to=20&minx=-180&miny=-90&maxx=180&maxy=90&size=medium

for "order" you can use:

for "set" you can use:

for "size" you can use:

the minx, miny, maxx, maxy define the area to show photos from (minimum longitude, latitude, maximum longitude and latitude, respectively).

You can define the number of photos to be displayed using "from=X" and "to=Y", where Y-X is the number of photos included. The value 0 represents the latest photo uploaded to Panoramio. For example, "from=0 to=20" will extract a set of the last 20 photos uploaded to Panoramio, "from=20 to=40" the previous set of 20 photos and so on. The maximum number of photos you can retrieve in one query is 100.

The result data is formatted using JSON. An example:


    {
      "count": 773840,"photos": [
        {
          "photo_id": 532693,
          "photo_title": "Wheatfield in afternoon light",
          "photo_url": "http://www.panoramio.com/photo/532693",
          "photo_file_url": "http://static2.bareka.com/photos/medium/532693.jpg",
          "longitude": 11.280727,
          "latitude": 59.643198,
          "width": 500,
          "height": 333,
          "upload_date": "22 January 2007",
          "owner_id": 39160,
          "owner_name": "Snemann",
          "owner_url": "http://www.panoramio.com/user/39160",
        },
        {
          "photo_id": 505229,
          "photo_title": "Etangs près de Dijon",
          "photo_url": "http://www.panoramio.com/photo/505229",
          "photo_file_url": "http://static2.bareka.com/photos/medium/505229.jpg",
          "longitude": 5.168552,
          "latitude": 47.312642,
          "width": 350,
          "height": 500,
          "upload_date": "20 January 2007",
          "owner_id": 78506,
          "owner_name": "Philippe Stoop",
          "owner_url": "http://www.panoramio.com/user/78506"
        }, ...
      ]
    }

"count" is the total number of photos available on that set of photos on that area. "photos" is an array with the requested photos. The variables of each "photo" object should be trivial to interpret, except maybe "owner_id". If the "owner_id" is 78506, then the user page of the guy that uploaded that photo will be http://www.panoramio.com/user/78506

It's also available as JSONP, just add an extra callback=your_function_name to the GET, and you will get:

your_function_name({ "count": 773840, "photos": [...] })

If you have any doubt about the code, don't hesitate to contact us at

Requirements

Every photo displayed in your site should include Panoramio's name and our logo. Each mini square-, square-, thumbnail- or small-size version of a photo must link to a medium or original sized version of the same photo. Each medium or original sized version must link to the photo page on the Panoramio.com domain (for example, http://www.panoramio.com/photo/532693). The link should be under the image itself. No more than 50 instances of photos can be displayed on one single webpage.

Additionally, every time a medium or original photo is used, you must also show the Panoramio logo directly under or directly next to the photo, as well as display "author: name", where "name" is linked to the author's Panoramio photos homepage (for example, http://www.panoramio.com/user/1429589). You must also display the text "Photos provided by Panoramio are under the copyright of their owners" under Panoramio photos. Please, check the Panoramio API - Terms of Use for detailed requirements and the examples at the top of this page.

Terms of Use

Panoramio API is free for both commercial and non-commercial purposes that don't exceed the restrictions. However Panoramio reserves the right to charge fees for the use of Panoramio API for some kind of commercial applications and over certain bandwidth limits. More information at Panoramio API - Terms of Use.

Questions

If you have any doubt of suggestions, feel free to contact us at

List of sites that use Panoramio API