携程获取景点详情 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"}
相关文章
|
6天前
|
监控 搜索推荐 安全
探究亚马逊详情API接口:开发与应用
在数字化时代,亚马逊作为全球领先的电商平台,为商家和消费者提供了丰富的商品信息和便捷的购物体验。本文深入探讨了亚马逊详情API接口的获取与运用,帮助开发者和商家实时监控商品数据、分析市场趋势、优化价格策略、分析竞争对手、构建推荐系统及自动化营销工具,从而在竞争中占据优势。文章还提供了Python调用示例和注意事项,确保API使用的安全与高效。
27 3
|
6天前
|
JSON API 开发者
解密小红书详情API接口:获取与运用
小红书作为热门社交媒体平台,吸引了大量用户和创作者。企业或开发者可以通过调用小红书API接口,高效、合法地获取内容数据,提升业务效率。本文详细介绍如何获取和使用小红书笔记详情API接口,涵盖注册账号、创建应用、获取API密钥、查阅文档、构建请求、解析响应等步骤,以及应用场景和注意事项。
28 2
|
21天前
|
缓存 监控 API
抖音抖店 API 请求获取宝贝详情数据的调用频率限制如何调整?
抖音抖店API请求获取宝贝详情数据的调用频率受限,需遵循平台规则。开发者可通过提升账号等级、申请更高配额、优化业务逻辑(如缓存数据、异步处理、批量请求)及监控调整等方式来应对。
|
3天前
|
JSON API 数据格式
携程API接口系列,酒店景点详情请求示例参考
携程API接口系列涵盖了酒店预订、机票预订、旅游度假产品预订、景点门票预订等多个领域,其中酒店和景点详情请求是较为常用的功能。以下提供酒店和景点详情请求的示例参考
|
17天前
|
存储 人工智能 大数据
拼多多详情API的价值与应用解析
拼多多作为中国电商市场的重要参与者,其开放平台提供的商品详情API接口为电商行业带来了新的机遇和挑战。该接口允许开发者通过编程方式获取商品的详细信息,包括标题、价格、描述、图片、规格参数和库存等,推动了电商运营的智能化和高效化。本文将深入解析拼多多详情API的价值与应用,帮助商家和开发者更好地理解和利用这一宝贵资源。
28 0
|
4天前
|
JSON API 数据格式
淘宝 / 天猫官方商品 / 订单订单 API 接口丨商品上传接口对接步骤
要对接淘宝/天猫官方商品或订单API,需先注册淘宝开放平台账号,创建应用获取App Key和App Secret。之后,详细阅读API文档,了解接口功能及权限要求,编写认证、构建请求、发送请求和处理响应的代码。最后,在沙箱环境中测试与调试,确保API调用的正确性和稳定性。
|
16天前
|
供应链 数据挖掘 API
电商API接口介绍——sku接口概述
商品SKU(Stock Keeping Unit)接口是电商API接口中的一种,专门用于获取商品的SKU信息。SKU是库存量单位,用于区分同一商品的不同规格、颜色、尺寸等属性。通过商品SKU接口,开发者可以获取商品的SKU列表、SKU属性、库存数量等详细信息。
|
17天前
|
JSON API 数据格式
店铺所有商品列表接口json数据格式示例(API接口)
当然,以下是一个示例的JSON数据格式,用于表示一个店铺所有商品列表的API接口响应
|
27天前
|
编解码 监控 API
直播源怎么调用api接口
调用直播源的API接口涉及开通服务、添加域名、获取API密钥、调用API接口、生成推流和拉流地址、配置直播源、开始直播、监控管理及停止直播等步骤。不同云服务平台的具体操作略有差异,但整体流程简单易懂。
|
7天前
|
JSON API 数据安全/隐私保护
拍立淘按图搜索API接口返回数据的JSON格式示例
拍立淘按图搜索API接口允许用户通过上传图片来搜索相似的商品,该接口返回的通常是一个JSON格式的响应,其中包含了与上传图片相似的商品信息。以下是一个基于淘宝平台的拍立淘按图搜索API接口返回数据的JSON格式示例,同时提供对其关键字段的解释