概述
API授權
登入API
日記API
相簿API
相片API
地標API
地標API(new)
取得某分類/縣市/鄉鎮市區地標列表
  • REST Method: GET
  • 使用者是否需要先登入:否
  • Request參數
    • func=getCategoryPOIList_w
    • category-(optional), -enum('美食餐廳','住宿旅店','自然美景','人文風情','特色地標','娛樂休閒','好康優惠','其它')
      地標分類。
    • county-(optional)
      地標所在縣市。
    • district-(optional)
      地標所在鄉鎮市區。(參見列表)
    • order-(optional), -enum('score','time'), -default='score'
      地標排列依據
      • score: 依推薦分數由高至低
      • time: 依發表時間由新至舊
  • 回傳資料(若成功)
    • status=SUCCESS
    • POIList- array of POI
      該分類之地標列表。
      • POI
        • POIID
          地標編號。
        • name
          地標名稱。
        • score
          地標推薦分數。
        • address
          • county
            縣市
          • district
            鄉鎮市區
          • address2
            地址
回傳資料(若成功)範例: <?xml version="1.0" encoding="UTF-8"?> <response> <status>SUCCESS</status> <POIList> <POI1> <POIID>c105</POIID> <name>【高雄】老李排骨酥湯</name> <score>33215</score> <address> <county>高雄市</county> <district>新興區</district> <address2>大同一路149號</address2> </address> </POI1> <POI2> <POIID>c58</POIID> <name>1421行動商貿~大陸招商會</name> <score>27535</score> <address> <county>台北市</county> <district /> <address2>南京東路三段130號6樓</address2> </address> </POI2> </POIList> </response>
讀取地標
  • REST Method: GET
  • 使用者是否需要先登入:否
  • Request參數
    • func=getPOI_w
    • POIID
      要讀取的地標編號。
  • 回傳資料(若成功)
    • status=SUCCESS
    • name
      地標名稱。
    • category - array of enum('美食餐廳','住宿旅店','自然美景','人文風情','特色地標','娛樂休閒','好康優惠','其它')
      地標分類(至少一類,至多三類)。
    • description
      地標描述。
    • coupondescription (僅"好康優惠"分類有此欄位)
      好康優惠內容描述及使用期限。
    • address
      • county
        縣市
      • district
        鄉鎮市區
      • address2
        地址
    • Location
      • lat
        地標所在緯度。
      • lng
        地標所在經度。
    • ownerName
      地標擁有者暱稱。
    • ownerIcon
      地標擁有者頭像圖片位址。
    • updateDate
      最近更新時間。
      • year
      • month
      • day
    • score
      地標推薦分數。
    • photos-(optional), array of photo
      地標內含相片列表。
      • photo
        • photo
          相片位址(最大420x315)。
        • thumbnail
          相片縮圖位址(最大140x105)。
        • description
          相片描述。
    • comments-(optional), array of comment
      回應列表。
      • comment
        • time
          回應時間。
        • commenterName
          回應者暱稱。
        • commenterIcon
          回應者頭像位址。
        • comment
          回應內容。
        • authorReply
          地標發表者的回覆
          • time
            回覆時間。
          • reply
            回覆內容。
  • 回傳資料(若失敗)
    • status=FAILED
    • info
HTTP Protocol範例: GET /API.php HTTP/1.1 Accept: */* Content-Type: application/x-www-form-urlencoded User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.0; zh-TW; rv:1.8.1.14) Gecko/20080404 Firefox/2.0.0.14 Host: www.atlaspost.com Content-Length: 128 func=getPOI&POIID=72&key=77c34bb5f07dd3c4fb5d70030e4c4878&ts=1208853297&sig=af8d6ad939bbf6d44a69f702934e6e17&responseFormat=XML 回傳資料(若成功)範例: <?xml version="1.0" encoding="UTF-8"?> <response> <status>SUCCESS</status> <name>南園 @ 新竹新埔</name> <category> <c1>美食餐廳</c1> <c2>自然美景</c2> <c3>人文風情</c3> </category> <description></description> <address> <county>新竹縣</county> <district>新埔鎮</district> <address2>九芎湖 32 號</address2> </address> <Location> <lat>24.8367</lat> <lng>121.088</lng> </Location> <ownerName>VQueen</ownerName> <ownerIcon>userimages/24911_thumbnail_bbc09.jpg</ownerIcon> <updateDate> <year>2008</year> <month>07</month> <day>16</day> </updateDate> <score>2</score> <photos> <photo1> <photoPath>http://www.atlaspost.com/POIimages/24911/2444_normal_f8597.jpg</photoPath> <description>南園本來是可供聯合報系員工休閒的地方,後來才開放一般民眾入園。</description> </photo1> <photo2> <photoPath>http://www.atlaspost.com/POIimages/24911/2444_normal_b5dbd.jpg</photoPath> <description>這裡除了山水和建築之外,還有很大片的草地,聽說許多人就自備餐點,在樹下野餐,別有一番風味。</description> </photo2> <photo3> <photoPath>http://www.atlaspost.com/POIimages/24911/2444_normal_8a385.jpg</photoPath> <description>這裡的餐點很精緻可口。並且提供擂茶體驗,有附超超超好吃的客家麻糬喔!</description> </photo3> <photo4> <photoPath>http://www.atlaspost.com/POIimages/24911/2444_normal_909ee.jpg</photoPath> <description>園內多是中國式建築,建材都很講究。</description> </photo4> </photos> <comments> <comment1> <time>1216650850</time> <commenterName>福州女孩</commenterName> <commenterIcon>userimages/80178_thumbnail_47020.jpg</commenterIcon> <comment>好棒喔~幫你+++</comment> <authorReply> <time>1216650874</time> <reply>thank you</reply> </authorReply> </comment1> <comment2> <time>1216285524</time> <commenterName>怡伶.佩琪</commenterName> <commenterIcon>userimages/31766_thumbnail_2bf58.jpg</commenterIcon> <comment>╰○︿′ &lt;br /&gt;‵︿) 凡走過必留下痕跡~我大力的踩 &lt;br /&gt;〈 &lt;br /&gt;&lt;br /&gt;    O ooo? &lt;br /&gt;    (   )  &lt;br /&gt;?ooo O  )  / &lt;br /&gt;(   )  (__/ OH MY GOY 太大力嚕? &lt;br /&gt; \ (   &lt;br /&gt;  \__) &lt;br /&gt;&lt;br /&gt;ㄧ○︿ &lt;br /&gt;  \   ....快閃!! &lt;br /&gt;  √ ﹀ &lt;br /&gt;&lt;br /&gt;我也來你家囉^^ &lt;br /&gt;&lt;br /&gt;</comment> <authorReply> <time>1216286050</time> <reply>thank you</reply> </authorReply> </comment2> </comments> </response>

版權所有 © 2008 渥奇數位資訊 | 法律顧問: 益思科技法律事務所