DPOI
  • Create/Update Content
콘텐츠를 생성하거나 수정을 위한 API이다.

HTTP Method : POST(create)/PUT(update)
URI : /dpoi
    • Request
 Parameters  Description  Example
 name  이름  경복궁
 desc  설명  경복궁(景福宮)은 대한민국 서울 세종로에 있는 조선 왕조의 법궁(法宮, 정궁)이다.
location  대표 지점  {"type":"Point","coordinates":
 [126.97697304473937,37.57853973549271]}
 region  POI 영역  {"type":"Polygon","coordinates": [[126.97379730926367,37.58326714052456],[126.97388313995633,37.579713112229854]]}
 LOD  delegate  현재 POI를 확장한 서버 주소  ["http://www.tourcloud.org/dpoi"]
 geospatial  spatial LOD level  13.803278987499652
 address  country  국가명  대한민국
 region  시도명  서울특별시
 locality  시군구명  종로구
 street  읍면동 or 도로명+번지  사직로 161
 extended  상세주소  강마을 삼성 아파트 101동
 zipcode  우편번호  110-820
 category  lev1  대분류  A02
 lev2  중분류  A0201
 lev3  소분류  A02010100
 photo  POI를 대표하는 사진 URI  http://www.tourcloud.org/media
/85c29b53-1638-43e0-8805-df2761b19afa
 audio  POI를 대표하는 audio URI  http://www.tourcloud.org/media
/85c29b53-1638-43e0-8805-df2761b19afa
 tags  POI와 연관된 tags  ["고궁", "경복궁", "조선"]
 sameas  다른 사이트에도 존재하는 동일 POI  ["http://ko.wikipedia.org/wiki/경복궁", "http://wingbus.naver.com/spotDetail.nhn?spotId=KRSEL0018"]

    • Response
 Status  Description
 OK  view 페이지로 redirect
 ERROR  error message return

  • Retrieve Content
콘텐츠를 조회하기 위한 방법으로 동일한 uri-template을 가진다.

HTTP Method : GET 
URI : /dpoi/:contentid
    • Request
parameter 없음
    • Response
* Accept : text/html

<!DOCTYPE html>
<html>
  <head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="/stylesheets/view.css">
  </head>
  <body>
    <div class="h-dpoi">
      <div id="mainHeader" class="page-header">
         <h2>
           <span class="p-name">경복궁</span>
         </h2>
      </div>
      <span class="u-url">http://www.tourcloud.org/dpoi/5f217705-ca9b-4137-bdba-7bb43f581b12</span>
      <span id="address" class="h-adr">
        <span id="zipcode" class="p-postal-code">110-820,</span>
          <span id="country" class="p-country-name">대한민국</span>
          <span id="region" class="p-region">서울특별시</span>
          <span id="locality" class="p-locality">종로구</span>
          <span id="street" class="p-street-address">사직로 161</span>
          <span id="extended" class="p-extended-address"></span>
          <span id="geo" class="h-geo"><span id="latitude" class="p-latitude">37.579738620214,</span>
          <span id="longitude" class="p-longitude">126.97682471845</span>
          <span id="fence" class="p-fence">
{"coordinates":[[[126.97386355969999,37.58344568770901],[126.97424979780001,37.57596334343799],[126.97931380842002,37.57592933106499],[126.98004336927,37.581269083295],[126.98012919996,37.582799514915976],[126.97922797772999,37.58344568770901],[126.97678180311001,37.583819785184005],[126.97386355969999,37.58344568770901]]],"type":"Polygon"}   
          </span>
      </span><br />
      <span id="desc" class="p-label"><p>경복궁(景福宮)은 대한민국 서울 세종로에 있는 조선 왕조의 법궁(法宮, 정궁)이다.</p>
      </span>
     </span>
    </div>
  </body>
</html>

* Accept : application/json

{
   "__v":0,
   "_id":"52156bfd02f5f17b14000001",
   "alias":[
      ""
   ],
   "desc":"<p>경복궁(景福宮)은 대한민국 서울 세종로에 있는 조선 왕조의 법궁(法宮, 정궁)이다.</p>",
   "name":"경복궁",
   "uuid":"5f217705-ca9b-4137-bdba-7bb43f581b12",
   "revision":1,
   "changed":"2013-08-22T01:40:13.000Z",
   "created":"2013-08-22T01:40:13.000Z",
   "access":"Public",
   "sameas":[
      ""
   ],
   "tags":[

   ],
   "address":{
      "country":"대한민국",
      "region":"서울특별시",
      "locality":"종로구",
      "street":"사직로 161 ",
      "extended":"",
      "zipcode":"110-820"
   },
   "lod":{
      "geospatial":13.822922549342222,
      "delegate":[
         "http://www.tourcloud.org"
      ],
      "children":[

      ]
   },
   "region":{
      "type":"Polygon",
      "coordinates":[
         [
            [
               126.97386355969999,
               37.58344568770901
            ],
            [
               126.97424979780001,
               37.57596334343799
            ],
            [
               126.97931380842002,
               37.57592933106499
            ],
            [
               126.97678180311001,
               37.583819785184005
            ]
         ]
      ]
   },
   "location":{
      "type":"Point",
      "coordinates":[
         126.97682471845,
         37.579738620214
      ]
   }
}

* Accept : application/vnd.google-earth.kml+xml
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
   <Placemark id="5f217705-ca9b-4137-bdba-7bb43f581b12">
      <name>경복궁</name>
      <desc><![CDATA[<p>경복궁(景福宮)은 대한민국 서울 세종로에 있는 조선 왕조의 법궁(法宮, 정궁)이다.</p>]]></desc>
      <address>110-820,대한민국 서울특별시 종로구 사직로 161</address>
      <Point>126.97682471845,37.579738620214,0</Point>
   </Placemark>
</kml>

  • Delete Content
HTTP Method : DELETE
URI : /dpoi/:contentid
      • Request
    parameter 없음
      • Reponse
     Status  Description
     OK  view 페이지로 redirect
     ERROR  error message return

    • Search Content
    HTTP Method : GET 
    URI : /dpoi
      • Request
     Parameters  Description  Example
     region  POI가 포함되는 영역(location 과 exclusive)  {"type": "Polygon","coordinates": [[126.97379730926367,37.58326714052456],[126.97388313995633,37.579713112229854]]}
     location  사용자가 지정하는 한 점(region과 exclusive)  {"type": "Point","coordinates": [126.97697304473937,37.57853973549271]}
     spatialop  region or location 에 대한 spatial operator  geoWithin
     spatialtarget  spatial operator 를 적용할 대상  region
     keyword  content 제목 중 keyword 를 포함  경복궁
     lod.server  true인 경우 하위 lod server까지 검색  true
     limit  한번에 paging 할 최대 record 갯수  12
     start  paging start index  1
      • Response
    * Accept : application/json
    [{
          "source":"www.tourcloud.org",
          "contenttype":"dpoi",
          "doc":[
             {
                "uuid":"585dc76d-00bd-4a78-a344-f61ef454b392",
                "name":"세종문화회관",
                "desc":"세종문화회관(世宗文化會館, Sejong Center for the Performing Arts)은 서울특별시 종로구
                       세종대로 175 (세종로 81-3)에 위치한 53,202m²크기의 종합예술시설이다",
                "_id":"52156eaec20d7f9614000001",
                "alias":[
                ],
                "__v":0,
                "revision":1,
                "changed":"2013-08-22T01:51:42.000Z",
                "created":"2013-08-22T01:51:42.000Z",
                "access":"Public",
                "sameas":[
                ],
                "tags":[
                ],
                "lod":{
                   "geospatial":15.155041443423,
                   "delegate":[
                   ],
                   "children":[
                   ]
                },
                "region":{
                   "type":"Polygon",
                   "coordinates":[
                      [
                         [
                            126.97494717214,
                            37.572919174575
                         ],
                         [
                            126.97633119199,
                            37.571677662165
                         ],
                         [
                            126.97494717214,
                            37.572919174575
                         ]
                      ]
                   ]
                },
                "location":{
                   "type":"Point",
                   "coordinates":[
                      126.9757089195,
                      37.572528015364
                   ]
                }
             }
          ]
       }
    ]