API Documentation

22 Sep 2010 by visitgreece

My Greece Media Content Access API (beta)

My-Greece is a website dedicated to you and your vision of Greece. Precious moments of your visit here captured by your camera will produce photos that will remain timeless reminders of our land long after your return home.

In the above context My-Greece provides a public access API for all

  • hoteliers
  • local and central authorities
  • tour Operators
  • travel professionals in general
  • mashup developers
  • destination management organization
  • and travelers
http://www.my-greece.gr/json/map

Data calls will have the following parameters

My-Greece API call parameters
1. json data is at 
json/map/terms/type/lat,lon

,where terms is term ids eg 6 or 6+7 for both
2. Terms attribute is optional, if you want to skip it use the abbreviation all 
json/map

or 

json/map/all/all/lat,lon
3. Type attributes are also optional. You may use either
image, video and tweet or the abbreviation all
if you need to 
json/map/all/image+video

or 

json/map/all/video+tweet
4. Using lat,lon is optional and refers to the center of the map
5. The json/map call returns sorted by thumbs up in descending order

Reference Taxonomy

We provide the reference tables for the taxonomy term ids.

id Term id Term
Where
28 River 8 Accommodation
7 Religion 6 Beach
5 Museum 29 Mountain
When
34 Morning 35 Afternoon
30 Autumn 31 Noon
12 Spring 11 Winter
10 Summer 33 Night
Who
15 Friends 14 Couple
13 Family
What
36 Panorama 25 Rafting
24 Bicycling 23 Trekking
22 Transport 21 Festival
20 Tours 19 Attractions
18 Accommodation 37 Sunset
27 Nightlife

Response Structure

Each API call response will constitute of the following json components:

  1. A node json array that holds all media items along with information about their type.
  2. A pager json object, that provides paging functionality to the response.
{
    -nodes [...]
    -pager: {
        -total: 1
        -current: 0
    }
}

The basic structure of the json node type is provided below.

Along with a sample response.

nodes [{
            -node: {
                + Title "Corfu, Heptanese - Northern Shores"
                + Latitude: "39.355538"
                + Lid: "76"
                + Longitude: "20.110474"
                + Nid: "78"
                + Name "Anonymous"
                + Path: "node/78/marker"
                + Type: "Video"
                + Youtube_thumb: http://img.youtube.com/vi/LAxL8wT1aTk/0.jpg
                + Video_Thumb: http://img.youtube.com/vi/LAxL8wT1aTk/0.jpg
            }
      },{
            -node: {
                + Title "Ioannina, Epirus - Vrosina village"
                + Latitude: "39.686053"
                + Lid: "77"
                + Longitude: "20.808105"
                + Nid: "79"
                + Name: "Anonymous"
                + Path: "node/79/marker"
                + Type: "Video"
                + Youtube_thumb: http://img.youtube.com/vi/kTErJVfswh0/0.jpg
                + Video_Thumb: http://img.youtube.com/vi/kTErJVfswh0/0.jpg
            }
      }]

Example calls

Furthermore, we provide you with some calls instances and their responses.

http://my-greece.gr/json/map/6

Returns matching term id 6, which is the term Beach (see ref. table), sorted by thumbs up user voting.

{"nodes":[
	nodes: [
      {node: {
                + Title: "Egina, Argosaronic Bay - Souvala"
                + Latitude: "37.749001"
                + Lid: "78"
                + Longitude: "23.458557"
                + Nid: "80"
                + Name: "Anonymous"
                + Path: "node/80/marker"
                + Type: "Video"
                + Youtube_thumb: http://img.youtube.com/vi/jN6oxHQttI8/0.jpg
                + Video_Thumb: http://img.youtube.com/vi/jN6oxHQttI8/0.jpg
            }
      },
       {node: {
                Title: "Samos, Aegean Sea - Boating along southern samos"
                Latitude: "37.701207"
                Lid: "81"
                Longitude: "26.926117"
                Nid: "83"
                Name: "Anonymous"
                Path: "node/83/marker"
                Type: "Video"
                Youtube_thumb: http://img.youtube.com/vi/r6qu6v2DRlY/0.jpg
                Video_Thumb: http://img.youtube.com/vi/r6qu6v2DRlY/0.jpg
            }
	],"pager":{
		"total":1,
		"current":0
	}
}

And a search with proximity to a specific point of the map.

http://my-greece.gr/json/map/all/all/29.333,23.333

Returns all media types sorted by proximity to 29.333, 23.333.

Embedding multimedia content from My Greece in your web page

My-Greece allows developers and site administrators to embed
assets in their own web site, communicating fasinating experiences to your visitors.
You can do so, through two different embeddable scripts:

Flag widget to indicate the number of published experience in My Greece.

Widget Flag Preview

<script type="text/javascript">
  drawFrame();
  function drawFrame(){
    document.write('<iframe width="174"
                height="115"
                scrolling="no"
                marginwidth="0" 
                marginheight="0"
                frameborder="0"
                src="http://my-greece.gr/en/counter/">
                </iframe>');
  }
 </script>

Content widget to embed experiences close to your region in your business or personal web site.

Widget full embed Preview

<script type="text/javascript">
  drawFrame();
  function drawFrame(){
    document.write('<iframe width="308"
                height="115"
                scrolling="no"
                marginwidth="0"
                marginheight="0"
                frameborder="0"
                src="http://my-greece.gr/en/node/294/embed">
                </iframe>');
  }
 </script>

Finally, do not forget to upload your photos and videos to My-Greece so that we may together create an exquisite mosaic of Greece!

My Greece Log