DPOI
콘텐츠를 생성하거나 수정을 위한 API이다.
HTTP Method : POST(create)/PUT(update)
URI : /dpoi
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"] |
Status |
Description |
OK |
view 페이지로 redirect |
ERROR |
error message return |
콘텐츠를 조회하기 위한 방법으로 동일한 uri-template을 가진다.
HTTP Method : GET
URI : /dpoi/:contentid
parameter 없음
* 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> |
HTTP Method : DELETE
URI : /dpoi/:contentid
parameter 없음
Status |
Description |
OK |
view 페이지로 redirect |
ERROR |
error message return |
HTTP Method : GET
URI : /dpoi
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 |
* 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
]
}
}
]
}
] |
|