scenic”的版本间的差异

来自Wiki
跳转至: 导航搜索
接口示例
 
第1行: 第1行:
 
{{car-sidebar}}
 
{{car-sidebar}}
==接口说明==
+
 
 +
== 接口说明 ==
 +
<span style="color:red;">&nbsp;&nbsp;&nbsp;&nbsp;车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。</span>
  
 
用户可根据景点名称(中文拼音)、POI ID查询景点详细信息。
 
用户可根据景点名称(中文拼音)、POI ID查询景点详细信息。
  
==接口示例==
+
== 接口示例 ==
  
   http://api.map.baidu.com/telematics/v3/travel_attractions?id=yiheyuan&ak=E4805d16520de693a3fe707cdc962045
+
   [http://api.map.baidu.com/telematics/v3/travel_attractions?id=yiheyuan&ak=E4805d16520de693a3fe707cdc962045 http://api.map.baidu.com/telematics/v3/travel_attractions?id=yiheyuan&ak=E4805d16520de693a3fe707cdc962045]
  
==接口参数说明==
+
== 接口参数说明 ==
  
 
{|
 
{|
!width="100"| 参数类型
 
!width="100"| 参数名称
 
!width="100"| 是否必须
 
!具体描述
 
 
|-
 
|-
|String
+
! width="100" | 参数类型
|ak
+
! width="100" | 参数名称
|true
+
! width="100" | 是否必须
|开发者密钥
+
! 具体描述
 
|-
 
|-
|String
+
| String
|sn
+
| ak
|false
+
| true
|若用户所用ak的校验方式为sn校验时该参数必须。 ([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法])
+
| 开发者密钥
 
|-
 
|-
|String
+
| String
|id
+
| sn
|true
+
| false
|输入景点名称(拼音)或景点uid。
+
| 若用户所用ak的校验方式为sn校验时该参数必须。 ([http://developer.baidu.com/map/index.php?title=lbscloud/api/appendix sn生成算法])
 +
|-
 +
| String
 +
| id
 +
| true
 +
| 输入景点名称(拼音)或景点uid。
 
uid 说明:指poi唯一id,可通过关键字检索或者周边检索获得poi和对应的id
 
uid 说明:指poi唯一id,可通过关键字检索或者周边检索获得poi和对应的id
 +
 
|-
 
|-
|String
+
| String
|output
+
| output
|false
+
| false
|输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
+
| 输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
 
|-
 
|-
|String
+
| String
|callback
+
| callback
|false
+
| false
|将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。
+
| 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。
 
|}
 
|}
  
==返回结果==
+
== 返回结果 ==
  
 
{|
 
{|
!width="200"| 参数名称
 
!width="200"| 含义
 
!说明
 
 
|-
 
|-
|status
+
! width="200" | 参数名称
|返回结果状态信息
+
! width="200" | 含义
|请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
+
! 说明
|-
+
|results
+
|返回结果
+
|
+
|-
+
|result.name
+
|景点名称
+
|
+
|-
+
|result.url
+
|详情页地址
+
|如http://lvyou.baidu.com/yiheyuan
+
 
|-
 
|-
|result.location
+
| status
|当前景点坐标(经纬度)
+
| 返回结果状态信息
|
+
| 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
 
|-
 
|-
|result.location.lng
+
| results
|经度
+
| 返回结果
|
+
|  
|-
+
|result.location.lat
+
|纬度
+
|
+
|-
+
|result.abstract
+
|景点印象摘要
+
|
+
|-
+
|result.description
+
|景点介绍
+
|
+
|-
+
|result.ticket_info.open_time
+
|景点开放时间
+
|如:旺季(4月1日~10月31日):06:30~20:00 停止售票时间:18:00
+
 
|-
 
|-
|result.ticket_info.attention
+
| result.name
|更多事项
+
| 景点名称
|
+
|
 +
|-
 +
| result.url
 +
| 详情页地址
 +
| 如http://lvyou.baidu.com/yiheyuan
 +
|-
 +
| result.location
 +
| 当前景点坐标(经纬度)
 +
|
 +
|-
 +
| result.location.lng
 +
| 经度
 +
|
 +
|-
 +
| result.location.lat
 +
| 纬度
 +
|
 +
|-
 +
| result.abstract
 +
| 景点印象摘要
 +
|
 +
|-
 +
| result.description
 +
| 景点介绍
 +
|
 +
|-
 +
| result.ticket_info.open_time
 +
| 景点开放时间
 +
| 如:旺季(4月1日~10月31日):06:30~20:00 停止售票时间:18:00
 +
|-
 +
| result.ticket_info.attention
 +
| 更多事项
 +
|  
 
|}
 
|}
  
==返回xml格式的数据==
+
== 返回xml格式的数据 ==
 
+
<pre><?xml version="1.0" encoding="utf-8"?>
<pre>
+
<?xml version="1.0" encoding="utf-8"?>
+
 
<telematics>
 
<telematics>
 
<error>0</error>
 
<error>0</error>
第128行: 第131行:
 
</pre>
 
</pre>
  
==返回json格式的数据==
+
== 返回json格式的数据 ==
 
+
<pre>{
<pre>
+
{
+
 
     "error": 0,
 
     "error": 0,
 
     "status": "Success",
 
     "status": "Success",

2020年1月14日 (二) 08:29的最后版本


接口说明

    车联网API服务的各种能力后续将合并到Web API服务中。自2015年12月31日起,车联网API服务将不再向新用户提供服务支持。已有用户服务暂不受影响,请已使用了各种车联网API服务的开发者,尽快升级服务到Web API中使用。

用户可根据景点名称(中文拼音)、POI ID查询景点详细信息。

接口示例

 http://api.map.baidu.com/telematics/v3/travel_attractions?id=yiheyuan&ak=E4805d16520de693a3fe707cdc962045

接口参数说明

参数类型 参数名称 是否必须 具体描述
String ak true 开发者密钥
String sn false 若用户所用ak的校验方式为sn校验时该参数必须。 (sn生成算法
String id true 输入景点名称(拼音)或景点uid。

uid 说明:指poi唯一id,可通过关键字检索或者周边检索获得poi和对应的id

String output false 输出的数据格式,默认为xml格式,当output设置为’json’时,输出的为json格式的数据。
String callback false 将json格式的返回值通过callback函数返回以实现jsonp功能。举例:callback=showLocation(JavaScript函数名)。

返回结果

参数名称 含义 说明
status 返回结果状态信息 请求状态,如果成功返回0,如果失败返回其他数字,详细见状态码附录。
results 返回结果
result.name 景点名称
result.url 详情页地址 如http://lvyou.baidu.com/yiheyuan
result.location 当前景点坐标(经纬度)
result.location.lng 经度
result.location.lat 纬度
result.abstract 景点印象摘要
result.description 景点介绍
result.ticket_info.open_time 景点开放时间 如:旺季(4月1日~10月31日):06:30~20:00 停止售票时间:18:00
result.ticket_info.attention 更多事项

返回xml格式的数据

<?xml version="1.0" encoding="utf-8"?>
<telematics>
<error>0</error>
<status>Success</status>
<date>2014-02-13</date>
<result>
<name>颐和园</name>
<location>
<lng>116.27068715319</lng>
<lat>39.993241267979</lat>
</location>
<telephone>010-62881144</telephone>
<star>5</star>
<url>http://lvyou.baidu.com/yiheyuan</url>
<abstract>我国现存规模最大、保存最完整的皇家园林,久负盛名。</abstract>
<description>颐和园位于北京西北郊海淀区内,距北京城区15公里,是我国现存规模最大,保存最完整的皇家园林之一,也是享誉世界的旅游胜地之一。颐和园是利用昆明湖、万寿山为基址,以杭州西湖风景为蓝本,汲取江南园林的某些设计手法和意境而建成的一座大型天然山水园,也是保存得最完整的一座皇家行宫御苑,被誉为皇家园林博物馆。颐和园景区规模宏大,园内建筑以佛香阁为中心,园中有景点建筑物百余座、大小院落20余处,3555古建筑,面积70000多平方米,共有亭、台、楼、阁、廊、榭等不同形式的建筑3000多间。古树名木1600余株。其中佛香阁、长廊、石舫、苏州街、十七孔桥、谐趣园、大戏台等都已成为家喻户晓的代表性建筑。</description>
<ticket_info>
<price>1. 旺季(4月1日~10月31日):30.00元德和园:5.00元佛香阁:10.00元苏州街:10.00元文昌院:20.00元联票(含门票、文昌院、德和园、佛香阁、苏州街澹宁堂):60.00元 2. 淡季(11月1日~3月31日):20.00元德和园:5.00元佛香阁:10.00元苏州街:10.00元文昌院:20.00元联票(含门票、文昌院、德和园、佛香阁、苏州街澹宁堂):50.00元</price>
<open_time>1. 旺季(4月1日~10月31日):06:30~20:00 停止售票时间:18:00 园中园(含文昌院、德和园、佛香阁、苏州街澹宁堂):08:30~17:00 2. 淡季(11月1日~3月31日):07:00~19:00 停止售票时间:17:00 园中园(含文昌院、德和园、佛香阁、苏州街澹宁堂):09:00~18:00</open_time>
<attention>
<item>
<name>【门票优惠政策】</name>
<description>1. 身高1.2米以下儿童免票。 2. 北京市65岁以上老年人凭老年证免票;外地70周岁以上(含70周岁)老年人凭有效证件,门票半价优惠。 3. 大、中、小学学生(不含成人教育学生)、外国留学生凭学生证,门票半价优惠。 4. 残疾人、离休干部、离休军人、现役军人、武警官兵、省、部级以上劳模凭有效证件免票。 5. 持有社会保障金领取证的人员凭有效证件,门票半价优惠。</description>
</item>
</attention>
</ticket_info>
</result>
</telematics>

返回json格式的数据

{
    "error": 0,
    "status": "Success",
    "date": "2014-02-13",
    "result": {
        "name": "颐和园",
        "location": {
            "lng": 116.27068715319,
            "lat": 39.993241267979
        },
        "telephone": "010-62881144",
        "star": "5",
        "url": "http://lvyou.baidu.com/yiheyuan",
        "abstract": "我国现存规模最大、保存最完整的皇家园林,久负盛名。",
        "description": "颐和园位于北京西北郊海淀区内,距北京城区15公里,是我国现存规模最大,保存最完整的皇家园林之一,也是享誉世界的旅游胜地之一。
颐和园是利用昆明湖、万寿山为基址,以杭州西湖风景为蓝本,汲取江南园林的某些设计手法和意境而建成的一座大型天然山水园,也是保存得最完整的一座皇家行宫御苑,被誉为皇家园林博物馆。
颐和园景区规模宏大,园内建筑以佛香阁为中心,园中有景点建筑物百余座、大小院落20余处,3555古建筑,面积70000多平方米,共有亭、台、楼、阁、廊、榭等不同形式的建筑3000多间。古树名木1600余株。其中佛香阁、长廊、石舫、苏州街、十七孔桥、谐趣园、大戏台等都已成为家喻户晓的代表性建筑。",
        "ticket_info": {
            "price": "1. 旺季(4月1日~10月31日):30.00元
德和园:5.00元
佛香阁:10.00元
苏州街:10.00元
文昌院:20.00元
联票(含门票、文昌院、德和园、佛香阁、苏州街澹宁堂):60.00元
2. 淡季(11月1日~3月31日):20.00元
德和园:5.00元
佛香阁:10.00元
苏州街:10.00元
文昌院:20.00元
联票(含门票、文昌院、德和园、佛香阁、苏州街澹宁堂):50.00元",
            "open_time": "1. 旺季(4月1日~10月31日):06:30~20:00\n停止售票时间:18:00\n园中园(含文昌院、德和园、佛香阁、苏州街澹宁堂):08:30~17:00\n2. 淡季(11月1日~3月31日):07:00~19:00\n停止售票时间:17:00\n园中园(含文昌院、德和园、佛香阁、苏州街澹宁堂):09:00~18:00",
            "attention": [
                {
                    "name": "【门票优惠政策】",
                    "description": "1. 身高1.2米以下儿童免票。
2. 北京市65岁以上老年人凭老年证免票;外地70周岁以上(含70周岁)老年人凭有效证件,门票半价优惠。
3. 大、中、小学学生(不含成人教育学生)、外国留学生凭学生证,门票半价优惠。
4. 残疾人、离休干部、离休军人、现役军人、武警官兵、省、部级以上劳模凭有效证件免票。
5. 持有社会保障金领取证的人员凭有效证件,门票半价优惠。"
                }
            ]
        }
    }
}