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

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.

Brickell Bay Dr, 23. Miami Beach

Photos from the area around the hotel

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

How it works?

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 availables 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 or our logo. A link to the photo page (ex. http://www.panoramio.com/photo/532693) at Panoramio.com is also a requirement. Under the photo should be displayed "author: name" where the name is the author linked to his area at Panoramio (e.g. author: Eduardo Manchon). Also in every page you display photos from Panoramio you need to include the text "Photos provided by Panoramio are under the copyright of their owners."

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