WIKI使用導(dǎo)航
站長百科導(dǎo)航
站長專題
- 網(wǎng)站推廣
- 網(wǎng)站程序
- 網(wǎng)站賺錢
- 虛擬主機
- cPanel
- 網(wǎng)址導(dǎo)航專題
- 云計算
- 微博營銷
- 虛擬主機管理系統(tǒng)
- 開放平臺
- WIKI程序與應(yīng)用
- 美國十大主機
預(yù)訂寶/getLandmarks
來自站長百科
getLandmarks概述[ ]
- 接口地址：http://api.yudingbao.net/v1.0/hotel/geospatials.ashx?act=getLandmarks
- 動作標識：getLandmarks
- 參數(shù)：見參數(shù)說明
- 請求方式：GET
- 響應(yīng)模式：JSON、JSONP、XML
注意：動作標識是大小寫敏感的，請養(yǎng)成良好的編碼習(xí)慣！
本接口涵蓋了本站收集的億萬級別的地標數(shù)據(jù)。
本接口僅支持簡單的查詢條件，不支持翻頁、排序等功能，提供本接口的目的是為了幫助本站非一站式代理實現(xiàn)地標搜酒店的功能。在查詢酒店時，需要提交地標名稱、經(jīng)度、緯度以及查詢半徑4個參數(shù)才能實現(xiàn)地圖搜索。本接口給出了相關(guān)的必要數(shù)據(jù)。
本接口的應(yīng)用應(yīng)當(dāng)以地標表單自動完成為主！
參數(shù)說明[ ]
| 參數(shù)名稱 | 參數(shù)類型 | 說明 |
|---|---|---|
| cityName | string | 必填。城市名稱。 |
| keyword | string | 必填。關(guān)鍵字，地標名的完整或部分名稱，至少需要輸入2個字符。如：天安門、中關(guān)。 |
| itemCount | int | 每次查詢返回地標的數(shù)量。默認為10。最大為20。 |
數(shù)據(jù)格式[ ]
- 響應(yīng)頭：
- Status：0為正常，非0表示處理請求時發(fā)生異常，通常是參數(shù)校驗錯誤；
- Messages：當(dāng)Status為非0時該字段肯定包含一條或多條消息文本；
- 響應(yīng)體：
- CityName：城市名稱；
- Keyword：關(guān)鍵字
- Landmarks：地標列表
item
- Name：地標名
- Lng：經(jīng)度
- Lat：緯度
對于數(shù)據(jù)格式的理解，請參考下列示例代碼中的XML響應(yīng)演示，其中每個字段都標注了數(shù)據(jù)類型（日期類型在XML響應(yīng)中統(tǒng)一使用GMT格式，但被標注為string，請開發(fā)者注意）。
示例代碼[ ]
以下示例代碼是通過HTML表單實現(xiàn)了該接口的部分操作，您在開發(fā)過程中應(yīng)當(dāng)使用自己的平臺語言來模擬這些操作以捕獲響應(yīng)體，然后對響應(yīng)體做出相應(yīng)的操作。
請求示例：
<!-- 這是該接口的請求示例，該接口的訪問類同于如下表單的提交， 請注意：該表單使用控件的方法模擬了GET請求 --> <form id="myForm" method="get" action="http://api.yudingbao.net/v1.0/hotel/geospatials.ashx"> <p> <!--動作標識，注意動作標識是大小寫敏感的--> <input id="act" name="act" value="getLandmarks" type="text" /> </p> <p> <input id="cityName" name="cityName" value="北京" type="text"> <input id="keyword" name="keyword" value="釣魚臺" type="text"> <input id="itemCount" name="itemCount" value="3" type="text"> </p> <p> <!--指定響應(yīng)格式為XML，這里以XML為例--> <input id="format" name="format" value="xml" type="text" /> <!--指定響應(yīng)體應(yīng)當(dāng)是已格式化的，便于閱讀代碼，在生產(chǎn)環(huán)境中應(yīng)當(dāng)將該值設(shè)置為false--> <input id="indent" name="indent" value="true" type="text" /> <!--產(chǎn)品編號。在我的賬戶-分銷產(chǎn)品的應(yīng)用列表中可以找到該參數(shù)的值。--> <input id="aid" name="aid" value="78663" type="text" /> <!--接口密鑰。在我的賬戶-分銷產(chǎn)品的應(yīng)用列表中可以找到該參數(shù)的值。--> <input id="key" name="key" value="0925ed633d24577eb3ffe13f00c55a4f9739f51a77eefb1dba29bb9568acddfd" type="text" /> <!--應(yīng)用程序授權(quán)編號及公鑰，這是可選的--> <input id="sid" name="sid" value="" type="text"> <input id="sKey" name="sKey" value="" type="text"> </p> <p> <input id="submit" name="submit" value="提交" type="submit"> </p> </form>
XML響應(yīng)：
<!--XML響應(yīng)--> <?xml version="1.0" encoding="utf-8"?> <HttpResponse> <Status type="number">0</Status> <Messages type="array"> </Messages> <ResponseBody type="object"> <CityName type="string">北京</CityName> <Keyword type="string">釣魚臺</Keyword> <Landmarks type="array"> <item type="object"> <Name type="string">北京釣魚臺國際旅行社</Name> <Lng type="number">116.4502408</Lng> <Lat type="number">39.9078289</Lat> </item> <item type="object"> <Name type="string">北京釣魚臺國際旅行社(東直門門市部)</Name> <Lng type="number">116.4138708</Lng> <Lat type="number">39.9405508</Lat> </item> <item type="object"> <Name type="string">釣魚臺</Name> <Lng type="number">116.334655</Lng> <Lat type="number">39.919021</Lat> </item> </Landmarks> </ResponseBody> </HttpResponse>
JSON響應(yīng)：
// Json響應(yīng)
{
"Status" : 0,
"Messages" : [],
"ResponseBody" : {
"CityName" : "北京",
"Keyword" : "釣魚臺",
"Landmarks" : [{
"Name" : "北京釣魚臺國際旅行社",
"Lng" : 116.4502408,
"Lat" : 39.9078289
}, {
"Name" : "北京釣魚臺國際旅行社(東直門門市部)",
"Lng" : 116.4138708,
"Lat" : 39.9405508
}, {
"Name" : "釣魚臺",
"Lng" : 116.334655,
"Lat" : 39.919021
}]
}
}
JSONP響應(yīng)：
// JsonP響應(yīng)
jsoncallback({
"Status" : 0,
"Messages" : [],
"ResponseBody" : {
"CityName" : "北京",
"Keyword" : "釣魚臺",
"Landmarks" : [{
"Name" : "北京釣魚臺國際旅行社",
"Lng" : 116.4502408,
"Lat" : 39.9078289
}, {
"Name" : "北京釣魚臺國際旅行社(東直門門市部)",
"Lng" : 116.4138708,
"Lat" : 39.9405508
}, {
"Name" : "釣魚臺",
"Lng" : 116.334655,
"Lat" : 39.919021
}]
}
});