全国景点查询接口 官方自营 免费使用

 

全国景点查询接口(来自同程网的合作数据),根据省、市、县名称及景点名称查询景点信息,包括坐标、地址、描述、图片列表、门票价信息。

浏览量: 260931

调用量: 1610519

使用人数: 36836

¥ 0.00 元起

接入点说明:
相关文档:
接口地址: http://route.showapi.com/268-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_sign_method String md5 签名生成方式,其值可选为"md5"或"hmac"。如果不传入则默认"md5"。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数): 展开收起
参数名称 类型 默认值 示例值 必须 描述
keyword String
泰山
景点名称的汉字。
proId String
省级id
cityId String
城市id
areaId String
镇id
page String 1
第几页
...

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
pagebean SpotPageBean
分页数据
- allNum String
51
总数量
- allPages String
3
总页数,每页20条
- contentlist Spot[]
页面内数据列表
-- proId String
省级id
-- proName String
省级名称
-- cityId String
城市id
-- cityName String
城市名
-- areaId String
镇id
-- areaName String
镇名称
-- name String
景点名称
-- address String
景点地址
-- location String
坐标
-- summary String
景点描述
-- price String
最低门票价
-- picList Picture[]
图片列表
-- priceList Price[]
门票价格列表
- currentPage String
1
当前页
- maxResult String
20
每页最大条目数
ret_code String
0
0为成功,其他失败
...

返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"pagebean": {
			"allNum": 32,
			"allPages": 2,
			"contentlist": [
				{
					"address": "颜山公园路4号原山国家森林公园",
					"areaId": "3940",
					"areaName": "临淄区",
					"cityId": "299",
					"cityName": "淄博",
					"id": "7472",
					"location": {
						"lat": "36.49018821",
						"lon": "117.84976357"
					},
					"name": "原山泰山行宫",
					"picList": [
						{
							"picUrl": "http://pic3.40017.cn/scenery/destination/2015/04/16/09/33K4AW.jpg",
							"picUrlSmall": "http://pic3.40017.cn/scenery/destination/2015/04/16/09/33K4AW_130x130_00.jpg"
						},
						{
							"picUrl": "http://pic3.40017.cn/scenery/destination/2015/04/16/09/slKVTv.jpg",
							"picUrlSmall": "http://pic3.40017.cn/scenery/destination/2015/04/16/09/slKVTv_130x130_00.jpg"
						}
					],
					"priceList": [],
					"proId": "22",
					"proName": "山东",
					"summary": "原山泰山行宫位于博山城区西南的凤凰山巅,为市级重点文物保护单位。行宫始建于1602年(明万历三十年),历经几度劫难,清代、民国曾多次重修。现存建筑和布局均系明、清风格。现为颜山公园名胜之一。"
				} 
			],
			"currentPage": 1,
			"maxResult": 20
		},
		"ret_code": 0
	}
}