携程获取景点详情 API 返回值说明

简介: 随着旅游业的不断发展,在线旅游服务平台如携程提供了丰富的API接口,以方便开发者获取各类旅游信息。其中,获取景点详情的API是非常实用的一个功能,它能够为用户提供详尽的景点信息。本文将详细阐述通过携程获取景点详情API返回的数据字段及其含义。


1. 景点名称(name)

此字段返回的是景点的官方名称,它是对用户展示的最直接信息,通常用于列表页或搜索结果中。

2. 景点地址(address)

这一字段提供了景点的具体位置信息,包括省、市、区以及具体的街道或乡村等级别,有助于用户规划行程。

3. 景点介绍(introduction)

这部分内容是关于景点的简介,可能包括历史背景、文化价值、特色亮点等信息,帮助用户了解景点的重要性和特色。

4. 开放时间(opening_hours)

这个字段说明了景点的开放时间,通常会区分工作日和节假日,甚至特殊日期的开放时间,这对于用户安排访问计划至关重要。

5. 门票价格(ticket_prices)

门票价格字段会列出不同类型门票的价格,比如成人票、儿童票、学生票等,有时还会包括优惠信息或电子票务相关的说明。

6. 交通指南(transportation)

交通指南为用户提供了到达景点的不同交通方式,包括公共交通(地铁、公交、火车等)和自驾路线,以及从主要地点出发的大致时间和距离。

7. 周边设施(nearby_facilities)

周边设施字段介绍了景点附近的其他服务设施,例如餐饮、住宿、购物等,这可以帮助用户了解景区的综合服务能力。

8. 注意事项(notes)

注意事项一般包含游客在参观时需要遵守的规则,如安全须知、禁止携带的物品、最佳游览路线建议等,确保游客的参观体验和安全。

9. 图片列表(image_list)

图片列表为用户展示了景点的实景照片,这些图片可能包括景区的外观、内部景观、特色活动等,极大地丰富了用户的视觉体验。

综上所述,携程的景点详情API返回值覆盖了用户在规划旅行时所需的大部分信息。通过这些详细的数据字段,用户可以快速地了解目的地情况,进而做出更加合理的行程安排。开发者在接入此类API时,应确保能够正确解析并展示这些信息,以提供给用户最佳的服务体验。

二、API介绍

前往测试

名称

类型

必须

描述

key

String

调用key(必须以GET方式拼接在URL中)

secret

String

调用密钥

api_name

String

API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]

cache

String

[yes,no]默认yes,将调用缓存的数据,速度比较快

result_type

String

[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读

lang

String

[cn,en,ru]翻译语言,默认cn简体中文

version

String

API版本

请求参数

请求参数:num_iid=138153

参数说明:num_iid:景点id,

响应参数

Version: Date:2024-01-21

名称

类型

必须

示例值

描述

item

item[]

0


携程旅行景点详情数据

address

Str

0


景点地址

area_id

Str

0


区域ID

desc

Str

0


景点描述

desc_img

Str

0


图片描述

detail_url

Str

0


详细地址

hot

Str

0


景点热度

item_imgs

Str

0


景点主图列表

level

Str

0


景区等级

open_time

Str

0


景点开放时间

poiid

Str

0


获取评论ID

ranking

Str

0


景点排名

reviews_num

Int

0


评论总数

score

Int

0


景点评分

service

Str

0


服务政策

telephone

Str

0


景点电话

tips

Str

0


提示信息

title

Str

0


景点标题

upgrade

Str

0


优待政策

请求示例

-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/xiecheng/item_get_scenic/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=138153"

响应示例

{
    "item":{
        "address":"新余市渝水区西南郊16公里处仙女湖风景区",
        "area_id":"xinyu878",
        "desc":"仙女湖景区位于江西省新余市西南郊16公里处,以“情爱圣地、群岛峡谷曲水、水下千年古城、亚热带植物基因库”四绝著称。景区面积198平方公里,其中水域面积50平方公里,由舞龙湖景区、钟山峡景区和钤阳湖景区三部分组成,穿插交错着99座岛屿星罗棋布,60多条湖湾扑朔迷离。舞龙湖景区作为仙女湖景区的主景区,涵盖龙凤苑、民俗风情园、爱情岛、龙王岛、圣集寺、名人岛、桃花岛等景点。走进仙女湖,你会惊叹:此景只应天上有,人间难得几处觅!仙女湖,感觉永如初心相见,成就了一段人仙相恋的千年传奇。东晋文学家干宝所著古籍《搜神记》里,毛衣仙女在此下凡,演绎出毛衣女与檀郎的爱情故事。这里,也因此成为了人间的情爱圣地,情山爱水向你诉说别离苦、相见欢。仙女湖因此也成为了“中国七仙女传说之乡”和 “中国七夕情人节”的发祥地。一、玩在仙女湖七夕老街七夕老街位于仙女湖码头片区中心地带,整个街区从整体布局到具体的景观、建筑、交通组织、产业落位都体现着创新的思想,以注重游客体验为核心,强调精致化、品质化与主题化。街区由徽派特色马头墙、仿古外立面门窗、回廊、商业街景观亭台楼阁等建筑组成,更好的展示仙女湖的人文风貌,给游客美好难忘的游玩体验。七夕老街融合新余民宿特色、民俗娱乐、民俗活动、本地特色小吃为一体,酒楼、客栈、酒吧、茶楼、戏台点缀其间,是集游客服务、观光娱乐、美食购物、度假休闲等功能为一体,以体验闲生活、慢生活、新生活的古风情的商业特色休闲街区。2021年,七夕老街荣获江西省省级旅游休闲街区。天工开物园天工开物园位于仙女湖沁庐度假酒店旁,紧邻七夕老街、七夕演艺中心,总建筑面积约1250㎡,主要是两层设计,商铺总计46间,由钢结构集装箱打造,风格时尚、鲜明、独特。天工开物园整体定位为商业休闲街区,由儿童互动娱乐区、酒吧餐饮区、文创轻食区三部分组成,目标人群以年轻人、情侣及小家庭为主。天工开物园的出现将为所有游客提供时尚休闲、互动娱乐、亲子游玩的高沉浸性、互动性新体验。七仙女渔乐园七仙女渔乐园是一个水上休闲渔趣乐园,具有赏鱼观光、人鱼互动、趣味捕鱼、垂钓、露天野营等休闲娱乐服务,并具备承接各类垂钓赛事及各类户外拓展活动的功能。园内有各式观赏鱼:色彩艳丽的锦鲤鱼、形态奇异的鸭嘴鱼、来势凶猛的黄金鱼群等。惊险刺激的人鱼互动项目有:浑水摸鱼、赤脚渡河、奶瓶喂鱼、当一日渔民等;趣味十足的水上运动有:水上激光碰碰船、特战船、皮划艇、浆板等。游客通过游玩观光,不但领略了仙女湖自然生态景观,饱览了各式各样的鱼类,更能体验水上运动的惊险刺激,让您成为仙女湖的主人,实现了一场忘我的旅行。七夕演艺中心七夕演艺中心矗立在仙女湖码头广场,依托于央视七夕晚会而打造的长期性演艺场馆。舞台以仙女下凡的爱情传说故事为设计主题,以半球形钢架结构建筑,融合地球和天堂、凡间与仙界的爱情元素,在充分展示仙女湖爱情文化的同时,也增加了景区建筑物的美感。七夕演艺中心是仙女湖一个具有重要意义的标志性的艺术性建筑,舞台结构一半拱门,一半倒影,形成一个完整的圆,代表充实,只有他们在一起,才能成为一个整体。舞台通过变幻莫测的五彩灯光、宛如天籁的缥缈音乐、返朴归真的造景和清新隽永的舞美,力图为观众打造一场梦幻般的视觉盛宴,形成一台气势恢宏的山水实景演出。仙女湖汽车影院仙女湖汽车影院坐落在仙女湖沁庐度假酒店西侧的停车场内。在这里你可以享受不被打扰的私人观影空间,坐在车内就可以获得自由的观影。仙幻爱情艺术馆仙幻爱情艺术馆位于仙女湖七夕老街鹊桥旁,场馆建设依托仙女湖“羽人传说”的特色文化,通过集成25个互动体验场景,以“仙幻美拍、情感体验、爱的启迪”为主题,与教育、艺术开发相结合,给游客娱乐打卡带来全新体验。二、游在仙女湖圣集寺圣集寺由叫佛教文化博览园,位于仙女湖钟山峡南岸的仙人台处,是由五台山佛教协会会长妙江大和尚亲自开山主持的一处佛教道场,因此延续了五台山佛教名山的历史文化脉络。圣集寺占地约2500亩,主峰高度432米,由圣集寺、文殊道场、观音道场、梅庵、禅园、佛教文化广场、禅修区、汉式佛塔、藏式白塔等组成。寺内有天.王殿,祈殿,雷音宝殿和藏经楼四个大殿。殿内分别供奉着大肚弥勒菩萨,韦驮菩萨,药师佛,日光菩萨,月光菩萨以及毗卢遮那佛等。圣集寺三面环山,一面临湖,山脉首尾相连,势若游龙,从东部望去,恍如“雄狮踏云”而来,是仙女湖的一块佛门净地。龙凤苑龙凤苑南北似腾飞的龙,东西象展翅的凤,故而得名“龙凤苑”。龙凤历来都是瑞祥美好的象征,素有“龙凤呈祥”、“龙飞凤舞”等吉祥之说。游历过龙凤苑的朋友,都会多吉多福,百顺百利。龙凤苑占地116亩,密林树茂,景色宜人,景观丰富。依山傍水建有龙凤徽、九龙墀、蛇池、凤巢、龙蟠台、崇蛇坛、天鸟行空、白蛇传雕塑、鸵鸟行宫、舞龙飞船等内涵丰富的景观。民俗文化风情园民俗文化风情园是一处荟萃多民族民间艺术、民俗风情和民居建筑于一园的文化旅游景点。民俗文化风情园设有民俗大舞台,每天都有多场精彩的舞蹈,演绎仙女下凡的传说故事。游客朋友们还可以现场与我们的仙女进行互动,感受不一样的仙女湖文化。爱情岛爱情岛占地面积79920㎡,是集旅游观光、休闲娱乐、度假、会务拓展、婚纱摄影等多种功能于一体的岛屿。岛内有中式的大花轿、同心锁、姻缘井、抛绣球、洞房;西式的仿“科隆大教堂”、爱琴海、浪漫满屋、海景码头、日式风情街、欧陆风情街、宫廷水道等建筑。爱情岛以爱情文化为内涵,以传播爱情文化为理念,聚集众多的爱情文化元素,是天下有情人“爱的天堂”,是浪漫、邂逅及拍照的好地方!龙王岛龙王岛位于仙女湖湖内的中心部位,它的平面像橄榄,又似台湾宝岛;它的立面形似等腰三角形,有着比日本富士山更标准的轮廓。而从凌水崖石上看龙王岛,酷似一只神龟,它与龙王岛遥遥相望,形成了“神龟拜龙王”的神奇景观。龙王岛上也称猴岛,岛上有上百只野生的猴子,有的顽劣乖张,有的憨态可鞠,但都善察人意。您面带笑容,它则绕膝撒欢;您面含怒色,它则远遁规避。站在龙王岛顶端的龙王阁,可俯瞰仙女湖碧波荡漾、烟波浩渺的全景,大大小小的岛屿既象一颗颗镶嵌在绒毯上的绿宝石,又似一个个睡梦中的仙女。近岛远山,层峦迭嶂,茫茫苍苍,俨似一幅天然山水画。据说国画大师傅抱石先生当年和关山月合作“江山如此多娇”这幅巨作的灵感就来自于仙女湖的龙王岛。名人岛名人岛根据中国江南园林古朴典雅风格而建造,以新余古今名人为主要展示内容。全岛总面积65亩,由大小两个岛组成,从空中鸟瞰,大岛如苍龙卧波,小岛如翠珠凌水,俨然“苍龙戏珠”的天然景观。名人岛由名人植树园、名人雕塑园、抱石文化园三个园区组成。名人植树园,位于岛内醉笔堂的正前方,很多海内外名人雅士在此植树纪念。名人雕塑园挑选新余自三国吴宝鼎二年(267年)立县以来,众多进士及第者中杰出的12位名人,将其立塑像在绿树映掩之中。抱石文化园是纪念国画大师傅抱石先生的园林。园门按抱石故里——罗坊樟塘村“傅氏祠堂”的风格建造的。园前有一棵连理共生的香樟树,象征着傅抱石先生“德艺双馨”。园内傅抱石塑像是画家、雕刻家陈祖煌先生按照傅抱石当年为人民大会堂绘制《江山如此多娇》巨型油画时的神态制作而成。桃花岛这里因凡人走桃花运在此偶遇仙女,又因岛上遍布桃树而命名,以“上桃花岛行桃花大运”,“集桃文化做山水文章”为风味。桃花岛门楼由明清时代的古砖修建而成,门楼墙上的砖刻有“喻南学社”、“红德润堂”、“平恒公馆”、“新喻县城砖”等铭文,具有较高的文物研究价值。三、食在仙女湖仙遇记·生态鱼馆鱼,在中国传统文化中是富庶、繁荣的象征。逢年过节、喜庆筵席及亲朋团聚之时,餐桌上总少不了鱼肴。鱼,传达着人们对“年年有余、富贵有余”的美好愿望。仙女湖湖内鱼类丰富,一直坚持人放天养的饲养模式,主要饵料为浮游生物、底栖生物、水生植物等天然饵料,养殖用水为仙女湖的优质水源。水域环境优良,天然养殖周期长,肥美的鲜鱼深受青睐。仙遇记·生态鱼馆位于仙女湖湖畔,鱼馆沿用“七仙女”的“七文化”,经过多年实践经验,一直是取新鲜活鱼为原料,用多种烹调手法并融合新余七个地区的特色菜肴,独创一鱼七吃,让您品尝鱼汤鲜美的同时,又可以尝到鱼肉的鲜嫩口感。其菜品口感独特,老少皆宜,让人回味无穷,深得广大游客、市民的喜爱。仙遇记·生态鱼馆以品质求发展,以诚信求生存,经过几年的不懈努力,现已成为家喻户晓的特色美食餐馆。四、宿在仙女湖仙女湖沁庐度假酒店仙女湖沁庐度假酒店坐落在仙女湖湖畔,总建筑面积约1.2万㎡,客房117间,配有自助餐厅、中餐厅、休闲书吧、健身房、棋牌室、会议报告厅、会议室等。酒店以现代徽派为形,清新典雅的中式风格为内部装饰,融入江南山水与文旅度假景区优美环境中。酒店通过智慧控制系统及高环保静音空调,为来宾营造闲适惬意的休闲新生活。仙女湖沁庐度假酒店,让您远离城市的喧嚣,享受天然的舒畅。",
        "desc_img":[
        ],
        "detail_url":"https://you.ctrip.com/sight/xinyu878/138153.html",
        "english_name":"",
        "hot":"5.8",
        "item_imgs":[
            {
                "url":"https://dimg04.c-ctrip.com/images/350t0r000000hagjkB897.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/100g1f000001gr0co465B.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/350u0r000000haeflEE6C.jpg"
            },
            {
                "url":"https://dimg04.c-ctrip.com/images/35050r000000hcxrm8C3B.jpg"
            }
        ],
        "level":"4A",
        "open_time":"3/1-10/31 08:00-17:30开放;11/1-2/28 08:30-17:00开放,游船开船时间:09:20,10:10,11:00,12:00,13:00,13:40",
        "poiid":99330,
        "ranking":"新余自然风光景点榜 No.1",
        "reviews_num":950,
        "score":4.2,
        "service ":[
            {
                "name":"停车场",
                "value":"【仙女湖停车场】参考价格:¥10/次;地址:新余市渝水区西南郊16公里处仙女湖景区门楼进入右拐;库位:620;无大小车之分"
            },
            {
                "name":"园内交通",
                "value":"参考价格:收费;地址:游船码头"
            },
            {
                "name":"卫生间",
                "value":"景区内设有卫生间,在西北门北侧附近,并标有醒目的指示牌。"
            },
            {
                "name":"餐饮",
                "value":"园内设有餐厅,在东南门北侧等附近。"
            }
        ],
        "telephone":"4009158099",
        "tips":[
        ],
        "title":"仙女湖",
        "upgrade":[
            {
                "name":"新余市民",
                "value":"新余本地市民,注:五一、十一、春节期间四县居民不享受免门票优惠政策,免门票"
            }
        ]
    },
    "_ddf":"curry",
    "error":"",
    "reason":"",
    "error_code":"0000",
    "cache":0,
    "api_info":"today: max:15000 all[=++];expires:2031-01-01",
    "execution_time":"3.878",
    "server_time":"Beijing/2024-01-21 18:11:06",
    "client_ip":"127.0.0.1",
    "call_args":[
    ],
    "api_type":"xiecheng",
    "server_memory":"2.99MB",
    "last_id":false
}

异常示例

{
  "error": "item-not-found",
  "reason": "没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2023-12-15 17:44:00",
  "call_args": [],
  "api_type": "xiecheng",
  "request_id": "1ee0ffc041242"}
相关文章
|
7天前
|
JSON API 数据格式
通过API获取淘宝商品详情
在电子商务蓬勃发展的今天,对于商家与开发者来说,掌握商品的详细信息是至关重要的。API作为一个连接淘宝平台的接口,提供了一种便捷且高效的数据获取手段。本文旨在阐述如何利用API来检索淘宝商品的详尽资料,并探讨其在电商领域的应用前景。
|
17天前
|
XML JSON API
快速淘宝商品详情页面API接口传输 php
PI(Application Programming Interface,应用程序接口)是一组预定义的函数、协议和工具,用于构建软件应用程序之间的交互。它允许不同的软件系统和应用通过统一的接口进行数据交换和通信
|
20天前
|
XML JSON API
1688商品详情API接口获取商品信息
在电商领域,商品详情页面是用户了解商品详细信息的重要途径。为了方便开发者快速获取商品信息,阿里巴巴旗下的1688平台提供了商品详情API接口。本文将介绍如何使用1688商品详情API接口获取商品信息,并通过代码示例进行详细说明。
|
23天前
|
XML 测试技术 API
如何获得阿里巴巴中国站上传图片到1688 API 返回值说明
请注意,阿里巴巴开放平台的API和文档可能会随着时间和版本更新而发生变化,因此建议定期查看官方文档以获取最新的信息。此外,由于涉及到具体的业务逻辑和数据交互,实际操作时可能需要根据具体情况进行调试和适应。
|
24天前
|
API
当当网按关键字搜索dangdang商品 API 返回值说明
当当网按关键字搜索商品的API返回值通常包含了搜索到的商品列表及其相关信息。具体的返回值结构可能因API版本和请求参数的不同而有所差异。以下是一个典型的当当网按关键字搜索商品API返回值的示例和说明:
|
28天前
|
API
如何获得阿里巴巴中国站店铺的所有商品 API 返回值说明
阿里巴巴中国站的API返回值可能会随着API的更新和迭代而有所变化。对于获得店铺的所有商品这一功能,API的返回值通常会包含店铺内所有商品的详细信息,如商品ID、商品标题、价格、图片链接、描述、销售数量、库存量等。
|
28天前
|
API
怎样获取当当网dangdang商品详情 API 返回值说明?
当当网(dangdang.com)的API(Application Programming Interface)返回值详细说明可能会随着API的更新和迭代而有所变化。通常,一个商品详情API的返回值会包含有关商品的详细信息,如商品ID、名称、价格、描述、图片链接、评价、分类等。
|
24天前
|
SQL API Python
Python DB API下规范下cursor对象常用接口
Python DB API下规范下cursor对象常用接口。
17 4
|
7天前
|
存储 缓存 运维
DataWorks操作报错合集之DataWorks根据api,调用查询文件列表接口报错如何解决
DataWorks是阿里云提供的一站式大数据开发与治理平台,支持数据集成、数据开发、数据服务、数据质量管理、数据安全管理等全流程数据处理。在使用DataWorks过程中,可能会遇到各种操作报错。以下是一些常见的报错情况及其可能的原因和解决方法。
19 1
|
8天前
|
SQL 数据管理 API
数据管理DMS产品使用合集之阿里云DMS提供API接口来进行数据导出功能吗
阿里云数据管理DMS提供了全面的数据管理、数据库运维、数据安全、数据迁移与同步等功能,助力企业高效、安全地进行数据库管理和运维工作。以下是DMS产品使用合集的详细介绍。